List Markets

The pair list a client builds its trading screen from: which markets are tradable, how to format the numbers on each, and what a fill costs.

GET/api/marketsAuth: Required

Query Parameters

pagenumber

Page number. Default 1.

per_pagenumber

Items per page. Default 20, maximum 1000.

Response

A paginated envelope; the markets are in items.

total_countnumberRequired

Total number of markets across all pages.

itemsarrayRequired

The markets.

More attributes

GET/api/markets

curl -G 'https://api.example.com/api/markets' \
  -H 'Api-Token: YOUR_API_TOKEN' \
  --data-urlencode 'page=1' \
  --data-urlencode 'per_page=20'

EXAMPLE RESPONSE

{
  "total_count": 17,
  "per_page": 20,
  "total_pages": 1,
  "page": 1,
  "prev_page": null,
  "next_page": null,
  "items": [
    {
      "market": "trxusdt",
      "active": true,
      "bid_asset_id": "usdt",
      "ask_asset_id": "trx",
      "base_precision": 1,
      "quote_precision": 5,
      "price_precision": 4,
      "min_volume": "100.0",
      "min_amount": "150.0",
      "maker_fee": "0.001",
      "taker_fee": "0.001",
      "created_at": "2025-01-06T18:19:26.907Z",
      "updated_at": "2026-09-04T11:21:37.727Z"
    }
  ]
}

Which field is which side

Two naming schemes meet in this object, so it is worth reading the pairing off once. On trxusdt:

Field	Value	Side
ask_asset_id	trx	base — the asset being traded
bid_asset_id	usdt	quote — the asset it is priced in
base_precision	1	decimals for the asset in ask_asset_id
quote_precision	5	decimals for the asset in bid_asset_id
price_precision	4	decimals for the price

The fee is taken in the asset the member received — the base asset on a buy, the quote asset on a sell — and each trade shows it in fee and fee_asset_id. Rates depend on the fee group set for your account, so the values here are yours: read them from your own GET /api/markets, and do not assume another merchant's. They apply to orders you place with Create Order; auto-conversions are charged at their own rate.

Validate order size before sending

min_volume and min_amount let you check an order in your own code instead of discovering the refusal after sending it. Compare against whichever field you are about to send: min_volume for an order priced by volume, min_amount for one priced by amount.

The two are denominated differently — on trxusdt above, min_volume is 100.0 TRX and min_amount is 150.0 USDT — so do not compare one against the other.