> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Token Metrics

> Daily metrics for one token contract on one chain: price, supply, mints and burns, supply held by each holder type, holders by balance size, lending, spot DEX trading and transfer activity. Each series is one token deployment, keyed by chain and contract address, and matching the token-labels id. Many series per token, so name the deployments you need.

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

> [card] [List Token Metrics](https://docs.blockworks.com/api-reference/data-api/tokens/tabular-token-metrics.md)
>
> One page of rows with per-column filters, sorting and pagination.

> [card] [Batch Get Token Metric timeseries](https://docs.blockworks.com/api-reference/data-api/tokens/timeseries-token-metrics.md)
>
> Up to 10 series in one request, named by series key in `series`.

> [card] [Get Token Metric timeseries](https://docs.blockworks.com/api-reference/data-api/tokens/timeseries-token-metrics-by-id.md)
>
> 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 | Filters | Sort | 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

```bash curl theme={null}
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](https://docs.blockworks.com/api-reference/data-api/tokens/timeseries-token-metrics-by-id.md) for the response and the errors.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.