1. MCP Server
Bitpanda API
  • REST API
    • Overview
    • API key generation
    • Migrating from the legacy API
    • Endpoints
      • Quotes
        • Create a trading quote
        • Accept a trading quote
      • Portfolio
        • Get portfolio overview
        • Get portfolio performance history
      • Operations
        • List operations
      • Currencies
        • List available currencies
      • Assets
        • List available assets
      • Earn
        • Execute an earn action (stake or unstake)
        • List earn asset configurations
      • Tickers
        • Get the ticker for a given asset
      • Trading Limits
        • Get current trading limits and remaining budget
        • Set daily trading volume limits for this API key
      • Margin
        • Get the leverage multipliers currently allowed for margin trading an asset
      • Crypto Networks
        • Get the blockchain networks supported for depositing and withdrawing a crypto asset
  • MCP Server
    • Getting Started
    • Tools
  • Rate Limits
    • API and MCP Rate Limits
  • Feedback & Support
    • Community Hub
  1. MCP Server

Tools

The Bitpanda MCP server exposes the tools below. Your AI assistant chooses which tool to call based on your request, so you don't call them directly. The descriptions explain what each tool does and the rules your assistant follows when using it.
Each tool also lists the API key scope it needs, its rate-limit group and its parameters.

Assets#

list_assets#

Browse the assets available on Bitpanda, such as cryptocurrencies, stocks, ETFs and metals. You can filter by ISIN, symbol, asset type, asset group or asset ID. Results are paginated.
Some stocks and ETFs appear twice with the same ISIN or symbol: once as a legacy security asset and once as a tradeable equity_security asset. Use the equity_security asset for trading. The legacy security assets can't be bought.
Required scope: trading
Rate-limit group: read (50 requests per second)
ParameterRequiredDescription
cursorNoPagination cursor
pageSizeNoNumber of results per page (1-100, default 25)
isinNoFilter by ISIN
typeNoFilter by asset type
groupNoFilter by asset group
symbolNoFilter by symbol
idNoFilter by asset UUID, or a comma-separated list of asset UUIDs

Currencies#

list_available_currencies#

List the fiat currencies supported by Bitpanda, such as EUR, USD or CHF. You can optionally look up a single currency by its ID. Tools that trade or value assets refer to currencies by their ID.
Required scope: trading
Rate-limit group: read (50 requests per second)
ParameterRequiredDescription
idNoOptional currency UUID to filter to a single currency

Tickers#

get_ticker#

Get the current price of an asset in euros.
Required scope: trading
Rate-limit group: read (50 requests per second)
ParameterRequiredDescription
assetIdYesAsset UUID to get the ticker for

Crypto Networks#

get_crypto_asset_networks#

Show which blockchain networks a crypto asset can be deposited to or withdrawn from on Bitpanda. Look up the asset by its ID or by its ticker symbol (for example BTC). For each network the response includes:
Availability: whether the network is operational and whether deposits and withdrawals are currently allowed.
Deposits: the minimum deposit, the minimum amount for a fee-free deposit, and the deposit fee.
Withdrawals: the withdrawal fee and its range, plus the minimum and maximum withdrawal amounts (per transaction and per 24 hours).
All amounts are in the crypto asset itself. A missing value means the setting isn't configured, and a limit of 0 means there is no limit.
Required scope: trading
Rate-limit group: read (50 requests per second)
ParameterRequiredDescription
assetIdNoAsset id (UUID) of the crypto asset, as returned by list_assets. Use symbol instead to look up by ticker
symbolNoTicker symbol of the crypto asset, case-insensitive (e.g. BTC, ETH)

Portfolio#

get_portfolio_holdings#

Show what you currently hold on Bitpanda and what it's worth. Holdings are valued in EUR by default, or in another fiat currency you choose. You can narrow the result to a single asset or currency.
Required scope: balance
Rate-limit group: read (50 requests per second)
ParameterRequiredDescription
equivalentCurrencyIdNoUUID of the equivalent currency for valuation (defaults to EUR)
currencyIdNoFilter by currency UUID
assetIdNoFilter by asset UUID

get_portfolio_history#

Show how the value of your portfolio has changed over a period: a day, week, month, six months or a year. Values are in EUR by default, or in another fiat currency you choose.
Required scope: balance
Rate-limit group: read (50 requests per second)
ParameterRequiredDescription
equivalentCurrencyIdNoUUID of the equivalent currency for valuation (defaults to EUR)
timeframeNoTimeframe: DAY, WEEK, MONTH, SIX_MONTH, YEAR (defaults to DAY)

Operations#

list_operation_history#

List your past operations on Bitpanda. You can filter by time range, asset or currency. Results are paginated.
Required scope: transaction
Rate-limit group: read (50 requests per second)
ParameterRequiredDescription
cursorNoPagination cursor
pageSizeNoPage size (1-100, default 25)
fromNoFilter from this timestamp (ISO-8601)
toNoFilter to this timestamp (ISO-8601)
assetIdsNoFilter by asset UUIDs (comma-separated)
currencyIdsNoFilter by currency UUIDs (comma-separated)

Cards#

list_cards#

List your Bitpanda Cards. For each card the response includes:
Its name, type (virtual or physical), status and last four digits. Only cards with status ACTIVE can be used for payments.
Its plan (tier), with the plan's daily, daily ATM and monthly spending limits.
The asset used to pay for card payments, and the fallback asset used when the main asset's balance is too low.
The cashback rate, the cashback earned this calendar month and the cashback earned all time.
Each card has two identifiers:
card_id: identifies one specific card. A replacement card always gets a new card_id.
card_chain_id: shared by all versions of a card that keep the same card number. For example, a temporary virtual card and the physical card that replaces it share a card_chain_id. A card reissued with a new number, for example after loss or theft, gets a new card_chain_id. Cashback totals are summed per card_chain_id.
If you don't have a Bitpanda Card, the list is empty.
Required scope: transaction
Rate-limit group: read (50 requests per second)
This tool takes no parameters.

list_card_transactions#

List your Bitpanda Card transactions across all your cards, newest first. Declined transactions are included. For each transaction the response includes:
The card it was made with (card_id and card_chain_id, as returned by list_cards).
Whether it's a payment or ATM withdrawal (DEBIT) or a refund (CREDIT).
Its status: PENDING (authorized but not yet settled by the merchant, so the amount can still change or the payment can still be canceled), APPROVED (settled), CANCELED (canceled or reversed before settlement) or DECLINED (rejected and not charged). For declined transactions, the reason, for example INSUFFICIENT_FUNDS or CARD_LIMITS.
The merchant name and the time of the transaction.
The amount including card fees, in the transaction's currency.
The asset sold to pay for it, and how much of it was sold. Both are empty if the transaction was paid directly in fiat.
The cashback earned on it.
You can filter by card, time range, amount, merchant name, merchant category (for example GROCERIES, RESTAURANTS or ATM_WITHDRAWAL), the asset used to pay and whether cashback was earned. Results are paginated.
Required scope: transaction
Rate-limit group: read (50 requests per second)
ParameterRequiredDescription
cardIdsNoOnly these cards: card_id values from list_cards
cardChainIdsNoOnly these cards including all their versions: card_chain_id values from list_cards
fromNoOnly transactions at or after this timestamp (ISO-8601, e.g. 2026-01-01T00:00:00Z)
toNoOnly transactions at or before this timestamp (ISO-8601, e.g. 2026-01-31T23:59:59Z)
minAmountNoMinimum amount in the transaction's currency, excluding fees, e.g. 10.50
maxAmountNoMaximum amount in the transaction's currency, excluding fees, e.g. 100
merchantNoCase-insensitive partial match on the merchant name, e.g. amazon
categoryNoMerchant category, case-insensitive. One of: PURCHASE, ATM_WITHDRAWAL, CREDIT, GROCERIES, RESTAURANTS, MOBILITY, AIRLINE, LODGING, ENTERTAINMENT, HEALTHCARE, SERVICES, FINANCIAL
assetIdNoOnly transactions paid by selling this asset (asset UUID, e.g. main_funding_asset.asset_id from list_cards)
hasCashbackNotrue for only transactions that earned cashback, false for only those that did not
cursorNoPagination cursor: next_cursor from the previous page
pageSizeNoNumber of results per page (1-100, default 25)

Earn#

list_earn_configs#

List the earn products you can put your assets into, with their current APR and availability. You can filter by asset, by earn type (FLEXIBLE or LOCKED) and by earn mode (STAKING_EARN or STABLE_COIN_EARN). Results are paginated.
Required scope: earn
Rate-limit group: read (50 requests per second)
ParameterRequiredDescription
assetIdNoFilter by asset UUID
typeNoFilter by earn type: FLEXIBLE or LOCKED
modeNoFilter by earn mode: STAKING_EARN or STABLE_COIN_EARN
cursorNoPagination cursor
pageSizeNoNumber of results per page (1-250, default 20)

earn_stake#

Stake an amount of an asset into an earn product. Choose the product with list_earn_configs first.
Required scope: earn-write
Rate-limit group: earn_write (5 requests per second)
ParameterRequiredDescription
configIdYesEarn config UUID (from list_earn_configs)
assetAmountYesAmount of the asset to stake
walletIdNoWallet UUID to stake from

earn_unstake#

Unstake an amount of an asset from an earn product.
Required scope: earn-write
Rate-limit group: earn_write (5 requests per second)
ParameterRequiredDescription
configIdYesEarn config UUID (from list_earn_configs)
assetAmountYesAmount of the asset to unstake
walletIdNoWallet UUID to unstake from

Margin#

get_margin_leverage_multipliers#

Show which leverage multipliers (for example 2x, 5x or 10x) you can currently use to trade an asset on margin. Only the multipliers available to you are returned. Bitpanda supports long margin positions only; short positions are not available yet.
Required scope: trading
Rate-limit group: read (50 requests per second)
ParameterRequiredDescription
marginAssetIdYesAsset id (UUID) of the margin asset, as returned by list_assets
directionYesPosition direction: LONG (SHORT is not offered on Bitpanda yet)

Trading#

request_for_quote#

Request a price quote to buy or sell an asset. You can specify the order as an asset quantity (for example 0.1 BTC) or as an amount of money (for example 100 EUR). The quote includes the fee in fiat.
Your assistant follows these rules when it shows you a quote:
One quote at a time: you can only have one active quote. Your assistant requests a quote, waits for you to accept or reject it, and only then requests the next one.
Key Information Document (KID): for ETFs and ETCs, your assistant always shows you the link to the product's Key Information Document before you accept.
Costs disclosure: before anything else, your assistant shows the expected costs of the trade (ex-ante costs) as three tables:
1.
Costs and Charges: each cost type with its amount and its share of the investment, plus a total.
2.
Impact on Performance: your net investment after costs, how much costs reduce your return, and an annual illustration of your return before and after costs.
3.
Cumulative Costs: the estimated costs and the annual return for each holding period.
Warnings: any warnings returned with the quote are always shown.
Trading budget: if your API key has daily trading limits, the quote also shows how much of today's budget is left.
Required scope: trading-write
Rate-limit group: trading_write (5 requests per second)
ParameterRequiredDescription
assetIdYesAsset UUID to trade
currencyIdYesCurrency UUID to trade against
sideYesSide of the trade: BUY or SELL
quantityNoQuantity (asset amount) to trade, e.g. 0.1
notionalNoNotional (currency amount) to trade, e.g. 100

accept_quote#

Accept the quote you requested with request_for_quote and execute the trade.
Required scope: trading-write
Rate-limit group: trading_write (5 requests per second)
ParameterRequiredDescription
quoteIdYesQuote UUID to accept

get_trading_limit#

Show the daily buy and sell limits set on your API key and how much of today's budget is left.
Required scope: trading-write
Rate-limit group: trading_write (5 requests per second)
This tool takes no parameters.

set_trading_limit#

Set daily limits on how much your API key can buy and sell, in a currency you choose. You set the buy and sell limits separately.
Limits can't be changed after they're set. To use different limits, create a new API key.
Required scope: trading-write
Rate-limit group: trading_write (5 requests per second)
ParameterRequiredDescription
buyLimitYesDaily buy volume limit (e.g. 1000.00)
sellLimitYesDaily sell volume limit (e.g. 500.00)
currencyIdYesCurrency UUID in which limits are denominated

API Key#

get_api_key_info#

Show details of the API key you're connected with: its label, its short token, its status (active, revoked, expired or pending), the scopes it has been granted, when it was created and when it expires, and the IP addresses it's restricted to, if any.
If you connected via OAuth (for example through the Claude connector), there is no API key, so the tool returns only the authentication type (oauth) and the scopes you granted.
Your assistant uses this to check whether your key has the scope a tool needs before calling it, or to explain why a tool call was rejected for a missing scope.
Required scope: None
Rate-limit group: read (50 requests per second)
This tool takes no parameters.
Modified at 2026-11-10 16:00:35
Previous
Getting Started
Next
API and MCP Rate Limits
Built with