{"id":193970,"date":"2023-07-25T12:32:52","date_gmt":"2023-07-25T16:32:52","guid":{"rendered":"https:\/\/ibkrcampus.com\/?post_type=trading-lessons&p=193970"},"modified":"2023-07-25T12:32:53","modified_gmt":"2023-07-25T16:32:53","slug":"account-management","status":"publish","type":"trading-lessons","link":"https:\/\/www.interactivebrokers.com\/campus\/trading-lessons\/account-management\/","title":{"rendered":"Account Management"},"content":{"rendered":"\n

Hello, and welcome to this lesson on Account Management in the Interactive Brokers Client Portal API. In this lesson, we will be discussing how to review account summary details as well as request position information using the Client Portal API.<\/p>\n\n\n\n

Account Summary Values<\/strong><\/a><\/p>\n\n\n\n

To begin, we can start by taking a closer look at the portfolio\/{accountId}\/summary endpoint. This endpoint provides a summary of a specified account and quick reference details therein.  Now, we can jump right into our standard framework for a new python file, AcctSummary.py. I can start this file by naming my method, acctSum().<\/p>\n\n\n\n

Inside my method, I can use my standard structure, but this time I will set my \u2018endpoint\u2019 variable to \u2018portfolio\/{accountId}\/summary\u2019. Given we have already provided our accountId, there are no further parameters or detail to request. So let\u2019s go ahead and build our request. Given that we are just retrieving account information today, we will only be using GET requests. I can set my url to the base_url and endpoint variables. With my request variable set, I can print this along with my json value to see the full range of data.<\/p>\n\n\n\n

If we run this code, we will see all of the details returned. As you can imagine, the summary endpoint does not go into too much detail, though it can provide a quick reference to details such as your account\u2019s \u2018availablefunds\u2019. We can also find details about maintenance and initial margin requirements, and a host of other values. We would strongly recommend reviewing the full list of details available.<\/p>\n\n\n\n

In many instances, we will see three returns of what seems to be the same value. Let\u2019s use \u2018availablefunds as an example. We can see \u201cavailablefunds\u201d, \u201cavailablefunds-c\u201d, and \u201cavailablefunds-s\u201d all returned in a row. These values are all used to designate specific details. All fields ending in \u201c-c\u201d will notate the value specific to \u201ccommodities\u201d. Meanwhile, \u201c-s\u201d will provide information on securities. And then the base value, like \u2018availablefunds\u2019, will be a reference for the whole account.<\/p>\n\n\n\n

Requesting Positions<\/strong><\/p>\n\n\n\n

While it can be nice to receive account information at a glance, we often would like to retrieve more exact details. To kick things off, let\u2019s go ahead and create a new file so we can review positions information. In addition to our normal framework, I will establish my \u2018endpoint\u2019 variable once again. I will set this to \u201cportfolio\/{accountId}\/positions\/0\u201d.<\/p>\n\n\n\n

You might initially find this endpoint odd given the trailing \u2018\/0\u2019 value. The reason we have this extra index is because our positions endpoint is paginated. That means that you may request or receive multiple pages of data. A typical page will include 30 securities per page. If you trade a myriad of contracts, you may need to request this endpoint with a 0, 1, or even 2 to receive all your positions\u2019 values. However, for most typical trades, you will often just use the first page, 0. <\/p>\n\n\n\n

Now, we can set up our GET requests and json.dumps values, and run our code. In doing so, we will retrieve a list of arrays. Each array will indicate a specific contract. These will include the accountId, contract ID, contract description or symbol, along with all of the values we might want to see alongside it.<\/p>\n\n\n\n

Something that may help to point out is that we can see a \u201cmktPrice\u201d, \u201cmktValue\u201d, \u201cavgCost\u201d and \u201cavgPrice\u201d fields returned. These are all understandably similar, so let\u2019s discuss what each value means. \u201cmktPrice\u201d indicates the current value of an individual contract on a per-share basis. Meanwhile, \u201cmktValue\u201d will return \u201cmktPrice\u201d multiplied by the total \u201cposition\u201d value. This can be helpful to understand what closing your position might look like.<\/p>\n\n\n\n

\u201cavgPrice\u201d will represent the average cost of each share when you bought it. While it may not mean much if you bought a single share, if you bought a share on Monday at $50, a share on Tuesday at $100, and then a share on Wednesday at $150, our \u201cavgPrice\u201d will return \u201c100\u201d given that is the average of every time you entered the position. The \u201cavgCost\u201d field  will often show the same value, but in the case of derivatives, this will show the average cost multiplied by the position then the multiplier. My ES contract can represent this by showing average price, multiplied by my position, multiplied by the multiplier of 50.<\/p>\n\n\n\n

In addition, if this endpoint is queried in a polling mode, every few moments, then we will eventually see this endpoint return the full info & rules for all of your contracts.  This can be helpful in saving the separate contract requests elsewhere and can be a powerful tool to show all contract and position information.<\/p>\n\n\n\n

Individual Positions<\/strong><\/p>\n\n\n\n

While it is great to see a whole list, as we mentioned it can take some time to generate all of our contract details. So, to better manage those requests, I may instead want to request an individual position\u2019s information. As long as I know my contract, like AAPL\u2019s 265598, I can make a request or two to my endpoint and I will have the full contract information right away.<\/p>\n\n\n\n

All we need to do is make a new file and set a GET request to the endpoint, \u2018portfolio\/{accountId}\/position\/{conid}\u2019. After populating my accountId and contract Id, I can run my code and see all of my information come back for the entire AAPL contract.<\/p>\n\n\n\n

Thank you for watching this lesson on account management in the Client Portal API. If you find this lesson helpful, please check out our other lessons in the Client Portal API tutorial series.<\/p>\n\n\n\n

Code Snippet – acctPositions.py<\/h4>\n\n\n\n
import requests\nimport json\nimport urllib3\n\n# Ignore insecure error messages\nurllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)\n\ndef acctPos():\n  \n    base_url = \"https:\/\/localhost:5000\/v1\/api\/\"\n    endpoint = \"portfolio\/DU5240685\/positions\/0\"\n    \n    pos_req = requests.get(url=base_url+endpoint, verify=False)\n    pos_json = json.dumps(pos_req.json(), indent=2)\n\n    print(pos_req.status_code)\n    print(pos_json)\n\nif __name__ == \"__main__\":\n    acctPos()<\/pre>\n\n\n\n
Code Snippet – acctPositionsSingle.py<\/h4>\n\n\n\n
import requests\nimport json\nimport urllib3\n\n# Ignore insecure error messages\nurllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)\n\ndef acctPosSingle():\n  \n    base_url = \"https:\/\/localhost:5000\/v1\/api\/\"\n    endpoint = \"portfolio\/DU5240685\/position\/265598\"\n    \n    pos_req = requests.get(url=base_url+endpoint, verify=False)\n    pos_json = json.dumps(pos_req.json(), indent=2)\n\n    print(pos_req.status_code)\n    print(pos_json)\n\nif __name__ == \"__main__\":\n    acctPosSingle()<\/pre>\n\n\n\n
Code Snippet – acctSummary.py<\/h4>\n\n\n\n
import requests\nimport json\nimport urllib3\n\n# Ignore insecure error messages\nurllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)\n\ndef acctSum():\n  \n    base_url = \"https:\/\/localhost:5000\/v1\/api\/\"\n    endpoint = \"portfolio\/DU5240685\/summary\"\n    \n    sum_req = requests.get(url=base_url+endpoint, verify=False)\n    sum_json = json.dumps(sum_req.json(), indent=2)\n\n    print(sum_req.status_code)\n    print(sum_json)\n\nif __name__ == \"__main__\":\n    acctSum()<\/pre>\n","protected":false},"excerpt":{"rendered":"
In this lesson, we will be discussing various account management tools in the Client Portal API. We will be primarily focusing on the use of account summary, along with viewing an accounts total position, as well as how to review an individual contract\u2019s position information.<\/p>\n","protected":false},"author":850,"featured_media":193972,"parent":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"contributors-categories":[13576],"traders-academy":[13126,13128,13132],"class_list":{"0":"post-193970","1":"trading-lessons","2":"type-trading-lessons","3":"status-publish","4":"has-post-thumbnail","6":"contributors-categories-interactive-brokers","7":"traders-academy-intermediate-trading","8":"traders-academy-level","9":"traders-academy-trading-lesson"},"pp_statuses_selecting_workflow":false,"pp_workflow_action":"current","pp_status_selection":"publish","acf":[],"yoast_head":"\nArchives | Traders' Academy | IBKR Campus<\/title>\n<meta name=\"description\" content=\"In this lesson, we will be discussing various account management tools in the Client Portal API. We will be primarily focusing on the use of account...\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.interactivebrokers.com\/campus\/wp-json\/wp\/v2\/trading-lessons\/193970\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Account Management | IBKR Campus US\" \/>\n<meta property=\"og:description\" content=\"In this lesson, we will be discussing various account management tools in the Client Portal API. We will be primarily focusing on the use of account summary, along with viewing an accounts total position, as well as how to review an individual contract\u2019s position information.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.interactivebrokers.com\/campus\/trading-lessons\/account-management\/\" \/>\n<meta property=\"og:site_name\" content=\"IBKR Campus US\" \/>\n<meta property=\"article:modified_time\" content=\"2023-07-25T16:32:53+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.interactivebrokers.com\/campus\/wp-content\/uploads\/sites\/2\/2023\/07\/cp-api7-2.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1920\" \/>\n\t<meta property=\"og:image:height\" content=\"1080\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\n\t    \"@context\": \"https:\\\/\\\/schema.org\",\n\t    \"@graph\": [\n\t        {\n\t            \"@type\": \"WebPage\",\n\t            \"@id\": \"https:\\\/\\\/ibkrcampus.com\\\/campus\\\/trading-lessons\\\/account-management\\\/\",\n\t            \"url\": \"https:\\\/\\\/ibkrcampus.com\\\/campus\\\/trading-lessons\\\/account-management\\\/\",\n\t            \"name\": \"Account Management | IBKR Campus US\",\n\t            \"isPartOf\": {\n\t                \"@id\": \"https:\\\/\\\/ibkrcampus.com\\\/campus\\\/#website\"\n\t            },\n\t            \"primaryImageOfPage\": {\n\t                \"@id\": \"https:\\\/\\\/ibkrcampus.com\\\/campus\\\/trading-lessons\\\/account-management\\\/#primaryimage\"\n\t            },\n\t            \"image\": {\n\t                \"@id\": \"https:\\\/\\\/ibkrcampus.com\\\/campus\\\/trading-lessons\\\/account-management\\\/#primaryimage\"\n\t            },\n\t            \"thumbnailUrl\": \"https:\\\/\\\/www.interactivebrokers.com\\\/campus\\\/wp-content\\\/uploads\\\/sites\\\/2\\\/2023\\\/07\\\/cp-api7-2.jpg\",\n\t            \"datePublished\": \"2023-07-25T16:32:52+00:00\",\n\t            \"dateModified\": \"2023-07-25T16:32:53+00:00\",\n\t            \"description\": \"In this lesson, we will be discussing various account management tools in the Client Portal API. We will be primarily focusing on the use of account summary, along with viewing an accounts total position, as well as how to review an individual contract\u2019s position information.\",\n\t            \"breadcrumb\": {\n\t                \"@id\": \"https:\\\/\\\/ibkrcampus.com\\\/campus\\\/trading-lessons\\\/account-management\\\/#breadcrumb\"\n\t            },\n\t            \"inLanguage\": \"en-US\",\n\t            \"potentialAction\": [\n\t                {\n\t                    \"@type\": \"ReadAction\",\n\t                    \"target\": [\n\t                        \"https:\\\/\\\/ibkrcampus.com\\\/campus\\\/trading-lessons\\\/account-management\\\/\"\n\t                    ]\n\t                }\n\t            ]\n\t        },\n\t        {\n\t            \"@type\": \"ImageObject\",\n\t            \"inLanguage\": \"en-US\",\n\t            \"@id\": \"https:\\\/\\\/ibkrcampus.com\\\/campus\\\/trading-lessons\\\/account-management\\\/#primaryimage\",\n\t            \"url\": \"https:\\\/\\\/www.interactivebrokers.com\\\/campus\\\/wp-content\\\/uploads\\\/sites\\\/2\\\/2023\\\/07\\\/cp-api7-2.jpg\",\n\t            \"contentUrl\": \"https:\\\/\\\/www.interactivebrokers.com\\\/campus\\\/wp-content\\\/uploads\\\/sites\\\/2\\\/2023\\\/07\\\/cp-api7-2.jpg\",\n\t            \"width\": 1920,\n\t            \"height\": 1080\n\t        },\n\t        {\n\t            \"@type\": \"BreadcrumbList\",\n\t            \"@id\": \"https:\\\/\\\/ibkrcampus.com\\\/campus\\\/trading-lessons\\\/account-management\\\/#breadcrumb\",\n\t            \"itemListElement\": [\n\t                {\n\t                    \"@type\": \"ListItem\",\n\t                    \"position\": 1,\n\t                    \"name\": \"Academy Lessons\",\n\t                    \"item\": \"https:\\\/\\\/ibkrcampus.com\\\/campus\\\/trading-lessons\\\/\"\n\t                },\n\t                {\n\t                    \"@type\": \"ListItem\",\n\t                    \"position\": 2,\n\t                    \"name\": \"Account Management\"\n\t                }\n\t            ]\n\t        },\n\t        {\n\t            \"@type\": \"WebSite\",\n\t            \"@id\": \"https:\\\/\\\/ibkrcampus.com\\\/campus\\\/#website\",\n\t            \"url\": \"https:\\\/\\\/ibkrcampus.com\\\/campus\\\/\",\n\t            \"name\": \"IBKR Campus US\",\n\t            \"description\": \"Financial Education from Interactive Brokers\",\n\t            \"publisher\": {\n\t                \"@id\": \"https:\\\/\\\/ibkrcampus.com\\\/campus\\\/#organization\"\n\t            },\n\t            \"potentialAction\": [\n\t                {\n\t                    \"@type\": \"SearchAction\",\n\t                    \"target\": {\n\t                        \"@type\": \"EntryPoint\",\n\t                        \"urlTemplate\": \"https:\\\/\\\/ibkrcampus.com\\\/campus\\\/?s={search_term_string}\"\n\t                    },\n\t                    \"query-input\": {\n\t                        \"@type\": \"PropertyValueSpecification\",\n\t                        \"valueRequired\": true,\n\t                        \"valueName\": \"search_term_string\"\n\t                    }\n\t                }\n\t            ],\n\t            \"inLanguage\": \"en-US\"\n\t        },\n\t        {\n\t            \"@type\": \"Organization\",\n\t            \"@id\": \"https:\\\/\\\/ibkrcampus.com\\\/campus\\\/#organization\",\n\t            \"name\": \"Interactive Brokers\",\n\t            \"alternateName\": \"IBKR\",\n\t            \"url\": \"https:\\\/\\\/ibkrcampus.com\\\/campus\\\/\",\n\t            \"logo\": {\n\t                \"@type\": \"ImageObject\",\n\t                \"inLanguage\": \"en-US\",\n\t                \"@id\": \"https:\\\/\\\/ibkrcampus.com\\\/campus\\\/#\\\/schema\\\/logo\\\/image\\\/\",\n\t                \"url\": \"https:\\\/\\\/www.interactivebrokers.com\\\/campus\\\/wp-content\\\/uploads\\\/sites\\\/2\\\/2024\\\/05\\\/ibkr-campus-logo.jpg\",\n\t                \"contentUrl\": \"https:\\\/\\\/www.interactivebrokers.com\\\/campus\\\/wp-content\\\/uploads\\\/sites\\\/2\\\/2024\\\/05\\\/ibkr-campus-logo.jpg\",\n\t                \"width\": 669,\n\t                \"height\": 669,\n\t                \"caption\": \"Interactive Brokers\"\n\t            },\n\t            \"image\": {\n\t                \"@id\": \"https:\\\/\\\/ibkrcampus.com\\\/campus\\\/#\\\/schema\\\/logo\\\/image\\\/\"\n\t            },\n\t            \"publishingPrinciples\": \"https:\\\/\\\/www.interactivebrokers.com\\\/campus\\\/about-ibkr-campus\\\/\",\n\t            \"ethicsPolicy\": \"https:\\\/\\\/www.interactivebrokers.com\\\/campus\\\/cyber-security-notice\\\/\"\n\t        }\n\t    ]\n\t}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Archives | Traders' Academy | IBKR Campus","description":"In this lesson, we will be discussing various account management tools in the Client Portal API. We will be primarily focusing on the use of account...","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.interactivebrokers.com\/campus\/wp-json\/wp\/v2\/trading-lessons\/193970\/","og_locale":"en_US","og_type":"article","og_title":"Account Management | IBKR Campus US","og_description":"In this lesson, we will be discussing various account management tools in the Client Portal API. We will be primarily focusing on the use of account summary, along with viewing an accounts total position, as well as how to review an individual contract\u2019s position information.","og_url":"https:\/\/www.interactivebrokers.com\/campus\/trading-lessons\/account-management\/","og_site_name":"IBKR Campus US","article_modified_time":"2023-07-25T16:32:53+00:00","og_image":[{"width":1920,"height":1080,"url":"https:\/\/www.interactivebrokers.com\/campus\/wp-content\/uploads\/sites\/2\/2023\/07\/cp-api7-2.jpg","type":"image\/jpeg"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/ibkrcampus.com\/campus\/trading-lessons\/account-management\/","url":"https:\/\/ibkrcampus.com\/campus\/trading-lessons\/account-management\/","name":"Account Management | IBKR Campus US","isPartOf":{"@id":"https:\/\/ibkrcampus.com\/campus\/#website"},"primaryImageOfPage":{"@id":"https:\/\/ibkrcampus.com\/campus\/trading-lessons\/account-management\/#primaryimage"},"image":{"@id":"https:\/\/ibkrcampus.com\/campus\/trading-lessons\/account-management\/#primaryimage"},"thumbnailUrl":"https:\/\/www.interactivebrokers.com\/campus\/wp-content\/uploads\/sites\/2\/2023\/07\/cp-api7-2.jpg","datePublished":"2023-07-25T16:32:52+00:00","dateModified":"2023-07-25T16:32:53+00:00","description":"In this lesson, we will be discussing various account management tools in the Client Portal API. We will be primarily focusing on the use of account summary, along with viewing an accounts total position, as well as how to review an individual contract\u2019s position information.","breadcrumb":{"@id":"https:\/\/ibkrcampus.com\/campus\/trading-lessons\/account-management\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/ibkrcampus.com\/campus\/trading-lessons\/account-management\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/ibkrcampus.com\/campus\/trading-lessons\/account-management\/#primaryimage","url":"https:\/\/www.interactivebrokers.com\/campus\/wp-content\/uploads\/sites\/2\/2023\/07\/cp-api7-2.jpg","contentUrl":"https:\/\/www.interactivebrokers.com\/campus\/wp-content\/uploads\/sites\/2\/2023\/07\/cp-api7-2.jpg","width":1920,"height":1080},{"@type":"BreadcrumbList","@id":"https:\/\/ibkrcampus.com\/campus\/trading-lessons\/account-management\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Academy Lessons","item":"https:\/\/ibkrcampus.com\/campus\/trading-lessons\/"},{"@type":"ListItem","position":2,"name":"Account Management"}]},{"@type":"WebSite","@id":"https:\/\/ibkrcampus.com\/campus\/#website","url":"https:\/\/ibkrcampus.com\/campus\/","name":"IBKR Campus US","description":"Financial Education from Interactive Brokers","publisher":{"@id":"https:\/\/ibkrcampus.com\/campus\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/ibkrcampus.com\/campus\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/ibkrcampus.com\/campus\/#organization","name":"Interactive Brokers","alternateName":"IBKR","url":"https:\/\/ibkrcampus.com\/campus\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/ibkrcampus.com\/campus\/#\/schema\/logo\/image\/","url":"https:\/\/www.interactivebrokers.com\/campus\/wp-content\/uploads\/sites\/2\/2024\/05\/ibkr-campus-logo.jpg","contentUrl":"https:\/\/www.interactivebrokers.com\/campus\/wp-content\/uploads\/sites\/2\/2024\/05\/ibkr-campus-logo.jpg","width":669,"height":669,"caption":"Interactive Brokers"},"image":{"@id":"https:\/\/ibkrcampus.com\/campus\/#\/schema\/logo\/image\/"},"publishingPrinciples":"https:\/\/www.interactivebrokers.com\/campus\/about-ibkr-campus\/","ethicsPolicy":"https:\/\/www.interactivebrokers.com\/campus\/cyber-security-notice\/"}]}},"_links":{"self":[{"href":"https:\/\/ibkrcampus.com\/campus\/wp-json\/wp\/v2\/trading-lessons\/193970","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ibkrcampus.com\/campus\/wp-json\/wp\/v2\/trading-lessons"}],"about":[{"href":"https:\/\/ibkrcampus.com\/campus\/wp-json\/wp\/v2\/types\/trading-lessons"}],"author":[{"embeddable":true,"href":"https:\/\/ibkrcampus.com\/campus\/wp-json\/wp\/v2\/users\/850"}],"replies":[{"embeddable":true,"href":"https:\/\/ibkrcampus.com\/campus\/wp-json\/wp\/v2\/comments?post=193970"}],"version-history":[{"count":0,"href":"https:\/\/ibkrcampus.com\/campus\/wp-json\/wp\/v2\/trading-lessons\/193970\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ibkrcampus.com\/campus\/wp-json\/wp\/v2\/media\/193972"}],"wp:attachment":[{"href":"https:\/\/ibkrcampus.com\/campus\/wp-json\/wp\/v2\/media?parent=193970"}],"wp:term":[{"taxonomy":"contributors-categories","embeddable":true,"href":"https:\/\/ibkrcampus.com\/campus\/wp-json\/wp\/v2\/contributors-categories?post=193970"},{"taxonomy":"traders-academy","embeddable":true,"href":"https:\/\/ibkrcampus.com\/campus\/wp-json\/wp\/v2\/traders-academy?post=193970"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}