Asset profiles data (experimental)

Returns profile data for assets. Results are ordered by asset. To fetch the next page of results use next_page_url JSON response field. If supply_cap is not present then the theoretical maximum supply is infinite for that asset.

get

Authorizations

api_keystringRequired

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

Query parameters

assetsstring[]Optional

Comma separated list of asset ids.
By default profile data for all assets is returned. Mutually exclusive with full_names parameter.

full_namesstring[]Optional

Comma separated list of asset full names.
By default profile data for all assets is returned. Mutually exclusive with assets parameter.

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

Asset profiles data.

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/profile/assets

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

{
  "data": [
    {
      "asset": "eth",
      "full_name": "Ethereum",
      "description": "Ethereum is a decentralized computing platform that allows users to create, deploy and interact with programs known as smart contracts.",
      "overview": "Ethereum is a decentralized computing platform that allows users to create, deploy and interact with programs known as smart contracts. Ethereum is a transaction based state machine, meaning that at any point in time the state of the Ethereum network is represented by a mapping of accounts to their associated balance or state. The state of the Ethereum network is updated every time a new block is added to the chain, roughly every 12 seconds. Each block contains information regarding new transactions and is linked to the previous block. The ETH 1.0 chain used a proof-of-work consensus protocol similar to the one implemented by Bitcoin. However, in September 2022 Ethereum transitioned to a new proof-of-stake consensus mechanism that will help reduce fees and increase speed. In a proof-of-stake network, validators stake ETH capital (32 ETH) in a smart contract as a deterrent to act dishonestly. Validators in the network are responsible for validating blocks sent into the network, and creating new blocks when directed. Ethereum also has the capability for users to create smart contracts that are written in a high level language, compiled into bytecode and sent to a contract. The Ethereum Virtual Machine handles all of the bytecode and imposes the coded logic. Smart contracts allow developers to impose logic and rules upon interactions, ultimately creating a product that provides value on the chain. Examples of products built on Ethereum include Aave, a lending platform, and Livepeer, a video streaming infrastructure. Ethereum also provides the framework to create many different types of assets with rules. Examples of popular smart contracts include ERC-20, a framework to create tokens on Ethereum, or ERC-721, a framework for NFTs. Users can interact with smart contracts once they have been deployed allowing for the creation of decentralized applications and additional use cases.",
      "creation_date": "2015-07-30",
      "token_purpose": [
        "Fee Token",
        "Staking Token"
      ],
      "project_team": "N/A",
      "foundation": "Ethereum Foundation",
      "website": "https://ethereum.org/en/",
      "whitepaper_url": "https://ethereum.org/en/whitepaper/#ethereum-whitepaper",
      "token_generation_event_supply": 72009990.5,
      "supply_cap": "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": [
        "Validator"
      ],
      "issuing_networks": [
        "Ethereum"
      ],
      "issuance_schedule_changes": "Ethereum issuance when using Proof-of-Work began at 5 ETH per block, lowering to 3 ETH per block after the Byzantium fork in October 2017, and again to 2 ETH per block after the Constantinople fork in February 2019. After the merge and Ethereum's migration to Proof-of-Stake, ETH is issued by calculating 166 times the square root of the sum of staked ETH. ETH issuance fluctuates consistently depending on the amount staked and amount of ETH participating in each epoch, overall decreasing when more ETH is staked.",
      "significant_historical_changes": [
        {
          "date": "2016-06-17",
          "details": "Ethereum DAO was hacked for $50 million"
        },
        {
          "date": "2021-09-15",
          "details": "EIP-1559 was introduced restructuring the fee market and introducing a variable base fee that is burned"
        },
        {
          "date": "2024-03-13",
          "details": "Ethereum migrated from Proof-of-Work to Proof-of-Stake completing the merge"
        }
      ],
      "upgrade_history": [
        {
          "date": 2016,
          "details": "DAO Fork - Roll back after DAO $50 million in DAO funds were stolen, creating Ethereum Classic and today's Ethereum chain"
        },
        {
          "date": 2017,
          "details": "Byzantium - Reduced block rewards from 5 ETH to 3 ETH, delayed difficulty bomb by 1 year, increased transaction privacy and Layer-2 network scaling activities"
        },
        {
          "date": 2019,
          "details": "Constantinople - Reduced block rewards from 3 ETH to 2 ETH and EVM gas optimizations"
        },
        {
          "date": 2021,
          "details": "London - Introduction of EIP-1559 with optimized fee mechanisms separating base fee and priority fee for transaction inclusion in current block"
        }
      ],
      "blog_updates": "https://blog.ethereum.org/",
      "project_github_repository": [
        "https://github.com/ethereum"
      ],
      "asset_regulation": "Indirectly",
      "asset_regulated_products": [
        "ETH Spot ETFs"
      ],
      "etp_custodians": [
        "Coinbase Custody Trust Company, LLC",
        "Fidelity Digital Asset Services, LLC",
        "Gemini Trust Company, LLC"
      ]
    }
  ],
  "next_page_token": "YnRj",
  "next_page_url": "https://api.coinmetrics.io/v4/profile/assets?api_key=<your_key>&pretty=true&next_page_token=YnRj"
}

PreviousProfile NextNetwork profiles data (experimental)

Last updated 17 days ago

Was this helpful?

{
  "data": [
    {
      "asset": "eth",
      "full_name": "Ethereum",
      "description": "Ethereum is a decentralized computing platform that allows users to create, deploy and interact with programs known as smart contracts.",
      "overview": "Ethereum is a decentralized computing platform that allows users to create, deploy and interact with programs known as smart contracts. Ethereum is a transaction based state machine, meaning that at any point in time the state of the Ethereum network is represented by a mapping of accounts to their associated balance or state. The state of the Ethereum network is updated every time a new block is added to the chain, roughly every 12 seconds. Each block contains information regarding new transactions and is linked to the previous block. The ETH 1.0 chain used a proof-of-work consensus protocol similar to the one implemented by Bitcoin. However, in September 2022 Ethereum transitioned to a new proof-of-stake consensus mechanism that will help reduce fees and increase speed. In a proof-of-stake network, validators stake ETH capital (32 ETH) in a smart contract as a deterrent to act dishonestly. Validators in the network are responsible for validating blocks sent into the network, and creating new blocks when directed. Ethereum also has the capability for users to create smart contracts that are written in a high level language, compiled into bytecode and sent to a contract. The Ethereum Virtual Machine handles all of the bytecode and imposes the coded logic. Smart contracts allow developers to impose logic and rules upon interactions, ultimately creating a product that provides value on the chain. Examples of products built on Ethereum include Aave, a lending platform, and Livepeer, a video streaming infrastructure. Ethereum also provides the framework to create many different types of assets with rules. Examples of popular smart contracts include ERC-20, a framework to create tokens on Ethereum, or ERC-721, a framework for NFTs. Users can interact with smart contracts once they have been deployed allowing for the creation of decentralized applications and additional use cases.",
      "creation_date": "2015-07-30",
      "token_purpose": [
        "Fee Token",
        "Staking Token"
      ],
      "project_team": "N/A",
      "foundation": "Ethereum Foundation",
      "website": "https://ethereum.org/en/",
      "whitepaper_url": "https://ethereum.org/en/whitepaper/#ethereum-whitepaper",
      "token_generation_event_supply": 72009990.5,
      "supply_cap": "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": [
        "Validator"
      ],
      "issuing_networks": [
        "Ethereum"
      ],
      "issuance_schedule_changes": "Ethereum issuance when using Proof-of-Work began at 5 ETH per block, lowering to 3 ETH per block after the Byzantium fork in October 2017, and again to 2 ETH per block after the Constantinople fork in February 2019. After the merge and Ethereum's migration to Proof-of-Stake, ETH is issued by calculating 166 times the square root of the sum of staked ETH. ETH issuance fluctuates consistently depending on the amount staked and amount of ETH participating in each epoch, overall decreasing when more ETH is staked.",
      "significant_historical_changes": [
        {
          "date": "2016-06-17",
          "details": "Ethereum DAO was hacked for $50 million"
        },
        {
          "date": "2021-09-15",
          "details": "EIP-1559 was introduced restructuring the fee market and introducing a variable base fee that is burned"
        },
        {
          "date": "2024-03-13",
          "details": "Ethereum migrated from Proof-of-Work to Proof-of-Stake completing the merge"
        }
      ],
      "upgrade_history": [
        {
          "date": 2016,
          "details": "DAO Fork - Roll back after DAO $50 million in DAO funds were stolen, creating Ethereum Classic and today's Ethereum chain"
        },
        {
          "date": 2017,
          "details": "Byzantium - Reduced block rewards from 5 ETH to 3 ETH, delayed difficulty bomb by 1 year, increased transaction privacy and Layer-2 network scaling activities"
        },
        {
          "date": 2019,
          "details": "Constantinople - Reduced block rewards from 3 ETH to 2 ETH and EVM gas optimizations"
        },
        {
          "date": 2021,
          "details": "London - Introduction of EIP-1559 with optimized fee mechanisms separating base fee and priority fee for transaction inclusion in current block"
        }
      ],
      "blog_updates": "https://blog.ethereum.org/",
      "project_github_repository": [
        "https://github.com/ethereum"
      ],
      "asset_regulation": "Indirectly",
      "asset_regulated_products": [
        "ETH Spot ETFs"
      ],
      "etp_custodians": [
        "Coinbase Custody Trust Company, LLC",
        "Fidelity Digital Asset Services, LLC",
        "Gemini Trust Company, LLC"
      ]
    }
  ],
  "next_page_token": "YnRj",
  "next_page_url": "https://api.coinmetrics.io/v4/profile/assets?api_key=<your_key>&pretty=true&next_page_token=YnRj"
}