Skip to main content
GET
/
public
/
AssetPairs
Get Tradable Asset Pairs
curl --request GET \
  --url https://api.kraken.com/0/public/AssetPairs
{
  "error": [],
  "result": {
    "XETHXXBT": {
      "altname": "ETHXBT",
      "wsname": "ETH/XBT",
      "aclass_base": "currency",
      "base": "XETH",
      "aclass_quote": "currency",
      "quote": "XXBT",
      "lot": "unit",
      "cost_decimals": 6,
      "pair_decimals": 5,
      "lot_decimals": 8,
      "lot_multiplier": 1,
      "leverage_buy": [
        2,
        3,
        4,
        5
      ],
      "leverage_sell": [
        2,
        3,
        4,
        5
      ],
      "fees": [
        [
          0,
          0.26
        ],
        [
          50000,
          0.24
        ],
        [
          100000,
          0.22
        ],
        [
          250000,
          0.2
        ],
        [
          500000,
          0.18
        ],
        [
          1000000,
          0.16
        ],
        [
          2500000,
          0.14
        ],
        [
          5000000,
          0.12
        ],
        [
          10000000,
          0.1
        ]
      ],
      "fees_maker": [
        [
          0,
          0.16
        ],
        [
          50000,
          0.14
        ],
        [
          100000,
          0.12
        ],
        [
          250000,
          0.1
        ],
        [
          500000,
          0.08
        ],
        [
          1000000,
          0.06
        ],
        [
          2500000,
          0.04
        ],
        [
          5000000,
          0.02
        ],
        [
          10000000,
          0
        ]
      ],
      "fee_volume_currency": "ZUSD",
      "margin_call": 80,
      "margin_stop": 40,
      "ordermin": "0.01",
      "costmin": "0.00002",
      "tick_size": "0.00001",
      "status": "online",
      "long_position_limit": 1100,
      "short_position_limit": 400
    },
    "XXBTZUSD": {
      "altname": "XBTUSD",
      "wsname": "XBT/USD",
      "aclass_base": "currency",
      "base": "XXBT",
      "aclass_quote": "currency",
      "quote": "ZUSD",
      "lot": "unit",
      "cost_decimals": 5,
      "pair_decimals": 1,
      "lot_decimals": 8,
      "lot_multiplier": 1,
      "leverage_buy": [
        2,
        3,
        4,
        5
      ],
      "leverage_sell": [
        2,
        3,
        4,
        5
      ],
      "fees": [
        [
          0,
          0.26
        ],
        [
          50000,
          0.24
        ],
        [
          100000,
          0.22
        ],
        [
          250000,
          0.2
        ],
        [
          500000,
          0.18
        ],
        [
          1000000,
          0.16
        ],
        [
          2500000,
          0.14
        ],
        [
          5000000,
          0.12
        ],
        [
          10000000,
          0.1
        ]
      ],
      "fees_maker": [
        [
          0,
          0.16
        ],
        [
          50000,
          0.14
        ],
        [
          100000,
          0.12
        ],
        [
          250000,
          0.1
        ],
        [
          500000,
          0.08
        ],
        [
          1000000,
          0.06
        ],
        [
          2500000,
          0.04
        ],
        [
          5000000,
          0.02
        ],
        [
          10000000,
          0
        ]
      ],
      "fee_volume_currency": "ZUSD",
      "margin_call": 80,
      "margin_stop": 40,
      "ordermin": "0.0001",
      "costmin": "0.5",
      "tick_size": "0.1",
      "status": "online",
      "long_position_limit": 250,
      "short_position_limit": 200
    }
  }
}

Query Parameters

​
assetVersion
enum<integer>

Controls whether response keys and asset identifier fields use Kraken's internal names or display names.

  • Omitted (default): internal names are used. Asset keys use legacy X/Z-prefixed format (XXBT, ZUSD). Pair keys use the internal format (XXBTZUSD). Asset identifier fields (base, quote, fee_volume_currency) also use internal names.
  • assetVersion=1: display names are used. Asset keys become their canonical display names (BTC, USD). Pair keys become the slash-separated display format (BTC/USD). On /public/AssetPairs, the base, quote, and fee_volume_currency fields also switch to display names.

Only assetVersion=1 is currently supported. The altname and wsname fields are not affected by this parameter.

Available options:
1
​
pair
string

Asset pairs to get data for

​
aclass_base
enum<string>
default:currency

Filters the asset class to retrieve (optional)

  • currency = spot currency pairs.
  • tokenized_asset = tokenized asset pairs, i.e. xstocks.
Available options:
currency,
tokenized_asset
​
info
enum<string>
default:info

Info to retrieve (optional)

  • info = all info
  • leverage = leverage info
  • fees = fees schedule
  • margin = margin info
Available options:
info,
leverage,
fees,
margin
​
country_code
string

Filter for response to only include pairs available in the provided country/region (ISO 3166-1 alpha-2 code).

​
execution_venue
enum<string>
default:international

Comma-separated list of execution venues to filter by (optional)

  • international = International exchange
  • bitnomial_exchange = Bitnomial exchange
Available options:
international,
bitnomial_exchange

Response

200 - application/json

Tradable asset pairs retrieved.

​
result
object

Pair names and their info

​
error
string[]

Kraken API error