Retrieving supported currencies

To get the full list of available currency pairs, including buy/sell status, minimum and maximum amounts, and chain information, you can retrieve them from the API.

This is useful for building currency selectors in your UI or for determining which baseCurrency and quoteCurrency values to use when requesting a quote or creating a checkout session.

Prerequisites

You need a valid JWT token. See Quick start: step 1 for how to authenticate.

Endpoint

GET /api/v1/system/currency-pairs

Example

curl https://api-sandbox.btcdirect.eu/api/v1/system/currency-pairs \
  -H "Authorization: Bearer YOUR_TOKEN"

Try it out

Retrieve all supported currency pairs. Requires a valid JWT token.

Authorization (partner JWT token)

GET /api/v1/system/currency-pairs Copy as curl

Response

Response

The response is an array of currency pairs. Each pair includes the cryptocurrency details, fiat currency, and buy/sell availability with min/max amounts.

[
  {
    "currencyPair": "BTC-EUR",
    "baseCurrency": {
      "code": "BTC",
      "ticker": "BTC",
      "chain": null,
      "name": "Bitcoin",
      "decimals": 8,
      "supportsTag": false,
      "caip19": "bip122:000000000019d6689c085ae165831e93/slip44:0"
    },
    "quoteCurrency": {
      "code": "EUR",
      "name": "Euro",
      "decimals": 2,
      "caip19": "swift:0/iso4217:EUR"
    },
    "buy": {
      "status": "enabled",
      "min": { "amount": 30, "currencyCode": "EUR" },
      "max": { "amount": 101000, "currencyCode": "EUR" }
    },
    "sell": {
      "status": "enabled",
      "min": { "amount": 0.00049878, "currencyCode": "BTC" },
      "max": { "amount": 1.67958524, "currencyCode": "BTC" }
    }
  }
]

Use baseCurrency.code (e.g. BTC) and quoteCurrency.code (e.g. EUR) as the currencyPair (e.g. BTC-EUR) when requesting a quote or creating a checkout session. Alternatively, you can pass the baseCurrency.caip19 and quoteCurrency.caip19 values as sourceCurrency and targetCurrency strings instead. See CAIP-19 support for details.

The supportsTag field indicates whether the cryptocurrency requires a wallet address tag (destination tag or memo).

For a static overview, see Supported currencies.

See the endpoint specification for the full response schema.