GET
/
v1
/
assets
/
{idOrSlug}
Get Asset
curl --request GET \
  --url https://api.blockworks.com/v1/assets/{idOrSlug} \
  --header 'x-api-key: <api-key>'
{
  "id": 2147483647,
  "code": "<string>",
  "title": "<string>",
  "slug": "<string>",
  "tag_line": "<string>",
  "description": "<string>",
  "image_url": "<string>",
  "legacy_sector": "<string>",
  "category": "<string>",
  "is_supported": true,
  "updated_at": 123,
  "sector_id": 2147483647,
  "type": "Infrastructure",
  "market_cap": {
    "asset_id": 2147483647,
    "rank": 2147483647,
    "usd": 8.988465674311579e+307,
    "dominance": 1.7014115e+38,
    "percent_change_btc_1_h": 1.7014115e+38,
    "percent_change_btc_24_h": 1.7014115e+38,
    "percent_change_usd_1_h": 1.7014115e+38,
    "percent_change_usd_24_h": 1.7014115e+38,
    "percent_change_eth_1_h": 1.7014115e+38,
    "percent_change_eth_24_h": 1.7014115e+38,
    "updated_at": 123
  },
  "price": {
    "asset_id": 2147483647,
    "usd": 8.988465674311579e+307,
    "btc": 8.988465674311579e+307,
    "eth": 8.988465674311579e+307,
    "sparkline_7d": "<string>",
    "updated_at": 123
  }
}

​
Overview

Add the ?expand=price flag to your /assets or /assets/{idOrSlug} page to include price data in the response.

​
Example Request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.blockworks.com/v1/assets/ethereum?expand=price"

​
Example Response

{
  "id": 2,
  "code": "ETH",
  "title": "Ethereum",
  "slug": "ethereum",
  "tag_line": "A decentralized computing platform",
  "description": "Ethereum is a distributed blockchain computing platform for smart contracts and decentralized applications. Its native token is ether (ETH), which primarily serves as a means of payment for transaction fees and as collateral for borrowing specific ERC-20 tokens within the decentralized finance (DeFi) sector.",
  "image_url": "https://coin-images.coingecko.com/coins/images/279/large/ethereum.png?1696501628",
  "category": "Infrastructure",
  "updated_at": 1757457156,
  "type": "Infrastructure",
  "price": {
    "assetId": 2,
    "usd": 4309.02,
    "btc": 0.051222333099357,
    "eth": 1,
    "sparkline_7d": "[4322.095678730608,4298.0616001936705,4274.517146643319,4315.6178220017455,4320.320554961184,4327.274249228913,4325.856306225941,4306.388722785641,4329.077475385006,4339.4301811268415,4335.535265676118,4339.022488530309,4312.568115860796,4310.593717333038,4310.961258987607,4320.112679021238,4350.323273805925,4370.414269663671,4374.562295493143,4353.026634438393,4428.858255611064,4468.583810562617,4482.357700797971,4467.527610120462,4475.180129072965,4466.607826301512,4476.770034707743,4465.8255512963415,4460.444169507737,4470.542882578564,4451.0636436771065,4468.186233261665,4465.64844052439,4422.232692401979,4398.579941738134,4408.048439574151,4367.75077808085,4365.7012838688715,4374.939625211524,4373.477126218714,4394.930354297206,4408.2046122597885,4409.209905052319,4404.432132894136,4379.0193473996915,4349.805717138926,4312.374902377514,4300.497570328323,4312.150910966871,4279.806105550541,4275.769638294805,4304.72555030459,4320.560196426073,4345.2362298073795,4298.094660544595,4297.233267749553,4326.669572204068,4324.007655518518,4328.819785579683,4333.434254714475,4339.09770037951,4332.778254951191,4422.913648895045,4406.789878633636,4395.665043002883,4411.558070766167,4417.627470360946,4465.500324291025,4440.619541979517,4273.145826961314,4282.043143207464,4294.836232219916,4290.515727303717,4311.5931333982235,4324.098880448002,4337.81653825236,4300.220323512726,4313.626874707965,4306.9385585791215,4322.553600075343,4318.740466976673,4321.457142300914,4318.8013031989885,4309.170167890993,4293.998180788963,4302.1721724468825,4310.446258449114,4310.327361889885,4293.3027567555955,4300.73225349102,4299.569071805955,4298.898290640714,4293.70851803924,4296.083159121834,4272.215250866289,4288.342267066458,4273.89816550853,4279.454297507947,4256.038324531825,4278.222648953216,4285.304297657877,4277.460966535968,4273.110024157841,4284.740337027086,4297.974189698818,4302.861368102252,4294.830783401375,4300.979043931227,4295.062215093881,4284.451771046128,4296.506238577695,4302.482332319991,4299.912507046525,4303.498155762447,4308.872646673726,4299.9645682805085,4304.366883796359,4297.760345585981,4298.77181454136,4289.2184103950985,4276.403247973121,4281.695776763906,4290.003113227399,4298.922465612313,4291.405419404144,4313.63548273977,4305.712109548157,4301.456383061941,4289.620410138945,4308.442091494962,4297.944437316162,4295.836317668043,4292.125157428518,4289.553621519912,4298.421637661142,4316.558607099911,4328.023937366257,4313.728035506479,4319.783712474413,4324.892821973295,4343.572205964396,4367.54908206563,4340.847715405802,4311.3916110408045,4331.178824847077,4291.747772125815,4296.0843503181595,4318.656256438794,4310.315413835551,4309.685702772004,4301.791442383855,4286.847405046845,4291.0452537073525,4305.850543735766,4314.352391505099,4316.780266676034,4370.902388226368,4361.014741078244,4359.464535610553,4356.895495472781,4349.14181043054,4347.851449455902,4346.140559142935,4349.5464999814585,4305.669409094365,4287.843540855948,4289.191056417266]",
    "updated_at": 1757457156
  }
}

​
Field Reference

FieldTypeDescription
asset_idnumberUnique identifier for the asset
usdnumberCurrent price in US dollars
btcnumberCurrent price in Bitcoin
ethnumberCurrent price in Ethereum
sparkline_7dstringJSON array of price points for 7-day sparkline chart
updated_atnumberUnix timestamp when the price was last updated

​
Notes

  • Can be used with other expansion options by joining with a comma (e.g. ?expand=markets,ohlcv_last_24_h).
  • Can be used on /v1/assets/ or /v1/assets/{idOrSlug} endpoints.
  • price and market_cap are expanded by default in /assets/{idOrSlug} results unless an explicit ?expand= flag is provided.

​
See also

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
idOrSlug
string
required

Query Parameters

​
expand
enum<string>[]

Response

The response is of type object.