Skip to main content
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"
        }
      ]
    }
  ]
}

Authorizations

X-Messari-API-Key
string
header
required

Query Parameters

assetIDs
string
default:bitcoin,ethereum

Comma separated list of asset identifiers - accepts slugs (e.g. 'bitcoin') or UUIDs

Example:

"bitcoin,ethereum"

Response

Default response

data
object[]
required
error
string