Data Encyclopedia
HomeCharts
  • Welcome & Product Overview
  • Getting Started
  • Tutorials and Examples
    • Tutorials
      • Python API Client Walkthrough
      • Getting Started With Market Data
      • Getting Started With Futures Data
      • Aggregating Options Data
      • Examining Orderbook Depth
      • Aggregating Orderbook Depth to Create Liquidity Metrics
      • Comparing Stablecoin Prices Using Different Pricing Methods
      • Comparing Volumes of Exchanges and Assets
      • Creating Custom Network Data Metrics Using ATLAS
      • Applying Different Types of Marketcap Metrics
      • Comparing the Dominance of Mining Pools Using ATLAS
      • Using Staking Metrics to Get Yield and Staked Supply
      • Granular Insights On Chain Using Hourly Network Data Metrics
      • Exploring Options, Open Interest, and Volatility Data
      • Calculating Total Value Locked in Liquidity Pools using DEX Data
      • Calculating DEX Liquidity Pool Fees and Volumes
      • Analyzing DeFi Protocol Balance Sheets
    • How To Guides
      • How To Export Data
      • How To Migrate From Catalog to Catalog V2 and Reference Data
      • How To Use the Coin Metrics API Efficiently
    • Dashboard Examples
  • Packages
    • CM Labs
    • Coin Metrics Community Data
  • Access Our Data
    • API Reference
    • API Conventions
      • Catalog V1 to Catalog V2 Migration
    • Python API Client
    • R API Client
    • Coverage
    • Status Page
  • Data Visualization
    • Charting Tool
      • Formula Builder
      • Correlation Tool
      • Embedded Charts
      • Troubleshooting
    • Dashboard
      • Troubleshooting
    • CMTV Charts (Labs)
      • Troubleshooting
    • Atlas Explorer
  • Network Data
    • Network Data Pro Overview
      • Availability
        • Asset Completion Time
      • Addresses
        • Active Addresses
        • Address Balances
        • New Addresses
      • Economics
        • Mining
        • Valuation
      • Exchange
        • Deposits
        • Exchange Supply
        • Net Flows
        • Transaction Count
        • Withdrawals
      • Fees and Revenue
        • Fees
        • Revenue
      • Market
        • Market Capitalization
        • Price
        • Profitability
        • Returns
        • Volatility
      • Key Risk Indicator (KRI) Feed
        • Blocks
        • Block Attributes
        • Block Size
        • Block Times
        • Empty Blocks
        • Fees
        • Outputs
        • Rewards
        • Feerates
        • Hashrate
        • Transaction Feerates
        • Transaction Fees
        • Transaction Sizes
        • Transactions
      • Mining
        • Balances
        • Difficulty
        • Exchange Flows
        • Flows
        • Hardware Hash Rate
        • Hash Rate
      • Network Usage
        • Blocks
        • Contracts
        • Profitability
        • UTXOs
        • Blobs
      • Staking
        • Consensus Health
        • Flows
        • Penalty Metrics
        • Slashing Metrics
        • Validator Supply
        • Stakers
        • Yield
      • Supply
        • Active Supply
        • Addresses with Balance
        • Burnt Supply
        • Current Supply
        • Free Float Supply
        • Future Expected Supply
        • Miner Revenue
        • Profitability
        • Revived Supply
        • Shielded Supply
        • Supply Issuance
        • Staking Supply
      • Transactions
        • Blobs
        • Contracts
        • Token Transactions
        • Transactions
        • Transfer Value
        • Transfers
        • Velocity
      • Wallets
        • Active Wallets
        • Wallet Balances
    • Atlas Overview
      • Accounts
      • Account Balance
      • Blocks
        • Full Block
      • Transactions
        • Full Transaction
          • Full Transaction Info for Block
      • Balance Updates
    • Methodologies
      • Normalizing Block Times
    • DeFi Overview
      • Decentralized Exchange Data
      • DeFi Balance Sheets
      • DeFi FAQs
    • Tagging Meta Data
    • Transaction Tracker
    • CM Labs
      • Mining Pool Monitor Overview
        • Mining Pool Monitor API Fields
      • Reorg & Fork Tracker Overview
        • Reorg & Fork Tracker Tracker API Fields
    • Deprecated
      • Mempool Monitor
      • WatchTower Alerts Overview - DEPRECATED
        • WatchTower Alerts - DEPRECATED
          • Ethereum Proof-of-Stake Alerts - DEPRECATED
            • Missed Slot Alert - DEPRECATED
            • Fast Increase in Transaction Count Alert - DEPRECATED
            • Fast Decrease in Transaction Count Alert - DEPRECATED
            • Fast Decrease in Base Fees - DEPRECATED
            • Fast Increase in Base Fees - DEPRECATED
            • Fast Decrease in Priority Fees (Tips) Alert - DEPRECATED
            • Fast Increase in Priority Fees (Tips) Alert - DEPRECATED
            • Decrease in Active Addresses Alert - DEPRECATED
            • Increase in Active Addresses Alert - DEPRECATED
            • Decrease in Total Block Fees Alert - DEPRECATED
            • Increase in Total Block Fees Alert - DEPRECATED
          • DeFi Alerts - DEPRECATED
            • Smart Contract Admin Change Alert - DEPRECATED
            • Admin Change with Issuance Event Alert - DEPRECATED
            • Admin Change with Large Issuance Event Alert - DEPRECATED
          • Mining Alerts - DEPRECATED
            • Unknown Miner Predominance Alert - DEPRECATED
            • Mining Pool Conflict Alert - DEPRECATED
            • Persistent Mining Pool Conflict Alert - DEPRECATED
            • Hashrate Decrease Alert - DEPRECATED
            • 1-Block Difficulty Decrease - DEPRECATED
          • Blockchain Alerts - DEPRECATED
            • 1 Block Reorg Alert - DEPRECATED
            • 2 Block Reorg Alert - DEPRECATED
            • 3 Block Reorg Alert - DEPRECATED
            • Satoshi Coins Spent - DEPRECATED
            • Vintage Coins Spent - DEPRECATED
            • Slow Block Alert - DEPRECATED
            • 1 Consecutive Empty Block Alert - DEPRECATED
            • 2 Consecutive Empty Blocks Alert - DEPRECATED
            • 3 Consecutive Empty Blocks Alert - DEPRECATED
            • 6 Consecutive Empty Blocks Alert - DEPRECATED
          • Mempool Alerts - DEPRECATED
            • Mempool Disruption Alert - DEPRECATED
            • Mempool Size 90% Alert - DEPRECATED
            • Mempool Size 95% Alert - DEPRECATED
            • Mempool Size 99% Alert - DEPRECATED
            • Mempool Size 100% Alert - DEPRECATED
            • Mempool Congestion Alert - DEPRECATED
        • WatchTower API Fields - DEPRECATED
    • Network Data Glossary
    • Network Data FAQs
  • Market Data
    • Market Data Overview
      • Basis
      • Candles
      • Contract Prices
      • Funding Rates
        • Funding Rates
        • Predicted Funding Rates
        • Aggregated Futures Funding Rate
        • Cumulative Futures Funding Rate
      • Greeks
      • Institution Metrics
        • Grayscale
          • Shares Outstanding
          • Market Price
          • Net Asset Value
          • Coin Per Share
          • Total Assets
      • Liquidations
        • Market Level Liquidations
        • Liquidation Metrics
      • Liquidity
        • Bid-Ask Spread Percent
        • Order Book Depth
        • Slippage
      • Market Metadata
      • Open Interest
        • Market Level Open Interest
        • Reported Open Interest
      • Orderbooks
      • Quotes
      • Trades
      • Volatility
        • Market Implied Volatility
        • Implied Volatility
        • Realized Volatility
      • Volume
        • Trusted Volume
        • Reported Volume
    • CM Prices
      • Reference Rate
      • Principal Market Price (USD)
      • Principal Market (USD)
    • Methodologies
      • Coin Metrics Prices Policies
      • Coin Metrics Prices Methodology
      • Trusted Exchange Framework
    • Market Data FAQs
      • CM Prices FAQs
      • Trusted Exchange Framework FAQs
  • Index Data
    • Index Overview
      • Index Timeseries
        • Index Levels
        • Index Candles
        • Index Constituents
    • Policies & Charters
      • CMBI Index Policies
      • Governance Committees
    • Methodologies
      • Fork Legitimacy Framework
      • Adjusted Free Float Supply Methodology
      • Candidate Market Guidelines
    • Fact Sheets
      • CMBI Single Asset Series Fact Sheet
      • CMBI Multi Asset Series Fact Sheet
      • CMBI Total Market Series Fact Sheet
      • CMBI Mining Series Fact Sheet
    • Indexes Glossary
    • Index FAQs
  • Reference Data
    • datonomy Overview
      • Taxonomy for Assets
      • Taxonomy Metadata for Assets
      • datonomy FAQs
    • Profiles Overview
      • Asset Profiles
      • Network Profiles
    • Security Master Overview
      • Assets
      • Markets
    • Methodologies
      • Guiding Principles and Methodology for datonomy
  • BITTENSOR
    • Precog Methodology
      • Point Forecast Ranking
      • Interval Forecast Ranking
      • Interval Score Examples
      • Miner Weight from Rank
Powered by GitBook
On this page
  • Definition
  • Details
  • Endpoint Response
  • Example
  • Release History

Was this helpful?

  1. Reference Data
  2. Profiles Overview

Asset Profiles

/profile/assets

PreviousProfiles OverviewNextNetwork Profiles

Last updated 3 months ago

Was this helpful?

Definition

The asset profiles provide a descriptive overview of an asset.

Details

For more information on the asset profiles see the .

Endpoint Response

The profile/assets endpoint returns a profile for each asset. The response is formatted as follows:

Field
Description

asset

Asset symbol

full_name

Asset name

description

Description of key features

overview

Description of key features and an overview of how the asset solves the problem for which it was created.

token_purpose

A list of the main purposes for the asset. For example if the token is a fee token on a network, or if it is a stablecoin or governance token.

project_team

Name of the project team supporting the asset

foundation

Name of the foundation supporting the asset

website

Link to project website (if omitted, then no official website for the project was found)

whitepaper_url

Link to whitepaper URL (if omitted, then no official whitepaper URL was found)

creation_date

Genesis block or first included block

token_generation_event_supply

Total supply of the token minted at genesis

supply_cap

The max number of coins programmed to exist in the lifetime of a cryptoasset (if omitted, then supply is uncapped/unlimited/infinite)

initial_supply_token_distribution

Overview of the initial allocation of tokens if available. Includes the receiving entity as well as the amount received.

vesting_schedule

Overview of vesting schedules disclosed by the project. Includes the entity who has a vesting schedule, the cliff as well as the total unlock time.

new_token_issuance_recipient

Recipient of newly issued tokens if available. If tokens are distributed to a set type of recipients like miners or validators, those will be listed here.

issuing_networks

Which networks is the asset natively issued on (i.e.: not bridged or wrapped)

bridged_networks

Which network is the asset bridged to. This includes bridging to other chains via wrapping (e.g.: btc is bridged to ethereum via wrapping as wbtc)

issuance_schedule_changes

Any changes that have occurred to the issuance schedule of the asset.

significant_historical_changes

Any significant historical changes that have occurred with the asset or project.

upgrade_history

Upgrades that have been made to the asset or project.

blog_updates

Link to the blog where the project posts updates.

project_github_repository

Link to relevant github repositories for the project.

asset_regulation

If the project is regulated, how it is regulated (Indirectly vs Directly). Indirect regulation could be via something like an ETP (e.g.: BTC spot ETF) while directly is if any clear regulatory guidance has been provided (e.g.: via MICA in the EU)

asset_regulated_products

Which regulated products have been released for the asset (e.g.: ETPs and ETFs)

etp_custodians

Who are the known custodians for the underlying asset for ETPs.

Example

A sample of the asset profile response for btc is shown below.

{
    "data": [
        {
            "asset": "btc",
            "full_name": "Bitcoin",
            "description": "Bitcoin is a peer-to-peer network that facilitates transfers between network participants without any central authority.",
            "overview": "Bitcoin (BTC) is a value transfer token and the first peer-to-peer cryptocurrency operating without central authority. Using blockchain technology, it maintains a distributed ledger of transactions, validated by miners through a Proof-of-Work mechanism. In Proof-of-Work, miners exert computational energy to race to propose a block to the network. Miners who successfully add a block to the chain are rewarded with newly issued BTC and fees from transactions in the block. Transactions follow an Unspent Transaction Output or UTXO model to individually track the smallest unit of BTC. The smallest unit is equal to 1.0 x 10-8 BTC or 1 satoshi. Key features of the network include a fixed supply of 21 million BTC that is issued at a decreasing rate every four years, cryptographic security, and support for second-layer solutions like the Lightning Network.",
            "creation_date": "2009-01-01",
            "token_purpose": [
                "Store of Value Token",
                "Fee Token"
            ],
            "project_team": "Bitcoin Core Developers",
            "website": "https://bitcoin.org/en/",
            "whitepaper_url": "https://bitcoin.org/bitcoin.pdf",
            "token_generation_event_supply": "N/A",
            "supply_cap": "21000000",
            "initial_supply_token_distribution": [
                {
                    "initial_supply_allocation": "N/A",
                    "initial_supply_distribution": "N/A"
                }
            ],
            "vesting_schedule": [
                {
                    "vesting_schedule_allocation": "N/A",
                    "vesting_schedule_cliff": "N/A",
                    "vesting_schedule_total_unlock_time": "N/A"
                }
            ],
            "new_token_issuance_recipient": [
                "Miner"
            ],
            "issuing_networks": [
                "Bitcoin"
            ],
            "bridged_networks": [
                "Ethereum",
                "Lightning Network",
                "Stax",
                "BOB Network",
                "Arbitrum",
                "OP Mainnet",
                "Base",
                "Worldchain",
                "Avalanche C-Chain",
                "Kava",
                "Osmosis",
                "Polygon PoS"
            ],
            "issuance_schedule_changes": "Bitcoin issuance rewards halve every 210,000 blocks or about 4 years. BTC issuance began at 50 BTC per block and is currently at 3.125 BTC per block. The latest halving was at block 840,000 with the next halving at block 1,050,000.",
            "significant_historical_changes": [
                {
                    "date": "2008-10-31",
                    "details": "BTC Whitepaper published"
                },
                {
                    "date": "2009-01-03",
                    "details": "First BTC Block:'Chancellor on brink of second bailout for banks'"
                },
                {
                    "date": "2010-05-22",
                    "details": "BTC Pizza Transaction"
                },
                {
                    "date": "2010-07-18",
                    "details": "MtGox is announced"
                },
                {
                    "date": "2010-07-25",
                    "details": "Consensus change to follow chain with most work"
                },
                {
                    "date": "2010-08-15",
                    "details": "Overflow block is reorged out after Satoshi releases fix and adivses to the re-org"
                },
                {
                    "date": "2010-12-12",
                    "details": "Final post from Satoshi on bitcointalk.org"
                },
                {
                    "date": "2011-06-19",
                    "details": "MtGox is hacked"
                },
                {
                    "date": "2011-08-19",
                    "details": "First Bitcoin Improvement Proposal (BIP)"
                },
                {
                    "date": "2012-04",
                    "details": "BIP-16 P2SH"
                },
                {
                    "date": "2012-11-29",
                    "details": "First BTC halving"
                },
                {
                    "date": "2013-01-31",
                    "details": "First ASICs are shipped"
                },
                {
                    "date": "2013-09",
                    "details": "144k BTC from Silk Road are confiscated"
                },
                {
                    "date": "2014-02-07",
                    "details": "Mt. Gox halts BTC withdrawals declares bankruptcy by end of month"
                },
                {
                    "date": "2014-03-19",
                    "details": "OP_RETURN is introduced"
                },
                {
                    "date": "2015-02",
                    "details": "Lightning Whitepaper is published"
                },
                {
                    "date": "2016-02-03",
                    "details": "BIP2 which defines the BIP process"
                },
                {
                    "date": "2016-07-10",
                    "details": "Second halving"
                },
                {
                    "date": "2017-07-20",
                    "details": "BIP 91 (SegWit) activation is locked in"
                },
                {
                    "date": "2017-08-24",
                    "details": "SegWit goes live"
                },
                {
                    "date": "2018-09",
                    "details": "CVE-2018-17144 is discovered that would have allowed attackers to crash bitcoin nodes and exceed the 21 million coin limit"
                },
                {
                    "date": "2020-05-16",
                    "details": "Thid bitcoin halving"
                },
                {
                    "date": "2024-01-10",
                    "details": "First Bitcion Spot ETFs approved in the USA"
                },
                {
                    "date": "2024-04-20",
                    "details": "Fourth bitcoin halving"
                }
            ],
            "upgrade_history": [
                {
                    "date": "2011-08-19",
                    "details": "First Bitcoin Improvement Proposal (BIP)"
                },
                {
                    "date": "2012-04",
                    "details": "BIP-16 P2SH"
                },
                {
                    "date": "2012-11-29",
                    "details": "First BTC halving"
                },
                {
                    "date": "2016-02-03",
                    "details": "BIP2 which defines the BIP process"
                },
                {
                    "date": "2016-07-10",
                    "details": "Second halving"
                },
                {
                    "date": "2017-07-20",
                    "details": "BIP 91 (SegWit) activation is locked in"
                },
                {
                    "date": "2017-08-24",
                    "details": "SegWit goes live"
                },
                {
                    "date": "2020-05-16",
                    "details": "Thid bitcoin halving"
                },
                {
                    "date": "2024-04-20",
                    "details": "Fourth bitcoin halving"
                }
            ],
            "blog_updates": "N/A",
            "project_github_repository": [
                "https://github.com/bitcoin"
            ],
            "asset_regulation": "Indirectly",
            "asset_regulated_products": [
                "Bitcoin Spot ETFs"
            ],
            "etp_custodians": [
                "Coinbase Custody Trust Company, LLC",
                "Fidelity Digital Asset Services, LLC",
                "Gemini Trust Company, LLC",
                "Bitgo Trust Company, Inc.",
                "Komainu (Jersey) Limited"
            ]
        }
    ]
}

Release History

  • Version 1.0 on January 30, 2023: Release of initial version of the asset profiles

profiles overview