Skip to main content
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>",
      "sector": "<string>",
      "category": "<string>",
      "updated_at": 123,
      "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": 1,
      "code": "NEAR",
      "title": "NEAR Protocol",
      "slug": "near-protocol",
      "tag_line": "A scalable, developer-friendly blockchain",
      "description": "NEAR is a decentralized development platform that uses a Proof-of-Stake (PoS) consensus mechanism and will eventually feature a sharded architecture to scale transaction throughput. Its block generation scheme is called Doomslug and its proposed sharding design is dubbed Nightshade. These technologies will work together to scale the network and minimize congestion. NEAR has also been designed to be developer and user-friendly as it features a few key innovations to accelerate the application development and user-onboarding processes. The NEAR blockchain was created and developed by the NEAR Foundation. Its mainnet went live in April 2020, and network validators voted to unlock token transfers in October 2020. NEAR's bridge to Ethereum (called the Rainbow Bridge) launched in March 2021.",
      "image_url": "https://coin-images.coingecko.com/coins/images/10365/large/near.jpg?1696510367",
      "category": "Infrastructure",
      "updated_at": 1761160398,
      "type": "Infrastructure",
      "sector": "L1"
    },
    ... // more assets
  ],
  "total": 133030,
  "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.

​
Response Fields

FieldTypeDescription
categorystringAsset category (e.g., Infrastructure, DeFi)
codestringAsset ticker symbol (e.g., BTC, ETH)
descriptionstringDetailed asset description
idnumberUnique asset identifier
image_urlstringURL to asset logo/image
sectorstringSector of the asset
slugstringURL-friendly identifier
tag_linestringShort description or tagline
titlestringFull asset name
typestringAsset type classification
updated_atnumberUnix timestamp of last update

​
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 string length: 20
​
slug
string | null
Maximum string length: 100
​
category
string[]
​
ids_or_codes
string[]
​
favorites
boolean
​
expand
enum<string>[]
Available options:
addresses,
chains,
addresses.chain,
markets,
market_cap,
ohlcv_last_24_h,
price,
reference,
sector,
supply
​
query
string<json>
Maximum string 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

​
page
integer
required
Required range: 1 <= x <= 2147483647
​
total
integer
required
Required range: 1 <= x <= 100
​
data
object[]
required