> ## 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.

# Project Tokens

> Daily metrics for one token contract on one chain: price, supply, mints and burns, where the supply sits by holder type in native units and USD, holders, lending deposits, borrows, flows, APYs and liquidations, spot DEX volume and transfers. Each series is one token deployment, keyed by chain and contract address. Fields are null where a token has no such activity, so pass selections.

| | |
| - | - |
| Access | Assets-dataset |
| Timeseries model | `project-tokens`: intervals `1d`, series key `id` (Token ID), series must be named (up to 20 per call) |

## Endpoints

<CardGroup cols={2}>
  <Card title="Batch Get Project Token timeseries" icon="arrow-right" href="/api-reference/data-api/assets/timeseries-project-tokens">
    Up to 20 series in one request, named by Token ID in `series`.
  </Card>

  <Card title="Get Project Token timeseries" icon="arrow-right" href="/api-reference/data-api/assets/timeseries-project-tokens-by-id">
    One series over a time window, keyed by its Token ID.
  </Card>
</CardGroup>

## Metrics

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

| Field | Name | Type | Unit | Description |
| - | - | - | - | - |
| `priceUSD` | Price (USD) | float64 | | Token price in USD. |
| `supplyMax` | Max Supply | float64 | | Maximum token supply. |
| `supplyTotal` | Total Supply | float64 | | Total token supply. |
| `supplyIssued` | Issued Supply | float64 | | Issued token supply, total supply less unissued balances. |
| `mintAmount` | Mint Amount | float64 | | Tokens minted, in native units. |
| `mintAmountUSD` | Mint Amount (USD) | float64 | | Tokens minted in USD. |
| `mintCount` | Mint Count | float64 | | Number of mint events. |
| `burnAmount` | Burn Amount | float64 | | Tokens burned, in native units. |
| `burnAmountUSD` | Burn Amount (USD) | float64 | | Tokens burned in USD. |
| `burnCount` | Burn Count | float64 | | Number of burn events. |
| `balanceUnissued` | Balance Unissued | float64 | | Supply held by unissued supply addresses, in native units. |
| `balanceBridge` | Balance Bridge | float64 | | Supply held by bridge contracts, in native units. |
| `balanceCeFi` | Balance CeFi | float64 | | Supply held by centralized finance wallets, in native units. |
| `balanceSpotDEX` | Balance Spot DEX | float64 | | Supply held by spot DEX pools, in native units. |
| `balancePerpDEX` | Balance Perp DEX | float64 | | Supply held by perpetual DEX contracts, in native units. |
| `balancePayments` | Balance Payments | float64 | | Supply held by payment card addresses, in native units. |
| `balancePrivacy` | Balance Privacy | float64 | | Supply held by privacy protocols, in native units. |
| `balanceStaking` | Balance Staking | float64 | | Supply held by staking contracts, in native units. |
| `balanceWrapped` | Balance Wrapped | float64 | | Supply held by wrapping contracts, in native units. |
| `balanceManaged` | Balance Managed | float64 | | Supply held by vault managed wallets, in native units. |
| `balanceCDP` | Balance CDP | float64 | | Supply held by CDP protocols, in native units. |
| `balanceTreasuries` | Balance Treasuries | float64 | | Supply held by onchain treasuries, in native units. |
| `balancePredictionMarket` | Balance Prediction Market | float64 | | Supply held by prediction markets, in native units. |
| `balanceYieldDerivatives` | Balance Yield Derivatives | float64 | | Supply held by yield derivative protocols, in native units. |
| `balanceBlacklist` | Balance Blacklist | float64 | | Supply held by blacklisted addresses, in native units. |
| `balanceUnissuedUSD` | Balance Unissued (USD) | float64 | | Supply held by unissued supply addresses in USD. |
| `balanceBridgeUSD` | Balance Bridge (USD) | float64 | | Supply held by bridge contracts in USD. |
| `balanceCeFiUSD` | Balance CeFi (USD) | float64 | | Supply held by centralized finance wallets in USD. |
| `balanceSpotDEXUSD` | Balance Spot DEX (USD) | float64 | | Supply held by spot DEX pools in USD. |
| `balancePerpDEXUSD` | Balance Perp DEX (USD) | float64 | | Supply held by perpetual DEX contracts in USD. |
| `balancePaymentsUSD` | Balance Payments (USD) | float64 | | Supply held by payments addresses in USD. |
| `balancePrivacyUSD` | Balance Privacy (USD) | float64 | | Supply held by privacy protocols in USD. |
| `balanceStakingUSD` | Balance Staking (USD) | float64 | | Supply held by staking contracts in USD. |
| `balanceWrappedUSD` | Balance Wrapped (USD) | float64 | | Supply held by wrapping contracts in USD. |
| `balanceManagedUSD` | Balance Managed (USD) | float64 | | Supply held by managed wallets in USD. |
| `balanceCDPUSD` | Balance CDP (USD) | float64 | | Supply held by CDP protocols in USD. |
| `balanceTreasuriesUSD` | Balance Treasuries (USD) | float64 | | Supply held by treasuries in USD. |
| `balancePredictionMarketUSD` | Balance Prediction Market (USD) | float64 | | Supply held by prediction markets in USD. |
| `balanceYieldDerivativesUSD` | Balance Yield Derivatives (USD) | float64 | | Supply held by yield derivative protocols in USD. |
| `balanceBlacklistUSD` | Balance Blacklist (USD) | float64 | | Supply held by blacklisted addresses in USD. |
| `balanceUnknownUSD` | Balance Unknown (USD) | float64 | | Supply held by unlabeled addresses in USD. |
| `holders` | Holders | float64 | | Number of addresses holding the token. |
| `lendingDepositsUSD` | Lending Deposits (USD) | float64 | | Deposited in lending protocols in USD. |
| `lendingBorrowedUSD` | Lending Borrowed (USD) | float64 | | Borrowed from lending protocols in USD. |
| `lendingNetFlowUSD` | Lending Net Flow (USD) | float64 | | Net lending flow in USD (gross inflow plus gross outflow). |
| `lendingGrossInflowUSD` | Lending Gross Inflow (USD) | float64 | | Gross lending inflow in USD. |
| `lendingGrossOutflowUSD` | Lending Gross Outflow (USD) | float64 | | Gross lending outflow in USD (negative). |
| `lendingSupplyAPY` | Lending Supply APY | float64 | | Average lending supply APY, as a decimal. |
| `lendingBorrowAPY` | Lending Borrow APY | float64 | | Average lending borrow APY, as a decimal. |
| `lendingCollateralSeizedUSD` | Lending Collateral Seized (USD) | float64 | | Collateral seized in lending liquidations in USD. |
| `lendingLiquidationLossUSD` | Lending Liquidation Loss (USD) | float64 | | Lending liquidation losses (bad debt) in USD. |
| `lendingLiquidationCount` | Lending Liquidation Count | float64 | | Number of lending liquidations. |
| `spotDEXBuyVolumeUSD` | Spot DEX Buy Volume (USD) | float64 | | Spot DEX buy volume in USD. |
| `spotDEXSellVolumeUSD` | Spot DEX Sell Volume (USD) | float64 | | Spot DEX sell volume in USD. |
| `spotDEXVolumeUSD` | Spot DEX Volume (USD) | float64 | | Spot DEX volume in USD. |
| `spotDEXTradeCount` | Spot DEX Trade Count | float64 | | Number of spot DEX trades. |
| `spotDEXTraders` | Spot DEX Traders | float64 | | Number of unique spot DEX traders. |
| `transferVolume` | Transfer Volume | float64 | | Transfer volume in native units, unfiltered. |
| `transferVolumeUSD` | Transfer Volume (USD) | float64 | | Transfer volume in USD, unfiltered. |
| `transferUniqueSenders` | Transfer Unique Senders | float64 | | Distinct sending addresses. |
| `transferUniqueReceivers` | Transfer Unique Receivers | float64 | | Distinct receiving addresses. |
| `transferMedianSize` | Transfer Median Size | float64 | | Median transfer size in native units. |
| `transferCount` | Transfer Count | float64 | | Number of transfers. |

## Example

```bash curl theme={null}
curl "https://api.blockworks.com/query/timeseries/project-tokens/1d/<id>?timeframe=7d&selections=priceUSD,supplyMax" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"
```

See [Get Project Token timeseries](/api-reference/data-api/assets/timeseries-project-tokens-by-id) for the response and the errors.


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