Taxonomy for assets

Returns Taxonomy for assets. Results are ordered by tuple (asset, classification_start_time). To fetch the next page of results use next_page_url JSON response field.

get

Authorizations

api_key

api_keystringRequired

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

Query parameters

assetsstring[]Optional

Comma separated list of assets.

class_idsstring[]Optional

Comma separated list of class identifiers.

sector_idsstring[]Optional

Comma separated list of sector identifiers.

subsector_idsstring[]Optional

Comma separated list of subsector identifiers.

versionstringOptional

Taxonomy version. Defaults to latest when no *_time parameters specified. Specify asterisk * in order to get all versions.

classification_start_timestringOptional

Start time of taxonomy asset classification.
Multiple formats of ISO 8601 are supported: 2006-01-20T00:00:00Z, 2006-01-20T00:00:00.000Z, 2006-01-20T00:00:00.123456Z, 2006-01-20T00:00:00.123456789Z, 2006-01-20, 20060120.
Inclusive by default.

classification_end_timestringOptional

End time of taxonomy asset classification.
Multiple formats of ISO 8601 are supported: 2006-01-20T00:00:00Z, 2006-01-20T00:00:00.000Z, 2006-01-20T00:00:00.123456Z, 2006-01-20T00:00:00.123456789Z, 2006-01-20, 20060120.
Inclusive by default.

start_inclusivebooleanOptional

Inclusive or exclusive corresponding start_* parameters.

Default: true

end_inclusivebooleanOptional

Inclusive or exclusive corresponding end_* parameters.

Default: true

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.

prettybooleanOptional

Human-readable formatting of JSON responses.

Default: false

Responses

200

Assets' taxonomy.

application/json

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.

401

Requested resource requires authorization.

application/json

403

Requested resource is not available with supplied credentials.

application/json

414

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

get/taxonomy/assets

ShellPythonPython Client

curl --compressed "https://api.coinmetrics.io/v4/taxonomy/assets?api_key=<your_key>"

{
  "data": [
    {
      "asset": "asset1",
      "full_name": "Asset 1",
      "taxonomy_version": 1,
      "updated_at_taxonomy_version": 1,
      "classification_start_time": "2010-07-19",
      "class_id": 20,
      "class": "Application",
      "sector_id": 2030,
      "sector": "Metaverse",
      "subsector_id": 203020,
      "subsector": "Gaming",
      "classification_end_time": "2021-06-12"
    },
    {
      "asset": "asset2",
      "full_name": "Asset 2",
      "taxonomy_version": 2,
      "updated_at_taxonomy_version": 2,
      "classification_start_time": "2022-06-13",
      "class_id": 10,
      "class": "Transaction",
      "sector_id": 1010,
      "sector": "Digital Currency (DC)",
      "subsector_id": 101010,
      "subsector": "General-Purpose Digital Currencies"
    }
  ],
  "next_page_token": "bHJjfDE2Njc0MzM2MDAwMDA",
  "next_page_url": "https://api.coinmetrics.io/v4/taxonomy/assets?page_size=2&api_key=<your_key>&next_page_token=bHJjfDE2Njc0MzM2MDAwMDA"
}