{"openapi":"3.1.0","info":{"title":"Bitpanda (BYOK) API","version":"0.1.0","description":"Bitpanda (BYOK) lets an AI assistant read your own Bitpanda data through the Bitpanda API with a key you supply (Bitpanda API key (Read, Balances, Transaction scopes)). Read-only: 8 tools (get_portfolio, get_portfolio_history, list_operations, list_currencies, list_assets, get_asset_ticker, list_earn_configs, get_trading_limits). The BYOK key travels with each request, is used for that one call...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-bitpanda.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-bitpanda/docs"},"termsOfService":"https://connectorbay.com/byok-bitpanda/terms"},"servers":[{"url":"https://byok-bitpanda.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-bitpanda/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_portfolio":{"post":{"operationId":"get_portfolio","summary":"Show your portfolio: for each asset the balance, available balance, invested amount, average buy price, total return and","description":"Show your portfolio: for each asset the balance, available balance, invested amount, average buy price, total return and return percent. Needs the Balances scope. Use for \"What is in my Bitpanda portfolio and how much have I gained\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"equivalent_currency_id":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Show values also in this currency. Currency id (UUID) as returned by list_currencies.","title":"Equivalent Currency Id"},"currency_id":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Only holdings in this fiat currency. Currency id (UUID) as returned by list_currencies.","title":"Currency Id"},"asset_id":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Only this asset (UUID as returned by list_assets).","title":"Asset Id"}},"title":"get_portfolioArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_portfolio_history":{"post":{"operationId":"get_portfolio_history","summary":"Show how the portfolio value changed over a time frame: a list of dated values and the return percentage. Needs the Bala","description":"Show how the portfolio value changed over a time frame: a list of dated values and the return percentage. Needs the Balances scope. Use for \"How has my Bitpanda portfolio performed over the last month\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"timeframe":{"anyOf":[{"enum":["DAY","WEEK","MONTH","SIX_MONTH","YEAR"],"type":"string"},{"type":"null"}],"default":null,"description":"Period to cover.","title":"Timeframe"},"equivalent_currency_id":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Value the history in this currency. Currency id (UUID) as returned by list_currencies.","title":"Equivalent Currency Id"}},"title":"get_portfolio_historyArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_operations":{"post":{"operationId":"list_operations","summary":"List account operations (deposits, withdrawals, trades) newest first, each with its transactions: asset, amounts, fees, ","description":"List account operations (deposits, withdrawals, trades) newest first, each with its transactions: asset, amounts, fees, direction and time. Needs the Transaction scope. Use for \"What deposits and trades did I make on Bitpanda in September 2026\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many results to return per page (this connector allows 1 to 100).","title":"Page Size"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor: pass next_cursor from the previous answer to get the next page.","title":"Cursor"},"from_time":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only operations from this time on, ISO 8601, for example 2026-09-01T00:00:00.000Z.","title":"From Time"},"to_time":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only operations up to this time, ISO 8601.","title":"To Time"}},"title":"list_operationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_currencies":{"post":{"operationId":"list_currencies","summary":"List the fiat currencies Bitpanda supports with id, symbol and name. Needs the Trade (Read) scope. Use for \"Which fiat c","description":"List the fiat currencies Bitpanda supports with id, symbol and name. Needs the Trade (Read) scope. Use for \"Which fiat currencies does Bitpanda support and what are their ids\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Only the currency with this id.","title":"Id"}},"title":"list_currenciesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_assets":{"post":{"operationId":"list_assets","summary":"List tradable assets with id, name, symbol, ISIN, group, type and whether buying, selling, deposits and withdrawals are ","description":"List tradable assets with id, name, symbol, ISIN, group, type and whether buying, selling, deposits and withdrawals are active. Filter by symbol, ISIN, type or group. Use for \"Is Bitcoin buyable on Bitpanda right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many results to return per page (this connector allows 1 to 100).","title":"Page Size"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor: pass next_cursor from the previous answer to get the next page.","title":"Cursor"},"symbol":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only assets with this ticker symbol, for example 'BTC'.","title":"Symbol"},"isin":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only the asset with this ISIN.","title":"Isin"},"type":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only assets of this type.","title":"Type"},"group":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only assets of this group.","title":"Group"},"id":{"anyOf":[{"maxLength":400,"type":"string"},{"type":"null"}],"default":null,"description":"Only these asset ids, comma-separated UUIDs.","title":"Id"}},"title":"list_assetsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_asset_ticker":{"post":{"operationId":"get_asset_ticker","summary":"Get the current price of one asset and the currency the price is in. Needs the Trade (Read) scope. Use for \"What is the ","description":"Get the current price of one asset and the currency the price is in. Needs the Trade (Read) scope. Use for \"What is the current Bitpanda price of the asset b86c034b-efe3-11eb-b56f-0691764446a7\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"asset_id":{"description":"Asset id (UUID) as returned by list_assets.","maxLength":64,"title":"Asset Id","type":"string"}},"required":["asset_id"],"title":"get_asset_tickerArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_earn_configs":{"post":{"operationId":"list_earn_configs","summary":"List Bitpanda Earn configurations: asset, type, mode, annual percentage rate and whether each is enabled or sold out. Ne","description":"List Bitpanda Earn configurations: asset, type, mode, annual percentage rate and whether each is enabled or sold out. Needs the Earn (Read) scope. Use for \"What staking rates does Bitpanda Earn offer\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many results to return per page (this connector allows 1 to 100).","title":"Page Size"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor: pass next_cursor from the previous answer to get the next page.","title":"Cursor"},"asset_id":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Only configurations of this asset (UUID).","title":"Asset Id"},"type":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only this Earn type.","title":"Type"},"mode":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only this Earn mode.","title":"Mode"}},"title":"list_earn_configsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_trading_limits":{"post":{"operationId":"get_trading_limits","summary":"Show the daily trading volume limits set for this API key and how much buying and selling budget remains today. Use for ","description":"Show the daily trading volume limits set for this API key and how much buying and selling budget remains today. Use for \"How much can this Bitpanda API key still buy today\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_trading_limitsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}