Get asset details
curl --request GET \
--url https://api.messari.io/metrics/v2/assets/details \
--header 'X-Messari-API-Key: <api-key>'{
"error": null,
"data": [
{
"id": "1e31218a-e44e-4285-820c-8282ee222035",
"name": "Bitcoin",
"slug": "bitcoin",
"symbol": "BTC",
"rank": 1,
"category": "Cryptocurrency",
"sector": "Cryptocurrency",
"sectorV2": [
"Networks"
],
"subSectorV2": [
"Layer-1"
],
"tags": [
"Proof-of-Work"
],
"description": "Bitcoin is the first distributed, [consensus-based](https://messari.io/resource/distributed-systems), censorship-resistant, permissionless, peer-to-peer payment settlement network with a provably scarce, programmable, native currency. The Bitcoin network is an emergent decentralized monetary institution that exists through the interplay of [full nodes](https://messari.io/resource/node), [miners](https://messari.io/resource/mining), and developers. Furthermore, it is set by a social contract created and opted into by the network’s users, which is hardened through [game theory](https://messari.io/c/resource/game-theory) and [cryptography](https://messari.io/resource/cryptography).",
"links": [
{
"name": "Block Explorer",
"url": "https://btc.com/"
},
{
"name": "Reddit",
"url": "https://www.reddit.com/r/Bitcoin/"
},
{
"name": "Telegram",
"url": "http://t.me/bitcoin"
},
{
"name": "Twitter",
"url": "https://x.com/bitcoin"
},
{
"name": "Whitepaper",
"url": "https://bitcoin.org/bitcoin.pdf"
}
],
"marketData": {
"priceUsd": 109561.84962799776,
"priceBtc": 1,
"priceEth": 28.42123153695255,
"priceAt": "2025-10-31T21:51:00Z",
"volume24Hour": 37244476633.788055,
"ohlcv1HourUsd": {
"open": 109439.32026503174,
"high": 109698.95284660516,
"low": 109299.36800144248,
"close": 109561.84962799776,
"volume": 603815659.2393597
},
"ohlcv24HourUsd": {
"open": 107886.3731909698,
"high": 111052.95144763196,
"low": 107488.36708460524,
"close": 109561.84962799776,
"volume": 37244476633.788055
},
"ohlcvTodayUsd": {
"open": 108409.42191881951,
"high": 111052.95144763196,
"low": 108336.08677901482,
"close": 109561.84962799776,
"volume": 35135998507.94298
},
"supply": {
"circulating": 19942003,
"total": 19942003,
"max": 21000000
},
"marketcap": {
"circulatingUsd": 2183799108966,
"fullyDilutedUsd": 2183875362846.2527,
"dominance": 55.8734
}
},
"networkSlugs": [
"bitcoin"
],
"protocolSlugs": [],
"returnOnInvestment": {
"priceChange24h": 1.537031626038965,
"priceChange7d": -1.3831074354356603,
"priceChange30d": -6.80398769323561,
"priceChange1y": 55.79069548749654,
"priceChange3y": 434.7113533742335,
"priceChange5y": 695.8437840952291,
"priceChangeMTD": -3.9439734983016552,
"priceChangeQTD": -3.9439734983016552,
"priceChangeYTD": 17.281626402277535
},
"allTimeHigh": {
"allTimeHigh": 126238.2220708942,
"allTimeHighDate": "2025-10-06T18:00:00Z",
"allTimeHighTimeSinceSeconds": 2174030,
"allTimeHighPercentDown": 13.198250307605644,
"breakevenMultiple": 1.1525723835282684,
"cycleLow": 103553.13308598916,
"cycleLowDate": "2025-10-17T10:00:00Z",
"cycleLowTimeSinceSeconds": 1252430,
"cycleLowPercentUp": 5.924644699199363
},
"contractAddresses": []
},
{
"id": "21c795f5-1bfd-40c3-858e-e9d7e820c6d0",
"name": "Ethereum",
"slug": "ethereum",
"symbol": "ETH",
"rank": 2,
"category": "Networks",
"sector": "Smart Contract Platform",
"sectorV2": [
"Networks"
],
"subSectorV2": [
"Layer-1"
],
"tags": [
"EVM",
"Proof-of-Stake",
"Stakeable"
],
"description": "[Ethereum](https://ethereum.org/en/) is a distributed blockchain computing platform for [smart contracts](https://ethereum.org/en/smart-contracts/) and decentralized applications. The network enables users to build extensively through the use of smart contracts and has since led to the creation of various new assets and industries, such as Decentralized Finance (DeFi), Non-Fungible Tokens (NFTs), Decentralized Autonomous Organizations (DAOs), [Web3](https://ethereum.org/en/web3/), and more. It features an execution engine optimized for smart contract processing, the [Ethereum Virtual Machine](https://ethereum.org/en/developers/docs/evm/) (EVM), and a [Proof-of-Stake](https://ethereum.org/en/developers/docs/consensus-mechanisms/pos/#what-is-pos) (PoS) consensus mechanism. \n",
"links": [
{
"name": "Reddit",
"url": "https://www.reddit.com/r/ethereum/"
},
{
"name": "Github",
"url": "https://github.com/ethereum"
},
{
"name": "Whitepaper",
"url": "https://ethereum.org/en/whitepaper/"
},
{
"name": "Website",
"url": "https://www.ethereum.org/"
},
{
"name": "Twitter",
"url": "https://x.com/ethereum"
}
],
"marketData": {
"priceUsd": 3854.929702308933,
"priceBtc": 0.035184963702217686,
"priceEth": 1,
"priceAt": "2025-10-31T21:51:00Z",
"volume24Hour": 20271790416.765724,
"ohlcv1HourUsd": {
"open": 3856.617660370591,
"high": 3863.932957760635,
"low": 3841.8307023833895,
"close": 3854.929702308933,
"volume": 545921577.1027225
},
"ohlcv24HourUsd": {
"open": 3772.7390594009144,
"high": 3899.1216087488383,
"low": 3765.25990289479,
"close": 3854.929702308933,
"volume": 20271790416.765724
},
"ohlcvTodayUsd": {
"open": 3807.351537991842,
"high": 3899.1216087488383,
"low": 3798.3147665857873,
"close": 3854.929702308933,
"volume": 19171185580.72193
},
"supply": {
"circulating": 120698039.69,
"total": 120698039.688021,
"max": 0
},
"marketcap": {
"circulatingUsd": 464718966398,
"fullyDilutedUsd": 464718966398,
"dominance": 11.89
}
},
"networkSlugs": [
"polygon-zkevm",
"base",
"arbitrum-one",
"optimism",
"ethereum-classic"
],
"protocolSlugs": [],
"returnOnInvestment": {
"priceChange24h": 2.252255092690719,
"priceChange7d": -2.255033059081572,
"priceChange30d": -10.48746606148617,
"priceChange1y": 52.853257934702356,
"priceChange3y": 143.95766358327145,
"priceChange5y": 871.6158122354636,
"priceChangeMTD": -7.019368457253019,
"priceChangeQTD": -7.019368457253019,
"priceChangeYTD": 15.821645335568938
},
"allTimeHigh": {
"allTimeHigh": 4953.378632189802,
"allTimeHighDate": "2025-08-24T19:00:00Z",
"allTimeHighTimeSinceSeconds": 5885630,
"allTimeHighPercentDown": 22.112005894203612,
"breakevenMultiple": 1.2848747365008981,
"cycleLow": 3502.98917829104,
"cycleLowDate": "2025-10-10T21:00:00Z",
"cycleLowTimeSinceSeconds": 1817630,
"cycleLowPercentUp": 10.307656673363399
},
"contractAddresses": [
{
"networkName": "Base",
"networkSlug": "base",
"contractAddress": "0x4200000000000000000000000000000000000006"
},
{
"networkName": "Arbitrum",
"networkSlug": "arbitrum-one",
"contractAddress": "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1"
},
{
"networkName": "Ethereum Classic",
"networkSlug": "ethereum-classic",
"contractAddress": "0x218c3c3d49d0e7b37aff0d8bb079de36ae61a4c0"
}
]
}
]
}Assets & Market Data (included with Enterprise)
Get Asset Details
Returns detailed information for up to 20 assets specified by their ids or slugs.
GET
/
metrics
/
v2
/
assets
/
details
Get asset details
curl --request GET \
--url https://api.messari.io/metrics/v2/assets/details \
--header 'X-Messari-API-Key: <api-key>'{
"error": null,
"data": [
{
"id": "1e31218a-e44e-4285-820c-8282ee222035",
"name": "Bitcoin",
"slug": "bitcoin",
"symbol": "BTC",
"rank": 1,
"category": "Cryptocurrency",
"sector": "Cryptocurrency",
"sectorV2": [
"Networks"
],
"subSectorV2": [
"Layer-1"
],
"tags": [
"Proof-of-Work"
],
"description": "Bitcoin is the first distributed, [consensus-based](https://messari.io/resource/distributed-systems), censorship-resistant, permissionless, peer-to-peer payment settlement network with a provably scarce, programmable, native currency. The Bitcoin network is an emergent decentralized monetary institution that exists through the interplay of [full nodes](https://messari.io/resource/node), [miners](https://messari.io/resource/mining), and developers. Furthermore, it is set by a social contract created and opted into by the network’s users, which is hardened through [game theory](https://messari.io/c/resource/game-theory) and [cryptography](https://messari.io/resource/cryptography).",
"links": [
{
"name": "Block Explorer",
"url": "https://btc.com/"
},
{
"name": "Reddit",
"url": "https://www.reddit.com/r/Bitcoin/"
},
{
"name": "Telegram",
"url": "http://t.me/bitcoin"
},
{
"name": "Twitter",
"url": "https://x.com/bitcoin"
},
{
"name": "Whitepaper",
"url": "https://bitcoin.org/bitcoin.pdf"
}
],
"marketData": {
"priceUsd": 109561.84962799776,
"priceBtc": 1,
"priceEth": 28.42123153695255,
"priceAt": "2025-10-31T21:51:00Z",
"volume24Hour": 37244476633.788055,
"ohlcv1HourUsd": {
"open": 109439.32026503174,
"high": 109698.95284660516,
"low": 109299.36800144248,
"close": 109561.84962799776,
"volume": 603815659.2393597
},
"ohlcv24HourUsd": {
"open": 107886.3731909698,
"high": 111052.95144763196,
"low": 107488.36708460524,
"close": 109561.84962799776,
"volume": 37244476633.788055
},
"ohlcvTodayUsd": {
"open": 108409.42191881951,
"high": 111052.95144763196,
"low": 108336.08677901482,
"close": 109561.84962799776,
"volume": 35135998507.94298
},
"supply": {
"circulating": 19942003,
"total": 19942003,
"max": 21000000
},
"marketcap": {
"circulatingUsd": 2183799108966,
"fullyDilutedUsd": 2183875362846.2527,
"dominance": 55.8734
}
},
"networkSlugs": [
"bitcoin"
],
"protocolSlugs": [],
"returnOnInvestment": {
"priceChange24h": 1.537031626038965,
"priceChange7d": -1.3831074354356603,
"priceChange30d": -6.80398769323561,
"priceChange1y": 55.79069548749654,
"priceChange3y": 434.7113533742335,
"priceChange5y": 695.8437840952291,
"priceChangeMTD": -3.9439734983016552,
"priceChangeQTD": -3.9439734983016552,
"priceChangeYTD": 17.281626402277535
},
"allTimeHigh": {
"allTimeHigh": 126238.2220708942,
"allTimeHighDate": "2025-10-06T18:00:00Z",
"allTimeHighTimeSinceSeconds": 2174030,
"allTimeHighPercentDown": 13.198250307605644,
"breakevenMultiple": 1.1525723835282684,
"cycleLow": 103553.13308598916,
"cycleLowDate": "2025-10-17T10:00:00Z",
"cycleLowTimeSinceSeconds": 1252430,
"cycleLowPercentUp": 5.924644699199363
},
"contractAddresses": []
},
{
"id": "21c795f5-1bfd-40c3-858e-e9d7e820c6d0",
"name": "Ethereum",
"slug": "ethereum",
"symbol": "ETH",
"rank": 2,
"category": "Networks",
"sector": "Smart Contract Platform",
"sectorV2": [
"Networks"
],
"subSectorV2": [
"Layer-1"
],
"tags": [
"EVM",
"Proof-of-Stake",
"Stakeable"
],
"description": "[Ethereum](https://ethereum.org/en/) is a distributed blockchain computing platform for [smart contracts](https://ethereum.org/en/smart-contracts/) and decentralized applications. The network enables users to build extensively through the use of smart contracts and has since led to the creation of various new assets and industries, such as Decentralized Finance (DeFi), Non-Fungible Tokens (NFTs), Decentralized Autonomous Organizations (DAOs), [Web3](https://ethereum.org/en/web3/), and more. It features an execution engine optimized for smart contract processing, the [Ethereum Virtual Machine](https://ethereum.org/en/developers/docs/evm/) (EVM), and a [Proof-of-Stake](https://ethereum.org/en/developers/docs/consensus-mechanisms/pos/#what-is-pos) (PoS) consensus mechanism. \n",
"links": [
{
"name": "Reddit",
"url": "https://www.reddit.com/r/ethereum/"
},
{
"name": "Github",
"url": "https://github.com/ethereum"
},
{
"name": "Whitepaper",
"url": "https://ethereum.org/en/whitepaper/"
},
{
"name": "Website",
"url": "https://www.ethereum.org/"
},
{
"name": "Twitter",
"url": "https://x.com/ethereum"
}
],
"marketData": {
"priceUsd": 3854.929702308933,
"priceBtc": 0.035184963702217686,
"priceEth": 1,
"priceAt": "2025-10-31T21:51:00Z",
"volume24Hour": 20271790416.765724,
"ohlcv1HourUsd": {
"open": 3856.617660370591,
"high": 3863.932957760635,
"low": 3841.8307023833895,
"close": 3854.929702308933,
"volume": 545921577.1027225
},
"ohlcv24HourUsd": {
"open": 3772.7390594009144,
"high": 3899.1216087488383,
"low": 3765.25990289479,
"close": 3854.929702308933,
"volume": 20271790416.765724
},
"ohlcvTodayUsd": {
"open": 3807.351537991842,
"high": 3899.1216087488383,
"low": 3798.3147665857873,
"close": 3854.929702308933,
"volume": 19171185580.72193
},
"supply": {
"circulating": 120698039.69,
"total": 120698039.688021,
"max": 0
},
"marketcap": {
"circulatingUsd": 464718966398,
"fullyDilutedUsd": 464718966398,
"dominance": 11.89
}
},
"networkSlugs": [
"polygon-zkevm",
"base",
"arbitrum-one",
"optimism",
"ethereum-classic"
],
"protocolSlugs": [],
"returnOnInvestment": {
"priceChange24h": 2.252255092690719,
"priceChange7d": -2.255033059081572,
"priceChange30d": -10.48746606148617,
"priceChange1y": 52.853257934702356,
"priceChange3y": 143.95766358327145,
"priceChange5y": 871.6158122354636,
"priceChangeMTD": -7.019368457253019,
"priceChangeQTD": -7.019368457253019,
"priceChangeYTD": 15.821645335568938
},
"allTimeHigh": {
"allTimeHigh": 4953.378632189802,
"allTimeHighDate": "2025-08-24T19:00:00Z",
"allTimeHighTimeSinceSeconds": 5885630,
"allTimeHighPercentDown": 22.112005894203612,
"breakevenMultiple": 1.2848747365008981,
"cycleLow": 3502.98917829104,
"cycleLowDate": "2025-10-10T21:00:00Z",
"cycleLowTimeSinceSeconds": 1817630,
"cycleLowPercentUp": 10.307656673363399
},
"contractAddresses": [
{
"networkName": "Base",
"networkSlug": "base",
"contractAddress": "0x4200000000000000000000000000000000000006"
},
{
"networkName": "Arbitrum",
"networkSlug": "arbitrum-one",
"contractAddress": "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1"
},
{
"networkName": "Ethereum Classic",
"networkSlug": "ethereum-classic",
"contractAddress": "0x218c3c3d49d0e7b37aff0d8bb079de36ae61a4c0"
}
]
}
]
}Documentation Index
Fetch the complete documentation index at: https://docs.messari.io/llms.txt
Use this file to discover all available pages before exploring further.
x402 Support: Supported.
See the x402 guide.
Authorizations
Query Parameters
Comma separated list of asset identifiers - accepts slugs (e.g. 'bitcoin') or UUIDs
Example:
"bitcoin,ethereum"
Page number (1-indexed)
Example:
1
Number of results per page
Example:
10
Column to sort by (default: circulating-marketcap)
Available options:
slug, rank, price-usd, circulating-marketcap, fully-diluted-marketcap, volume-24h, price-change-24h, price-change-7d, price-change-30d Sort direction: asc or desc (default: desc)
Available options:
asc, desc ⌘I

