Overview
The asset taxonomy assigns every covered asset to exactly one category in datonomy, the digital asset classification system. It answers a single question: what is this asset for? Each asset receives a class, a sector, and a subsector, described by both a numeric code and a human-readable name, based on what the asset and its underlying protocol are primarily used for. The starting point is the purpose the protocol’s creators describe, but where that differs materially from market perception and observed usage, observed usage takes precedence. Portfolio managers, risk teams, and researchers use it to group holdings, measure exposure and performance by category, and screen a universe of assets by economic function rather than by ticker.At a Glance
| Data type | Entities | Frequency / cadence | Unit | Primary endpoint | Coverage |
|---|---|---|---|---|---|
| Asset classification (reference data) | Assets | Reference data, refreshed on an ongoing basis as assets enter, leave, or are reclassified | Categorical (codes and names) | /taxonomy/assets | 🔗 |
Schema
The response returns one object per asset classification revision. An asset that has never been reclassified returns a single object. All fields are populated on every row exceptclassification_end_time, which appears only once a classification has been superseded or the asset has left the coverage universe.
Conventions. Codes are returned as JSON strings, not integers, so that leading digits are preserved. The classification time fields are served in ISO-8601 calendar-date form (
2022-11-03) rather than as full UTC timestamps, so they carry no time of day and no zone offset. Classification changes are effective from the start of the stated day. Asset names are lowercased Coin Metrics asset names, so btc rather than BTC. The code hierarchy is positional: a subsector_id of 101010 sits in sector 1010, which sits in class 10. Every classified asset belongs to exactly one subsector at any point in time.Methodology
The three levels
The taxonomy has three nested levels, and an asset is placed at the most specific one. Its class and sector follow from the code hierarchy rather than being assigned separately.
The full set of classes, sectors, and subsectors for a version is served by Asset Taxonomy Metadata.
Classification revisions and effective dates
A classification is stored as a dated revision rather than as a single mutable value. Each revision carries the version at which it was made (updated_at_taxonomy_version), the time from which it applies (classification_start_time), and, once superseded, the time at which it stopped applying (classification_end_time). An asset that has been reclassified therefore has more than one revision, each covering a distinct, non-overlapping window.
This matters for point-in-time work. classification_start_time is a property of the asset, not of the taxonomy version. An asset added to the coverage universe after a version was published carries the date it was added, not the version’s start date, so two assets in the same version routinely have different start times.
Versions and carry-forward
The taxonomy itself is versioned. Requests resolve to a version as follows:- No
versionand no time parameters: the latest version. version=<x.y>: that specific version.version=*: every version, which returns the full revision history for each asset.- A
classification_start_timeorclassification_end_timewithout an explicitversion: all versions are considered, then filtered by the time range.
Eligibility and the coverage universe
To be eligible for classification, an asset must be widely available to investors globally rather than confined to a single venue. Availability is measured against a screened universe of digital asset exchanges, and the bar to enter is higher than the bar to stay:- To enter, an asset must have traded at least once in the past 30 days on at least 25% of eligible exchanges.
- To remain classified, an already classified asset must have traded at least once in the past 30 days on at least 10% of eligible exchanges, subject to a floor of two exchanges.
Classification review
Classification decisions sit with MSCI, which administers datonomy. Coin Metrics contributes the market data behind the eligibility screening and serves the resulting classifications through this API. There is no fixed review calendar. New assets, reclassifications, and removals are each reviewed and implemented as needed, soclassification_start_time can carry any date rather than clustering on scheduled review dates. The structure itself is reviewed at least annually. Because changes are event-driven rather than periodic, treat the API as the source of truth for when a classification took effect rather than assuming a rebalance-style cadence.
Ordering and pagination
Results are ordered by asset name, then byclassification_start_time, so an asset’s revisions appear in chronological order within its own block. paging_from reverses the order. Filters on class_ids, sector_ids, and subsector_ids are applied to whichever revisions the version resolution selected, and a filter on classification_end_time matches only revisions that have actually ended.
Accessing the Data
Asset taxonomy data is served by the/taxonomy/assets endpoint. Requests are filtered by asset or by any level of the hierarchy, using assets, class_ids, sector_ids, or subsector_ids, and optionally scoped to a taxonomy version or a classification time range.
- Python Client
- Shell
- Python
next_page_token. Full parameter reference: see the API Reference for /taxonomy/assets.
Examples
Example: classification for specific assets
The current classification for three assets, one in each of three different classes. Each row carries both the numeric codes and their names, so no lookup against the metadata endpoint is required to read the result. Run this query.Example: screening a class
Filtering byclass_ids returns every asset in that branch of the hierarchy, which is the usual way to build a category universe. Note that classification_start_time differs across the rows: each asset carries the date it entered its current classification, not the date the taxonomy version was published. Run this query.
Coverage
https://coverage.coinmetrics.io/assets-v2Usage
The classified universe is the endpoint response itself: querying/taxonomy/assets with no filters returns every asset currently classified, which is the authoritative answer to what is covered.
- Build a category universe. Query by
class_ids,sector_ids, orsubsector_idsto get the asset list for a branch of the hierarchy. - Join to market or network data. The
assetfield uses standard Coin Metrics asset names, so it joins directly to/timeseries/asset-metrics,/reference-data/markets, and the rest of the API. - Aggregate by category. With the classification joined, metrics such as market capitalization or volume can be rolled up by class, sector, or subsector to measure exposure and performance by economic function.
version=* to retrieve the full revision history and use classification_start_time and classification_end_time to reconstruct which assets sat in which category on a given date. Without this, backtests inherit the current classification and pick up look-ahead bias.
Limitations
- One category per asset. An asset is assigned to exactly one subsector at a time. An asset supporting several use cases is placed in the segment that best represents its dominant usage, or in a segment defined as a platform for varied use cases. The classification is a single label, never a weighting across categories.
- Not a judgment of quality, value, or legitimacy. The classification says what an asset is used for, nothing more. It is not an endorsement, not a view on an asset’s risks or merits, and not investment advice. Categories are deliberately named to avoid terms that carry valuation connotations.
- Not a regulatory classification. Assets are not classified by regulatory status or standing, so a subsector tells you nothing about how an asset is treated in any jurisdiction.
- Not a technical classification. Two assets in the same subsector may differ completely in architecture, for example proof of work against proof of stake, or a native chain against a token hosted on another chain. Shared category means shared purpose, not shared design.
- The universe is deliberately narrow. Only assets meeting the availability thresholds are eligible, so a long tail of thinly traded assets is not classified at all. An asset missing from the response is not necessarily uncategorizable, only ineligible.
taxonomy_versionis deprecated. It is retained for backward compatibility and will be removed. Code reading the version an asset was classified at should useupdated_at_taxonomy_version.
FAQ
How do I get the list of all classes, sectors, and subsectors?
Query Asset Taxonomy Metadata at/taxonomy-metadata/assets. It returns the complete hierarchy for a taxonomy version, which is the right way to enumerate the structure rather than deriving it from the assets currently classified.
What is the difference between taxonomy_version and updated_at_taxonomy_version?
They currently carry the same value, but taxonomy_version is obsolete and scheduled for removal. updated_at_taxonomy_version is the supported field and records the taxonomy version at which the asset was last classified or reclassified.
Why does classification_start_time differ between assets in the same version?
Because it records when that particular asset entered its current classification, not when the taxonomy version was published. An asset added to the universe after the version went live carries its own addition date.
How do I see an asset’s classification history?
Passversion=*. This returns every revision for the asset, each with its own classification_start_time and, where the revision has ended, a classification_end_time.
Why is an asset I track missing?
Most likely it has not met the entry threshold, which requires a trade in the past 30 days on at least 25% of eligible exchanges. Assets already classified are held to a lower bar of 10% (minimum two exchanges), so an asset can stay in the taxonomy on coverage that would not have got it in.How often do classifications change?
There is no fixed schedule. Additions, reclassifications, and removals are reviewed and applied as needed rather than on a rebalance cycle, so changes can land on any date. The structure of classes, sectors, and subsectors is reviewed at least annually, and material changes to it go through a public consultation first.Does the classification reflect what a project says it does, or what it is actually used for?
It starts from the primary use the protocol’s creators describe, but where stated intent differs materially from market perception and observed usage, observed usage takes precedence.Related
- datonomy Overview: what datonomy is, how the hierarchy is structured, and how the pieces fit together.
- Asset Taxonomy Metadata: the full class, sector, and subsector structure for a taxonomy version.
- datonomy Methodology: the published classification methodology.
- Asset Profiles: descriptive reference data for the same assets.

