Skip to navigation
Production API ReferenceMarkets

List available markets

Get markets static data component

Markets are listed by symbol. Filter the list with asset_kind and base_asset, each a comma-separated list. Send the ETag of an unfiltered response back in If-None-Match to get 304 Not Modified while the list is unchanged.

Unfiltered requests for every market draw on a per-client budget, except those answered 304 Not Modified. Past it the API answers 429 Too Many Requests with a Retry-After header, so filter the list down to the markets you use.

Query parameters

marketstringOptional

Market Name - example: BTC-USD-PERP

asset_kindstringOptional

Without market only: comma-separated asset kinds to list, out of PERP, PERP_OPTION, OPTION, SPOT and FUTURE - example: PERP,SPOT

base_assetstringOptional

Without market only: comma-separated base assets to list - example: BTC,ETH

Response headers

ETagstringOptional

Without asset_kind and base_asset: weak validator of the response; send it back in If-None-Match to get 304 while it is unchanged

Response

OK
resultslist of objectsOptional
Array of results

Errors

400
Bad Request Error
404
Not Found Error
429
Too Many Requests Error