GET
/
v1
/
assets
List Assets
curl --request GET \
  --url https://api.blockworks.com/v1/assets \
  --header 'x-api-key: <api-key>'
{
  "page": 1073741824,
  "total": 50,
  "data": [
    {
      "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

This endpoint returns a paginated list of crypto assets supported by the API. Each asset includes its identifier, symbol, slug, description, and other metadata used across API endpoints. Use this endpoint to discover assets before querying metrics, prices, or other detailed data.

​
Example Request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.blockworks.com/v1/assets?limit=20"

​
Example Response

A successful response returns a paginated list of assets. 
{
  "data": [
    {
     "id": 4,
      "code": "BTC",
      "title": "Bitcoin",
      "slug": "bitcoin",
      "tag_line": "A peer-to-peer electronic cash system",
      "description": "Bitcoin is the first distributed consensus-based, censorship-resistant, permissionless, peer-to-peer payment settlement network with a provably scarce, programmable, native currency. Bitcoin (BTC), the native asset of the Bitcoin blockchain, is the world's first digital currency without a central bank or administrator. The Bitcoin network is an emergent decentralized monetary institution that exists through the interplay between full nodes, miners, and developers. It is set by a social contract that is created and opted into by the users of the network and hardened through game theory and cryptography. Bitcoin is the first, oldest, and largest cryptocurrency in the world.",
      "image_url": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
      "legacy_sector": "Currencies",
      "category": "Infrastructure",
      "is_supported": true,
      "updated_at": 1755185437,
      "sector_id": 40,
      "type": "Infrastructure"
    },
    // ... 99 other assets
  ],
  "total": 133505,
  "page": 1
}

​
Supported Options

NameTypeDetails
expandqueryThe fields to expand. See Expand Options for more details.
limitqueryThe number of assets to return.
pagequeryThe page number to return.

​
Notes

  • Results are paginated — use limit and page query parameters to navigate.
  • Asset identifiers returned here can be used as project or asset parameters in other API endpoints.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
page
integer
default:1
Required range: 1 <= x <= 2147483647
​
limit
integer
default:100
Required range: 1 <= x <= 1000
​
code
string | null
Maximum length: 20
​
slug
string | null
Maximum length: 100
​
is_supported
boolean | null
​
category
string[]
​
ids_or_codes
string[]
​
favorites
boolean
​
expand
enum<string>[]
​
query
string<json>
Maximum length: 65535
​
order_by
enum<string>
Available options:
code,
slug,
market_cap.rank,
market_cap.percent_change_usd_1_h,
market_cap.percent_change_usd_24_h,
market_cap.usd,
markets.volume_24_h,
price.usd,
sector.title,
supply.total
​
order_dir
enum<string>
default:asc
Available options:
asc,
desc

Response

200
application/json

The response is of type object.