Bitpanda

Query a Bitpanda account through the API using the bundled scripts/bitpanda.sh CLI.

Prerequisites

Set BITPANDA_API_KEY environment variable with a key from https://web.bitpanda.com/my-account/apikey

Verify access works:

bash \x3Cskill-path>/scripts/bitpanda.sh balances --page-size 5

CLI Usage

All commands are invoked as bash \x3Cskill-path>/scripts/bitpanda.sh \x3Ccommand> [options]. Output is JSON.

Start here: portfolio

For any request about the user's holdings, balances, or portfolio, always use portfolio first:

bash \x3Cskill-path>/scripts/bitpanda.sh portfolio

It handles pagination, zero-balance filtering, asset name resolution, EUR price enrichment, and aggregation by asset (combining regular, staking, and index wallets) automatically. Use --sort value to sort by EUR value descending (default: alphabetical by name). Returns:

{
  "wallets": [
    {"asset_name": "Bitcoin", "asset_symbol": "BTC", "balance": "0.123", "eur_price": "95000", "eur_value": 11685.0, "asset_id": "...", "wallets": [{"wallet_id": "...", "wallet_type": null, "balance": "0.123"}]}
  ],
  "count": 25,
  "total_eur": 50000.0
}

Do NOT manually paginate balances + call asset per ID — portfolio does this for you.

Handling null prices

When portfolio returns wallets with eur_price: null, the exact symbol didn't match the ticker. Report these assets to the user.

Price commands

Trades: trades

For any request about buy/sell history, recent purchases, or trade activity, always use trades first — NOT all-transactions:

bash \x3Cskill-path>/scripts/bitpanda.sh trades [options]

It auto-paginates transactions, filters for buys/sells, resolves asset names, and enriches with asset type and price. Returns:

[
  {"date": "2025-12-22T16:20:48Z", "operation": "buy", "asset_name": "Bitcoin", "asset_symbol": "BTC", "asset_type": "cryptocoin", "amount": "0.5", "current_eur_price": "95000", "trade_id": "...", "asset_id": "..."}
]

Options:

• --operation buy|sell — filter by trade direction (default: both)
• --asset-type \x3Ctype> — filter by asset type: cryptocoin, metal, stock, commodity, etf, etc.
• --limit \x3Cn> — number of trades to return (default 5)
• --from \x3Cdatetime> / --to \x3Cdatetime> — date range filter

Examples:

# Last 3 purchases
bash \x3Cskill-path>/scripts/bitpanda.sh trades --operation buy --limit 3

# Last 3 crypto purchases
bash \x3Cskill-path>/scripts/bitpanda.sh trades --operation buy --asset-type cryptocoin --limit 3

# All trades in January 2026
bash \x3Cskill-path>/scripts/bitpanda.sh trades --from 2026-01-01T00:00:00Z --to 2026-02-01T00:00:00Z --limit 20

Do NOT manually paginate all-transactions + resolve asset names — trades does this for you.

Other commands

Pagination

balances and all-transactions use cursor pagination:

• --before \x3Ccursor> / --after \x3Ccursor> / --page-size \x3Cn> (1-100, default 25)

Filtering

# Balances: filter by asset
bash \x3Cskill-path>/scripts/bitpanda.sh balances --asset-id \x3Cuuid>

# Transactions: filter by direction and wallet
bash \x3Cskill-path>/scripts/bitpanda.sh all-transactions --flow incoming --wallet-id \x3Cuuid>

# Transactions: filter by asset
bash \x3Cskill-path>/scripts/bitpanda.sh all-transactions --asset-id \x3Cuuid>

# Transactions: filter by date range
bash \x3Cskill-path>/scripts/bitpanda.sh all-transactions --from 2024-01-01T00:00:00Z --to 2024-02-01T00:00:00Z

Common Tasks

Last purchases:

bash \x3Cskill-path>/scripts/bitpanda.sh trades --operation buy --limit 3

Recent trades:

bash \x3Cskill-path>/scripts/bitpanda.sh trades --limit 10

List recent transactions (all types including rewards, dividends):

bash \x3Cskill-path>/scripts/bitpanda.sh all-transactions --page-size 10

Check current BTC price:

bash \x3Cskill-path>/scripts/bitpanda.sh price BTC

Transaction fields

• operation_type: The category of operation (e.g. buy, sell, deposit, withdrawal, transfer, staking).
• flow: incoming (credit) or outgoing (debit).
• compensates: Links to a reversed/corrected transaction ID (null for normal transactions).
• trade_id: Present when the transaction resulted from a trade; null for deposits/withdrawals/staking.

API Reference

For full endpoint details, parameters, and response schemas, read references/api_reference.md.