> ## 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 Equities by Equity

> Metrics for one underlying stock summed across every issuer and chain tokenizing it: chains, issuers and contracts, tokenized supply, the underlying's close price and traded volume, mints and burns, where the supply sits (CEX, DEX, lending, unlabeled wallets), holders, spot DEX volume and transfers. Each series is one stock, keyed by its ticker. The widest tokenized-equity grain, with over a thousand series, so name the stocks you need.

One row per underlying stock with tokenized products, keyed by its ticker: name. The id is the series key of the tokenized-equities-by-equity timeseries model.

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

## Endpoints

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

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

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

## Metrics

21 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 stock is tokenized on.             |
| `issuerCount`          | Issuer Count                | float64 |      | Distinct issuers tokenizing the stock.                 |
| `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. |
| `underlyingPriceUSD`   | Underlying Price (USD)      | float64 |      | Closing price of the underlying stock in USD.          |
| `underlyingVolume`     | Underlying Volume           | float64 |      | Traded volume of the underlying stock, in shares.      |
| `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-equities-by-equity timeseries model, the stock ticker in lowercase. (primary key) |
| `name` | string | `Eq`, `IsOneOf`, `Contains` | default | The display name of the stock, its ticker in uppercase.                                                           |

## Example

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

See [Get Equity timeseries](/api-reference/data-api/tokenized-equities/timeseries-tokenized-equities-by-equity-by-id) for the response and the errors.