---
title: "Taxonomy for assets"
method: GET
path: "/taxonomy/assets"
tags: ["Taxonomy"]
---

# Taxonomy for assets

`GET /taxonomy/assets`

## Request

- Base URL: `https://api.coinmetrics.io/v4`
- URL: `https://api.coinmetrics.io/v4/taxonomy/assets`
- Auth: API key in query parameter `api_key`
- TypeScript: <https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4/docs/taxonomy/assets/get.ts> (a function with typed inputs; its response is checked against the schema)

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

## Query parameters

- `assets` string[]
- `class_ids` string[]
- `sector_ids` string[]
- `subsector_ids` string[]
- `version` string
- `classification_start_time` string
- `classification_end_time` string
- `start_inclusive` boolean
- `end_inclusive` boolean
- `page_size` integer
- `paging_from` 'start' | 'end', PagingFrom
- `next_page_token` string
- `pretty` boolean

## Response `200`

Assets' taxonomy.

- TaxonomyAssetsResponse
  - `data` TaxonomyAsset[], required
    - `asset` string, required: Name of the asset.
    - `full_name` string, required: The full name of the asset.
    - `taxonomy_version` string, required: This field is obsolete and will be removed in future releases in favor to `updated_at_taxonomy_version` field.
    - `updated_at_taxonomy_version` string, required: Taxonomy version the asset was classified or re-classified at.
    - `classification_start_time` string, required: Taxonomy asset's classification start time.
    - `classification_end_time` string: Taxonomy asset's classification end time.
    - `class_id` string, required: Taxonomy class identifier.
    - `class` string, required: Taxonomy class name.
    - `sector_id` string, required: Taxonomy sector identifier.
    - `sector` string, required: Taxonomy sector name.
    - `subsector_id` string, required: Taxonomy subsector identifier.
    - `subsector` string, required: Taxonomy subsector name.
  - `next_page_token` string: Token of the next page results for a given request.
  - `next_page_url` string: URL of the next page results for a given request.

## Other responses

- `401`: Requested resource requires authorization.
- `403`: Requested resource is not available with supplied credentials.
- `414`: Provided URI is too long. It must not be greater than 10000 symbols.

---

[API](https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4.md) - [All operations](https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4/llms.txt) - [OpenAPI document](https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4/revisions/774268c0a4fe?raw)