Markets

Returns a list of markets metadata.

get

https://api.coinmetrics.io/v4https://community-api.coinmetrics.io/v4

/reference-data/markets

Authorizations

api_key

api_keystringRequired

Coin Metrics API key can be specified as ?api_key= query parameter.

Query parameters

marketsstring[]Optional

Comma separated list of markets. By default all markets are returned.

exchangestringOptional

Unique name of an exchange.

typestring · enumOptional

Type of markets.

Possible values:

basestringOptional

Base asset of markets.

quotestringOptional

Quote asset of markets.

assetstringOptional

Any asset of markets.

symbolstringOptional

Symbol of derivative markets, full instrument name.

asset_classstring · enumOptional

Asset class of the market.

Possible values:

source_typestring · enumOptional

Source type of the exchange.

Possible values:

cusipstringOptional

CUSIP identifier to filter markets. Only one of cusip, figi, or isin may be specified at a time.

figistringOptional

FIGI identifier to filter markets. Only one of cusip, figi, or isin may be specified at a time.

isinstringOptional

ISIN identifier to filter markets. Only one of cusip, figi, or isin may be specified at a time.

includestringOptional

Comma-separated list of namespaces to include in response. Currently, the only supported value is talos.

page_sizeinteger · int32 · min: 1 · max: 10000Optional

Number of items per single page of results.
The value of this parameter is ignored if the endpoint supports the format parameter and its value is set to json_stream.

Default: 100

paging_fromstring · enumOptional

Where does the first page start, at the start of the interval or at the end.
The value of this parameter is ignored if the endpoint supports the format parameter and its value is set to json_stream.

Default: startPossible values:

next_page_tokenstringOptional

Token for receiving the results from the next page of a query.
Should not be used directly. To iterate through pages just use next_page_url response field.

formatstringOptional

Format of the response. Supported values are json, json_stream.

Default: json

prettybooleanOptional

Human-readable formatting of JSON responses.

Default: false

Responses

200

List of markets metadata.

application/json

List of markets.

next_page_tokenstringOptional

Token of the next page results for a given request.

next_page_urlstringOptional

URL of the next page results for a given request.

400

Market not found.

application/json

401

Requested resource requires authorization.

application/json

414

Provided URI is too long. It must not be greater than 10000 symbols.

get/reference-data/markets

ShellPythonPython Client

curl --compressed "https://api.coinmetrics.io/v4/reference-data/markets?api_key=<your_key>"

{
  "data": [
    {
      "market": "binance-btc-usdt-spot",
      "exchange": "binance",
      "type": "spot",
      "base": "btc",
      "quote": "usdt",
      "pair": "btc-usdt",
      "symbol": "BTCUSDT"
    },
    {
      "market": "binance-1000FLOKIUSDT-future",
      "exchange": "binance",
      "type": "future",
      "base": "floki",
      "quote": "usdt",
      "pair": "floki-usdt",
      "symbol": "1000FLOKIUSDT",
      "size_asset": "floki",
      "margin_asset": "usdt",
      "contract_size": 1000,
      "tick_size": 0.00001,
      "listing": "2023-05-06T00:00:00.000000000Z",
      "order_amount_increment": 1,
      "order_amount_min": 1,
      "order_amount_max": 10000000,
      "order_price_increment": 0.00001,
      "order_price_min": 0.00001,
      "order_price_max": 200,
      "order_size_min": 5
    },
    {
      "market": "deribit-BTC-10DEC22-17500-C-option",
      "exchange": "deribit",
      "type": "option",
      "base": "btc",
      "quote": "usd",
      "pair": "btc-usd",
      "symbol": "BTC-10DEC22-17500-C",
      "size_asset": "btc",
      "strike": 17500,
      "option_contract_type": "call",
      "is_european": true,
      "contract_size": 1,
      "listing": "2022-12-08T08:01:00.000000000Z",
      "expiration": "2022-12-10T08:00:00.000000000Z",
      "settlement_price": 17160.85,
      "status": "offline",
      "order_amount_min": 0.1,
      "order_price_increment": 0.0005,
      "order_taker_fee": 0.0003,
      "order_maker_fee": 0.0003
    }
  ],
  "next_page_token": "ZGVyaWJpdC1CVEMtMTBERUMyMi0xNzUwMC1QLW9wdGlvbg",
  "next_page_url": "https://api.coinmetrics.io/v4/reference-data/markets?api_key=<your_key>&page_size=3&next_page_token=ZGVyaWJpdC1CVEMtMTBERUMyMi0xNzUwMC1QLW9wdGlvbg"
}