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"
        }
      ]
    }
  ]
}
x402 Support: Supported. See the x402 guide.

Authorizations

X-Messari-API-Key
string
header
required

Query Parameters

assetIDs
string

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

Example:

"bitcoin,ethereum"

page
integer<int64>
default:1

Page number (1-indexed)

Example:

1

limit
integer<int64>
default:10

Number of results per page

Example:

10

sort
enum<string>
default:circulating-marketcap

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
order
enum<string>
default:desc

Sort direction: asc or desc (default: desc)

Available options:
asc,
desc

Response

Default response

data
object[]
required
error
string
metadata
object

Pagination metadata