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

# Tokenized Commodities by Commodity

> Metrics for one underlying commodity summed across every issuer and chain tokenizing it: chains, issuers and contracts, tokenized supply, average token price, mints and burns, where the supply sits (CEX, DEX, lending, unlabeled wallets), holders, spot DEX volume and transfers. Each series is one commodity, keyed by its commodity id.

One row per commodity with tokenized products, keyed by its commodity id: name. The id is the series key of the tokenized-commodities-by-commodity timeseries model.

|                  |                                                                                                                          |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Access           | Stablecoins\_unified                                                                                                     |
| Tabular model    | `tokenized-commodities`: primary key `id`                                                                                |
| Timeseries model | `tokenized-commodities-by-commodity`: intervals `1d`, series key `id` (Commodity ID), every series available in one call |

## Endpoints

<CardGroup cols={2}>
  <Card title="List Commodities" icon="arrow-right" href="/api-reference/data-api/tokenized-commodities/tabular-tokenized-commodities">
    One page of rows with per-column filters, sorting and pagination.
  </Card>

  <Card title="Batch Get Commodity timeseries" icon="arrow-right" href="/api-reference/data-api/tokenized-commodities/timeseries-tokenized-commodities-by-commodity">
    Every series in one request, or the named ones.
  </Card>

  <Card title="Get Commodity timeseries" icon="arrow-right" href="/api-reference/data-api/tokenized-commodities/timeseries-tokenized-commodities-by-commodity-by-id">
    One series over a time window, keyed by its Commodity ID.
  </Card>
</CardGroup>

## Metrics

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

| Field                  | Name                        | Type    | Unit | Description                                            |
| ---------------------- | --------------------------- | ------- | ---- | ------------------------------------------------------ |
| `chainCount`           | Chain Count                 | float64 |      | Distinct chains the commodity is tokenized on.         |
| `issuerCount`          | Issuer Count                | float64 |      | Distinct issuers tokenizing the commodity.             |
| `tokenAddressCount`    | Token Address Count         | float64 |      | Distinct token contract addresses across chains.       |
| `tokenizedSupplyUSD`   | Tokenized Supply (USD)      | float64 |      | Tokenized supply in USD across every issuer and chain. |
| `averagePriceUSD`      | Average Price (USD)         | float64 |      | Average token price in USD.                            |
| `mintAmountUSD`        | Mint Amount (USD)           | float64 |      | Value minted in USD.                                   |
| `burnAmountUSD`        | Burn Amount (USD)           | float64 |      | Value burned in USD (negative).                        |
| `balanceCEXUSD`        | Balance on CEXes (USD)      | float64 |      | Supply held in centralized-exchange wallets in USD.    |
| `balancePerpDEXUSD`    | Balance on Perp DEXes (USD) | float64 |      | Supply held in perpetual-DEX contracts in USD.         |
| `balanceSpotDEXUSD`    | Balance on Spot DEXes (USD) | float64 |      | Supply held in spot-DEX pools in USD.                  |
| `balanceLendingUSD`    | Balance in Lending (USD)    | float64 |      | Supply held in lending protocols in USD.               |
| `balanceUnknownUSD`    | Balance Unknown (USD)       | float64 |      | Supply held in unlabeled wallets in USD.               |
| `holders`              | Holders                     | float64 |      | Token holders.                                         |
| `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 |      | Spot DEX trades.                                       |
| `spotDEXTraders`       | Spot DEX Traders            | float64 |      | Spot DEX traders.                                      |
| `transferVolumeUSD`    | Transfer Volume (USD)       | float64 |      | Transfer volume in USD.                                |
| `transferCount`        | Transfer Count              | float64 |      | Transfers.                                             |

## 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                                                                                                |
| ------ | ------ | --------------------------- | ------- | ---------------------------------------------------------------------------------------------------------- |
| `id`   | string | `Eq`, `IsOneOf`             |         | The series key of the tokenized-commodities-by-commodity timeseries model, the commodity id. (primary key) |
| `name` | string | `Eq`, `IsOneOf`, `Contains` | default | The display name of the commodity, its id in uppercase.                                                    |

## Example

```bash curl theme={null}
curl "https://api.blockworks.com/query/timeseries/tokenized-commodities-by-commodity/1d/emld?timeframe=7d&selections=chainCount,issuerCount" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"
```

See [Get Commodity timeseries](/api-reference/data-api/tokenized-commodities/timeseries-tokenized-commodities-by-commodity-by-id) for the response and the errors.