[{"data":1,"prerenderedAt":351},["ShallowReactive",2],{"\u002Fdocs\u002Fapi\u002Fauthentication":3,"docs-api-navigation":259,"\u002Fdocs\u002Fapi\u002Fauthentication-surround":346},{"id":4,"title":5,"body":6,"description":250,"extension":251,"meta":252,"navigation":253,"path":255,"seo":256,"stem":257,"__hash__":258},"docs\u002F1.docs\u002F2.api\u002F2.authentication.md","Authentication",{"type":7,"value":8,"toc":238},"minimark",[9,18,61,66,108,126,130,133,140,144,147,164,179,183,200,210,214,234],[10,11,12,13,17],"p",{},"Every request needs a ",[14,15,16],"strong",{},"Developer API Key",", sent as a Bearer token.",[19,20,25],"pre",{"className":21,"code":22,"language":23,"meta":24,"style":24},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl https:\u002F\u002Fshowmytrades.com\u002Fapi\u002Fv1\u002Faccounts \\\n  -H \"Authorization: Bearer smt_live_YOUR_KEY\"\n","bash","",[26,27,28,45],"code",{"__ignoreMap":24},[29,30,33,37,41],"span",{"class":31,"line":32},"line",1,[29,34,36],{"class":35},"sBMFI","curl",[29,38,40],{"class":39},"sfazB"," https:\u002F\u002Fshowmytrades.com\u002Fapi\u002Fv1\u002Faccounts",[29,42,44],{"class":43},"sTEyZ"," \\\n",[29,46,48,51,55,58],{"class":31,"line":47},2,[29,49,50],{"class":39},"  -H",[29,52,54],{"class":53},"sMK4o"," \"",[29,56,57],{"class":39},"Authorization: Bearer smt_live_YOUR_KEY",[29,59,60],{"class":53},"\"\n",[62,63,65],"h2",{"id":64},"creating-a-key","Creating a key",[67,68,70,75,82,86,97,101],"steps",{"level":69},"3",[71,72,74],"h3",{"id":73},"open-your-dashboard","Open your dashboard",[10,76,77,78,81],{},"Go to ",[14,79,80],{},"Settings → Developer API Keys",".",[71,83,85],{"id":84},"create-the-key","Create the key",[10,87,88,89,92,93,96],{},"Give it a name that says where it will run — ",[26,90,91],{},"Claude Desktop",", ",[26,94,95],{},"Monday report script",".\nWhen a key needs revoking, the name is all you have to go on.",[71,98,100],{"id":99},"copy-it-immediately","Copy it immediately",[10,102,103,104,107],{},"The key is shown ",[14,105,106],{},"once",". We store only a hash of it, so we cannot show it to you again or\nrecover it for you — not even by asking support.",[109,110,111],"caution",{},[10,112,113,116,117,121,122,125],{},[14,114,115],{},"Do not confuse it with your Connection Key."," The Connection Key is what your Expert\nAdvisor uses to ",[118,119,120],"em",{},"send"," data to ShowMyTrades. The Developer API Key is what you use to\n",[118,123,124],{},"read"," data back out. They live on different pages and are not interchangeable.",[62,127,129],{"id":128},"losing-a-key","Losing a key",[10,131,132],{},"There is no recovery. Revoke the lost key and create a new one — revoking takes effect\nimmediately, and anything still using that key stops working at once.",[10,134,135,136,139],{},"You can hold up to ",[14,137,138],{},"10 active keys",". Revoked keys do not count towards the limit, so\nrotating a key never locks you out.",[62,141,143],{"id":142},"scopes","Scopes",[10,145,146],{},"Each key carries the permissions it was created with.",[148,149,150,158],"field-group",{},[151,152,155],"field",{"name":153,"type":154},"accounts:read","scope",[10,156,157],{},"Read the accounts and portfolios you own, including the ones you have not published.",[151,159,161],{"name":160,"type":154},"public:read",[10,162,163],{},"Read and search accounts that other people have published. Never touches private accounts,\nand never returns personal details about their owners.",[10,165,166,167,174,175,178],{},"Keys are created with both. A request that needs a scope the key does not have gets a\n",[168,169,171],"a",{"href":170},"\u002Fdocs\u002Fapi\u002Ferrors",[26,172,173],{},"403",", not a ",[26,176,177],{},"401"," — the key is valid, the permission is not.",[62,180,182],{"id":181},"the-api-is-part-of-pro","The API is part of Pro",[10,184,185,186,189,190,195,196,199],{},"Creating a key and calling the API both require an active ",[14,187,188],{},"Pro"," plan. A valid key on a plan\nthat has lapsed gets a ",[168,191,192],{"href":170},[26,193,194],{},"402"," — the key is ",[14,197,198],{},"not"," revoked and does not need\nto be recreated: it starts working again on its own as soon as the plan is active.",[201,202,203],"note",{},[10,204,205,206,209],{},"This is a different thing from the ",[14,207,208],{},"Connection Key"," used by the Expert Advisor to send us your\ntrades. That one is free, has nothing to do with this page, and is not affected by your plan.",[62,211,213],{"id":212},"keeping-a-key-safe","Keeping a key safe",[148,215,216,222,228],{},[151,217,219],{"name":218},"Treat it like a password",[10,220,221],{},"Anyone holding your key can read everything you can, including your private accounts.",[151,223,225],{"name":224},"Keep it server-side",[10,226,227],{},"Never put a key in a web page, a mobile app or a public repository. Browsers cannot call\nthis API cross-origin anyway, which is deliberate.",[151,229,231],{"name":230},"One key per integration",[10,232,233],{},"Separate keys mean you can revoke the one that leaked without breaking everything else.",[235,236,237],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":24,"searchDepth":47,"depth":47,"links":239},[240,246,247,248,249],{"id":64,"depth":47,"text":65,"children":241},[242,244,245],{"id":73,"depth":243,"text":74},3,{"id":84,"depth":243,"text":85},{"id":99,"depth":243,"text":100},{"id":128,"depth":47,"text":129},{"id":142,"depth":47,"text":143},{"id":181,"depth":47,"text":182},{"id":212,"depth":47,"text":213},"Create a Developer API Key and send it as a Bearer token on every request.","md",{},{"icon":254},"i-lucide-key","\u002Fdocs\u002Fapi\u002Fauthentication",{"title":5,"description":250},"1.docs\u002F2.api\u002F2.authentication","cVmvZYmuCH_Vt8l0UTHlHyuNJYS_AnmkBJDfDeyBCA0",[260],{"title":261,"path":262,"stem":263,"children":264,"page":283},"Docs","\u002Fdocs","1.docs",[265,284,322],{"title":266,"path":267,"stem":268,"children":269,"icon":283},"Getting Started","\u002Fdocs\u002Fgetting-started","1.docs\u002F1.getting-started\u002F1.index",[270,273,278],{"title":271,"path":267,"stem":268,"icon":272},"Introduction","i-lucide-house",{"title":274,"path":275,"stem":276,"icon":277},"Installation","\u002Fdocs\u002Fgetting-started\u002Finstallation","1.docs\u002F1.getting-started\u002F2.installation","i-lucide-download",{"title":279,"path":280,"stem":281,"icon":282},"Usage","\u002Fdocs\u002Fgetting-started\u002Fusage","1.docs\u002F1.getting-started\u002F3.usage","i-lucide-sliders",false,{"title":285,"path":286,"stem":287,"children":288,"icon":321},"API Reference","\u002Fdocs\u002Fapi","1.docs\u002F2.api\u002F1.index",[289,291,292,297,302,307,312,317],{"title":271,"path":286,"stem":287,"icon":290},"i-lucide-book-open",{"title":5,"path":255,"stem":257,"icon":254},{"title":293,"path":294,"stem":295,"icon":296},"Conventions","\u002Fdocs\u002Fapi\u002Fconventions","1.docs\u002F2.api\u002F3.conventions","i-lucide-ruler",{"title":298,"path":299,"stem":300,"icon":301},"Accounts","\u002Fdocs\u002Fapi\u002Faccounts","1.docs\u002F2.api\u002F4.accounts","i-lucide-wallet",{"title":303,"path":304,"stem":305,"icon":306},"Trades & positions","\u002Fdocs\u002Fapi\u002Ftrades","1.docs\u002F2.api\u002F5.trades","i-lucide-arrow-left-right",{"title":308,"path":309,"stem":310,"icon":311},"Search","\u002Fdocs\u002Fapi\u002Fsearch","1.docs\u002F2.api\u002F6.search","i-lucide-search",{"title":313,"path":314,"stem":315,"icon":316},"MCP server","\u002Fdocs\u002Fapi\u002Fmcp","1.docs\u002F2.api\u002F7.mcp","i-lucide-sparkles",{"title":318,"path":170,"stem":319,"icon":320},"Errors","1.docs\u002F2.api\u002F8.errors","i-lucide-triangle-alert","i-lucide-code-xml",{"title":323,"path":324,"stem":325,"children":326,"page":283},"Essentials","\u002Fdocs\u002Fessentials","1.docs\u002F2.essentials",[327,332,336,341],{"title":328,"path":329,"stem":330,"icon":331},"Markdown Syntax","\u002Fdocs\u002Fessentials\u002Fmarkdown-syntax","1.docs\u002F2.essentials\u002F1.markdown-syntax","i-lucide-heading-1",{"title":333,"path":334,"stem":335,"icon":321},"Code Blocks","\u002Fdocs\u002Fessentials\u002Fcode-blocks","1.docs\u002F2.essentials\u002F2.code-blocks",{"title":337,"path":338,"stem":339,"icon":340},"Prose Components","\u002Fdocs\u002Fessentials\u002Fprose-components","1.docs\u002F2.essentials\u002F3.prose-components","i-lucide-component",{"title":342,"path":343,"stem":344,"icon":345},"Images and Embeds","\u002Fdocs\u002Fessentials\u002Fimages-embeds","1.docs\u002F2.essentials\u002F4.images-embeds","i-lucide-image",[347,349],{"title":271,"path":286,"stem":287,"description":348,"icon":290,"children":-1},"Read your trading accounts — and every account published on ShowMyTrades — as JSON, from your own code or from an AI assistant.",{"title":293,"path":294,"stem":295,"description":350,"icon":296,"children":-1},"Units, signs, dates, identifiers and pagination — what every number in a response actually means.",1788228306684]