Token Metrics

One row per token deployment with token metrics, keyed by chain and contract address: symbol, slug, category, sector and subsector, issuer and network. The id is the series key of the token-metrics timeseries model and matches the token-labels id.


Access	Assets-dataset
Tabular model	`token-metrics`: primary key `id`
Timeseries model	`token-metrics`: intervals `1d`, series key `id` (Token Metric ID), every series available in one call

Endpoints

List Token Metrics

One page of rows with per-column filters, sorting and pagination.

Batch Get Token Metric timeseries

Up to 10 series in one request, named by series key in series.

Get Token Metric timeseries

One series over a time window, keyed by its Token Metric ID.

Metrics

111 metrics. Use the Field value in selections; every point starts with the timestamp and continues in this order.

Field	Name	Type	Unit	Description
`priceUSD`
`supplyTotal`
`supplyIssued`
`supplyIssuedUSD`
`supplyCirculating`
`supplyCirculatingUSD`
`supplyAdjusted`
`supplyAdjustedUSD`
`mintAmount`
`burnAmount`
`mintAmountUSD`
`burnAmountUSD`
`mintCount`
`burnCount`
`balanceProtocolOwned`
`balanceBridge`
`balanceCEX`
`balancePerpDEX`
`balanceSpotDEX`
`balancePayments`
`balancePrivacy`
`balanceStaking`
`balanceCDP`
`balanceTreasuries`
`balancePredictionMarket`
`balanceYieldDerivatives`
`balanceManaged`
`balanceWrapped`
`balanceBlacklist`
`balanceBuyback`
`balanceLending`
`balanceProtocolOwnedUSD`
`balanceBridgeUSD`
`balanceCEXUSD`
`balancePerpDEXUSD`
`balanceSpotDEXUSD`
`balancePaymentsUSD`
`balancePrivacyUSD`
`balanceStakingUSD`
`balanceCDPUSD`
`balanceTreasuriesUSD`
`balancePredictionMarketUSD`
`balanceYieldDerivativesUSD`
`balanceManagedUSD`
`balanceWrappedUSD`
`balanceBuybackUSD`
`balanceLendingUSD`
`balanceBlacklistUSD`
`balanceUnknownUSD`
`balanceUnknown`
`holdersTotal`
`holders0To1`
`holders1To10`
`holders10To100`
`holders100To1K`
`holders1KTo10K`
`holders10KPlus`
`lendingDepositUSD`
`lendingBorrowUSD`
`lendingNetFlowUSD`
`lendingGrossInflowUSD`
`lendingGrossOutflowUSD`
`lendingAvgSupplyAPY`
`lendingAvgBorrowAPY`
`lendingCollateralSeizedUSD`
`lendingLiquidationLossUSD`
`lendingLiquidationCount`
`spotDEXBuyVolumeUSD`
`spotDEXSellVolumeUSD`
`spotDEXCorrelatedVolumeUSD`
`spotDEXVolumeUSD`
`spotDEXTradeCount`
`spotDEXTraders`
`marketsUniqueSpotDEX`
`spotDEXLiquidityAddVolume`
`spotDEXLiquidityBurnVolume`
`spotDEXLiquidityAddCount`
`spotDEXLiquidityBurnCount`
`transferVolumeRaw`
`transferVolumeRawUSD`
`transferSendersUnique`
`transferReceiversUnique`
`transferSizeMedian`
`transferCount`
`transferSizeMedianUSD`
`transferCount0To1`
`transferCount1To10`
`transferCount10To100`
`transferCount100To1K`
`transferCount1KTo10K`
`transferCount10KTo100K`
`transferCount100KTo1M`
`transferCount1MPlus`
`transferVolume0To1`
`transferVolume1To10`
`transferVolume10To100`
`transferVolume100To1K`
`transferVolume1KTo10K`
`transferVolume10KTo100K`
`transferVolume100KTo1M`
`transferVolume1MPlus`
`transferVolumeBridge`
`transferVolumeBridgeUSD`
`transferVolumeCEXFlow`
`transferVolumeCEXFlowUSD`
`transferVolumeCEXIntra`
`transferVolumeCEXIntraUSD`
`transferVolumePrivacy`
`transferVolumePrivacyUSD`
`transferVolumeFlashloan`
`transferVolumeFlashloanUSD`

Columns

Use the Field value in selections, sortBy, and as the base of a filter parameter (Field plus one of its Filters suffixes).

Field	Type	Description
`category`	string	The token’s category classification.
`chain`	string	The short name of the chain the token is deployed on (ethereum, base, solana).
`id`	string	The series key of the token-metrics timeseries model, the token’s chain and contract address joined with an underscore.
`issuerID`	string	The identifier of the token’s issuer (for example circle or tether); null when unclassified.
`name`	string	The display name of the series, the token’s symbol followed by its chain.
`networkID`	string	The chain’s networkID in the blockchains model; null when unmapped.
`sector`	string	The token’s sector classification.
`slug`	string	The token’s identifier, shared by every chain’s deployment of the same token (circle-usdc); null when unclassified, and not unique across chains.
`subsector`	string	The token’s subsector classification.
`symbol`	string	The token’s ticker symbol.
`tokenAddress`	string	The token contract address (the mint address on Solana).

Example

curl

curl "https://api.blockworks.com/query/timeseries/token-metrics/1d/<id>?timeframe=7d&selections=priceUSD,supplyTotal" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"

See Get Token Metric timeseries for the response and the errors.

Getting Started

Discovery

Concepts

Market Data

Onchain Fundamentals

Institutional

Fundraising

Social & Mindshare

News

Research

Token Unlocks

Token Transparency Framework

Charts