> For the complete documentation index, see [llms.txt](https://gitbook-docs.coinmetrics.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook-docs.coinmetrics.io/reference-data/profiles-overview.md).

# Profiles Overview

## Overview

Profiles are the narrative layer of Coin Metrics reference data. Other reference data endpoints return identifiers, attributes, and other data points that code can act on directly. Profiles carry the information behind them, in prose: why an asset exists, who builds it, how its supply came about, and what kind of network it settles on, as well as other reference points like the maximum supply or the teams behind a project. Every field is written and reviewed by analysts from primary sources, which makes profiles a stable descriptive layer to attach to quantitative work.

## Assets and networks

[**Asset Profiles**](/reference-data/profiles-overview/asset-profiles.md) describe a cryptoasset. Every asset profile carries an identifier, a full name, a short description, a longer overview, a creation date, and, where they exist, a website, a whitepaper, and a supply cap. A subset of assets is curated more deeply and also carries token purpose, project team and foundation, supply generation and vesting detail, issuing and bridged networks, event and upgrade history, and regulatory status including exchange-traded products and their custodians.

[**Network Profiles**](/reference-data/profiles-overview/network-profiles.md) describe a blockchain network. They carry an identifier and full name, an overview, the consensus mechanism, hashing algorithm, transaction finality, available node clients, smart contract deployment model, architecture and scaling classification, rollup characteristics where the network is one, the supporting foundations and repositories, and the network's upgrade history.

The two are separate namespaces that overlap without being interchangeable. Some identifiers coincide (`btc` is both an asset and a network), some do not (the network `pol_pos` has no asset of that name), and the network names inside an asset profile are display names such as `Avalanche C-Chain` rather than the `avaxc` identifier a network profile uses.

## Curation and release

Analysts research each profile from primary sources: project websites, whitepapers, specifications and improvement proposals, public repositories, foundation publications, and regulatory filings. Where a project's own material is ambiguous or silent, a field is left uncurated rather than inferred.

A field can carry no information in two ways, and they mean different things. A field that is **absent** from the response is one that either cannot be commented on or has not yet been researched for that project. A field returning **`N/A`** has been researched, and analysts have concluded it is not applicable to that asset or network. Neither state is permanent, and both are revisited and can be amended in later releases.

Changes go through review before they are merged, and are validated against a published schema before they can be released, so a release cannot introduce a malformed profile or silently rename a field.

Profiles are published in discrete releases rather than updated continuously. The API serves a pinned version of the profile dataset, and a release replaces it wholesale. Between releases the response is stable, which makes profiles safe to cache and safe to diff. There is no fixed schedule: releases go out when a batch of new profiles or revisions is ready, and each one is recorded in the [change log](#change-log) below.

Two consequences are worth planning around. A newly launched asset does not appear the moment it starts trading, and a change in a project's circumstances is reflected at the next release rather than immediately.

## Coverage

Profiles are not published on coverage.coinmetrics.io, and unlike the metric datasets they have no catalog endpoint either. Availability is read from the profile endpoints themselves instead, each of which returns everything it covers when queried with no filters. This is the authoritative list, and it stays current across releases.

* [`/profile/assets`](https://docs.coinmetrics.io/api/v4/#operation/getAssetProfiles): every asset with a profile.
* [`/profile/networks`](https://docs.coinmetrics.io/api/v4/#operation/getNetworkProfiles): every covered network.

{% tabs %}
{% tab title="Python Client" %}

```python
import os
from coinmetrics.api_client import CoinMetricsClient

client = CoinMetricsClient(os.environ["CM_API_KEY"])

assets = client.get_asset_profiles().to_list()
networks = client.get_network_profiles().to_list()

print(sorted(a["asset"] for a in assets))
print(sorted(n["network"] for n in networks))
```

{% endtab %}

{% tab title="Shell" %}

```shell
curl --compressed "https://api.coinmetrics.io/v4/profile/assets?page_size=10000&api_key=$CM_API_KEY"
curl --compressed "https://api.coinmetrics.io/v4/profile/networks?page_size=10000&api_key=$CM_API_KEY"
```

{% endtab %}
{% endtabs %}

Asset profile coverage is a subset of the assets Coin Metrics covers elsewhere, and network profile coverage is narrower still. An asset with market or network data does not necessarily have a profile, and a network named inside an asset profile does not necessarily have a profile of its own. Access to profiles is entitled separately from other datasets, so a key without the entitlement receives an authorization error rather than an empty result.

## API Endpoints

{% content-ref url="/pages/lJMF8Jl9M0XBeGO2KyuO" %}
[Asset Profiles](/reference-data/profiles-overview/asset-profiles.md)
{% endcontent-ref %}

{% content-ref url="/pages/q5P8XeQPXvvYC9TGZAQW" %}
[Network Profiles](/reference-data/profiles-overview/network-profiles.md)
{% endcontent-ref %}

## Related

* [Asset Profiles](/reference-data/profiles-overview/asset-profiles.md): descriptions of cryptoassets, at `/profile/assets`.
* [Network Profiles](/reference-data/profiles-overview/network-profiles.md): descriptions of blockchain networks, at `/profile/networks`.
* [Asset Taxonomy](/reference-data/datonomy-overview/asset-taxonomy.md): the datonomy classification of the same assets, as codes and names rather than prose.

## Change Log

{% updates format="full" %}
{% update date="2026-08-24" %}

## Asset Profiles - Added TBILL, VBILL, HYPE and updated USDP

Added TBILL, VBILL, and HYPE to Asset Profiles endpoint and updated USDP metadata. Full details below.

<details>

<summary>Full Details</summary>

1. TBILL Asset Profile
   * Includes:
     * Overview, Token Purpose, Project Team
     * Website, Whitepaper, Creation Date
     * New Token Issuance Recipient
     * Issuing Networks, Issuance Schedule Changes
     * Significant Historical Changes, Upgrade History
     * Blog, Github Repository
     * Asset Regulation
2. VBILL Asset Profile
   * Includes:
     * Overview, Token Purpose, Project Team
     * Website, Creation Date
     * New Token Issuance Recipient
     * Issuing Networks, Issuance Schedule Changes
     * Blog
     * Asset Regulation
3. HYPE Asset Profile
   * Includes:
     * Overview, Token Purpose, Project Team, Foundation
     * Website, Whitepaper, Creation Date, Token Generation Event Supply
     * Supply Cap, Initial Supply Allocation, Distribution, Vesting Schedule, Vesting Cliff, Total Unlock Time
     * Issuing Networks, Issuance Schedule Changes
     * Significant Historical Changes, Upgrade History
     * Blog, Github Repository
     * Asset Regulation, Asset Regulated Products, ETP Custodians
4. USDP Asset Update
   * Added Significant Historical Changes on regulatory oversight
   * Added Upgrade History token availability on select networks
   * Reassigned Regulation from NYDFS to OCC

</details>
{% endupdate %}

{% update date="2026-08-18" %}

## Asset Profiles - Added JTRSY, FDIT, FIDD and Updated Regulations

Added JTRSY, FDIT, and FIDD to Asset Profiles endpoint. Updated regulation information of BUIDL, BENJI, USYC. Full details below.

<details>

<summary>Full Details</summary>

1. JTRSY Asset Profile

* Includes:
  * Overview, Token Purpose, Project Team
  * Website, Whitepaper, Creation Date
  * New Token Issuance Recipient
  * Issuing Networks, Issuance Schedule Changes
  * Significant Historical Changes, Upgrade History
  * Blog
  * Asset Regulation

2. FDIT Asset Profile

* Includes:
  * Overview, Token Purpose, Project Team
  * Website, Whitepaper, Creation Date
  * New Token Issuance Recipient
  * Issuing Networks, Issuance Schedule Changes
  * Blog
  * Asset Regulation

3. FIDD Asset Profile

* Includes:
  * Overview, Token Purpose, Project Team
  * Website, Whitepaper, Creation Date
  * New Token Issuance Recipient
  * Issuing Networks, Issuance Schedule Changes
  * Significant Historical Changes
  * Blog, Github Repository

4. BUIDL Asset Update

* Updated Asset Regulation from "Directly" to "Indirectly"
* Removed "U.S. Securities & Exchange Commission" from Asset Regulated Products

5. BENJI Asset Update

* Updated Asset Regulation from "Directly" to "Indirectly"
* Removed "U.S. Securities & Exchange Commission" from Asset Regulated Products

6. USYC Asset Update

* Updated Asset Regulation from "Directly" to "Indirectly"
* Removed "Bermuda Digital Asset Business Act 2018 (Class F License)" and "Cayman Islands Mutual Funds Act (Hashnote International Short Duration Yield Fund Ltd.)" from Asset Regulated Products

</details>
{% endupdate %}

{% update date="2026-08-12" %}

## Asset Profiles - Added MORPHO, USDY, GOOGLON

Added MORPHO, USDY, GOOGLON to Asset Profiles endpoint. Full details below.

<details>

<summary>Full Details</summary>

1. Morpho Asset Profile
   * Includes:
     * Overview, Token Purpose, Project Team, Foundation
     * Website, Whitepaper, Creation Date, Token Generation Event Supply
     * Supply Cap, Initial Supply Allocation, Distribution, Vesting Schedule, Vesting Cliff, Total Unlock Time
     * Issuing Networks, Bridged Networks, Issuance Schedule Changes
     * Significant Historical Changes, Upgrade History
     * Blog, Github Repository
     * Asset Regulation, Asset Regulated Products, ETP Custodains
2. USDY Asset Profile
   * Includes:
     * Overview, Token Purpose, Project Team, Foundation
     * Website, Whitepaper, Creation Date
     * New Token Issuance Recipient, Issuing Networks, Issuance Schedule Changes
     * Significant Historical Changes, Upgrade History
     * Blog
     * Asset Regulation
3. GOOGLON Asset Profile
   * Includes:
     * Overview, Token Purpose, Project Team, Foundation
     * Website, Whitepaper, Creation Date
     * New Token Issuance Recipient, Issuing Networks, Issuance Schedule Changes
     * Significant Historical Changes, Upgrade History
     * Blog
     * Asset Regulation

</details>
{% endupdate %}

{% update date="2026-08-04" %}

## Asset Profiles - Added Assets

Added BUIDL, BENJI, USYC, STETH, AAPLX, EURT, and NVDAX to Asset Profiles endpoint. Full details below.

<details>

<summary>Full Details</summary>

1. BUIDL Asset Profile

* Includes:
  * Overview, Token Purpose, Project Team
  * Website, Whitepaper, Creation Date
  * New Token Issuance Recipient
  * Issuing Networks, Issuance Schedule Changes
  * Upgrade History
  * Blog
  * Asset Regulation

2. BENJI Asset Profile

* Includes:
  * Overview, Token Purpose, Project Team
  * Website, Whitepaper, Creation Date
  * New Token Issuance Recipient
  * Issuing Networks, Issuance Schedule Changes
  * Significant Historical Changes
  * Upgrade History
  * Blog
  * Asset Regulation

3. USYC Asset Profile

* Includes:
  * Overview, Token Purpose, Project Team
  * Website, Whitepaper, Creation Date
  * New Token Issuance Recipient
  * Issuing Networks, Issuance Schedule Changes
  * Significant Historical Changes
  * Upgrade History
  * Blog
  * Asset Regulation

4. STETH Asset Profile

* Includes:
  * Overview, Token Purpose, Project Team
  * Website, Whitepaper, Creation Date
  * New Token Issuance Recipient
  * Issuing Networks, Bridged Networks, Issuance Schedule Changes
  * Significant Historical Changes
  * Upgrade History
  * Blog, Github Repository
  * Asset Regulation, Asset Regulated Products, ETP Custodians

5. AAPLX Asset Profile

* Includes:
  * Overview, Token Purpose, Project Team
  * Website, Whitepaper, Creation Date
  * New Token Issuance Recipient
  * Issuing Networks, Issuance Schedule Changes
  * Significant Historical Changes
  * Upgrade History
  * Blog, Github Repository
  * Asset Regulation

6. EURT Asset Profile

* Includes:
  * Overview, Token Purpose, Project Team
  * Website, Whitepaper, Creation Date
  * New Token Issuance Recipient
  * Issuing Networks, Issuance Schedule Changes
  * Significant Historical Changes
  * Upgrade History
  * Blog

7. NVDAX Asset Profile

* Includes:
  * Overview, Token Purpose, Project Team
  * Website, Whitepaper, Creation Date
  * New Token Issuance Recipient
  * Issuing Networks, Issuance Schedule Changes
  * Significant Historical Changes
  * Upgrade History
  * Blog, Github Repository
  * Asset Regulation

</details>
{% endupdate %}

{% update date="2026-03-18" %}

## Asset Profiles - Added EURC and Updated USDC

Added EURC to Asset Profiles endpoint and updated USDC official name. Full details below.

<details>

<summary>Full Details</summary>

1\. EURC Asset Profile

* Includes:
  * Overview, token purpose, project team
  * Website, Whitepaper, Creation Date
  * New Token Issuance Recipient
  * Issuing Networks
  * Significant Historical Changes, Upgrade History
  * Blog
  * Asset Regulation Status

2\. USDC Asset Updates

* Updated official name from "USD Coin" to "USDC"
* Updated description and overview to reflect new name
* Added significant historical change: "USD Coin officially renamed to USDC" (September 22, 2023)

</details>
{% endupdate %}

{% update date="2026-02-13" %}

## Asset Profiles - Added Stablecoins

Added RLUSD, USDCV, USD0, and USD1 to Asset Profiles endpoint and made adjustments to USDC regulations and XLM upgrade history. Full details below.

<details>

<summary>Full Details</summary>

1. RLUSD Asset Profile

* Includes:
  * Overview, token purpose, project team
  * Website, Whitepaper, Creation Date
  * New Token Issuance Recipient
  * Issuing Networks
  * Significant Historical Changes, Upgrade History
  * Blog
  * Asset Regulation Status

2\. USDCV Asset Profile<br>

* Includes:
  * Overview, token purpose, project team
  * Website, Whitepaper, Creation Date
  * New Token Issuance Recipient
  * Issuing Networks
  * Upgrade History
  * Blog
  * Asset Regulation Status

3\. USD0 Asset Profile

* Includes:
  * Overview, token purpose, project team
  * Website, Whitepaper, Creation Date
  * New Token Issuance Recipient
  * Issuing Networks
  * Significant Historical Changes, Upgrade History
  * Blog

4\. USD1 Asset Profile

* Includes:
  * Overview, token purpose, project team
  * Website, Whitepaper, Creation Date
  * New Token Issuance Recipient
  * Issuing Networks
  * Upgrade History
  * Blog

5\. USDC Asset Regulation

* Added USDC regulated by GENIUS Act

6\. Stellar Upgrade History

* Protocol 25 or X-Ray Upgrade added to XLM (January 22)

</details>
{% endupdate %}

{% update date="2026-01-29" %}

## Network Profiles - Added BNB Smart Chain

Added BNB Smart Chain to Network Profiles endpoint and made some smaller changes to Flow, Solana and Ethereum. Full details below.

<details>

<summary>Full Details</summary>

1\. New BNB Smart Chain (BSC) Network Profile

* Added network profile for BNB Smart Chain (bsc)
* Includes:
  * Overview, consensus protocol, hashing algorithm
  * Available clients
  * Foundation information
  * Repository links
  * Significant Historical Changes
  * Upgrade History: 9 upgrades documented

2\. Flow Network Updates

* Added significant historical change entry.

3\. Solana Network Updates

* **Fixed typo:** Changed "mostlh theoretical" to "mostly theoretical" in overview

4\. Ethereum Network Updates

* **Fixed typo:** "get" to "geth" in github\_repository

</details>
{% endupdate %}
{% endupdates %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://gitbook-docs.coinmetrics.io/reference-data/profiles-overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
