Authorizations
Query Parameters
Comma separated list of asset identifiers - accepts slugs (e.g. 'bitcoin') or UUIDs
Example:
"bitcoin,ethereum"
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"
}
]
}
]
}Returns detailed information for up to 20 assets specified by their ids or slugs.
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"
}
]
}
]
}Comma separated list of asset identifiers - accepts slugs (e.g. 'bitcoin') or UUIDs
"bitcoin,ethereum"