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

# Stablecoins by Deployment

> Stablecoin metrics for one token contract on one chain: circulating supply, mints and burns, where the supply sits (protocol-owned, bridges, CEX, DEX, wrapped, managed, lending, CDPs, staking, treasuries and other labeled holders, unlabeled wallets), lending deposits, borrows, flows, APYs and liquidations, holders, spot DEX volume and transfers. Each series is one deployment, keyed by chain and contract address; a bridged copy is its own deployment. Many series, so name the deployments you need.

One row per stablecoin deployment, one token contract on one chain, keyed by chain and contract address: symbol, token and product ids, the product a bridged copy represents, issuer, peg currency and sector, the chain and the mapped network and issuer project records. The id is the series key of the stablecoins-by-deployment timeseries model.

| | |
| - | - |
| Access | Stablecoins-dataset |
| Tabular model | `stablecoin-deployments`: primary key `id` |
| Timeseries model | `stablecoins-by-deployment`: intervals `1d`, series key `id` (Stablecoin Deployment ID), series must be named (up to 10 per call) |

## Endpoints

> [card] [List Stablecoin Deployments](https://docs.blockworks.com/api-reference/data-api/stablecoins/tabular-stablecoin-deployments.md)
>
> One page of rows with per-column filters, sorting and pagination.

> [card] [Batch Get Stablecoin Deployment timeseries](https://docs.blockworks.com/api-reference/data-api/stablecoins/timeseries-stablecoins-by-deployment.md)
>
> Up to 10 series in one request, named by Stablecoin Deployment ID in `series`.

> [card] [Get Stablecoin Deployment timeseries](https://docs.blockworks.com/api-reference/data-api/stablecoins/timeseries-stablecoins-by-deployment-by-id.md)
>
> One series over a time window, keyed by its Stablecoin Deployment ID.

## Metrics

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

| Field | Name | Type | Unit | Description |
| - | - | - | - | - |
| `circulatingSupplyUSD` | Circulating Supply (USD) | float64 | | Circulating supply in USD. |
| `mintAmountUSD` | Mint Amount (USD) | float64 | | Value minted in USD. |
| `burnAmountUSD` | Burn Amount (USD) | float64 | | Value burned in USD (negative). |
| `mintCount` | Mint Count | float64 | | Number of mint events. |
| `burnCount` | Burn Count | float64 | | Number of burn events. |
| `balanceProtocolOwnedUSD` | Balance Protocol-Owned (USD) | float64 | | Supply held in protocol-owned wallets in USD. |
| `balanceBridgeUSD` | Balance in Bridges (USD) | float64 | | Supply held in bridge contracts in USD. |
| `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. |
| `balanceWrappedUSD` | Balance Wrapped (USD) | float64 | | Supply held in wrapping contracts in USD. |
| `balanceYieldDerivativesUSD` | Balance in Yield Derivatives (USD) | float64 | | Supply held in yield derivative protocols in USD. |
| `balanceManagedUSD` | Balance Managed (USD) | float64 | | Supply held in managed vaults and strategies in USD. |
| `balanceCDPUSD` | Balance in CDPs (USD) | float64 | | Supply held in collateralized debt position (CDP) protocols in USD. |
| `balanceBlacklistUSD` | Balance Blacklisted (USD) | float64 | | Supply held in blacklisted addresses in USD. |
| `balancePredictionMarketUSD` | Balance in Prediction Markets (USD) | float64 | | Supply held in prediction-market contracts in USD. |
| `balanceTreasuriesUSD` | Balance in Treasuries (USD) | float64 | | Supply held in treasury wallets in USD. |
| `balancePrivacyUSD` | Balance in Privacy Protocols (USD) | float64 | | Supply held in privacy protocols in USD. |
| `balancePaymentsUSD` | Balance in Payments (USD) | float64 | | Supply held in payment wallets in USD. |
| `balanceStakingUSD` | Balance Staked (USD) | float64 | | Supply held in staking contracts in USD. |
| `balanceBuybackUSD` | Balance in Buybacks (USD) | float64 | | Supply held in buyback wallets 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. |
| `lendingDepositsUSD` | Lending Deposits (USD) | float64 | | Deposited in lending protocols in USD. |
| `lendingBorrowedUSD` | Lending Borrowed (USD) | float64 | | Borrowed against in 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 | | Deposit-weighted average lending supply APY (0-1). |
| `lendingBorrowAPY` | Lending Borrow APY | float64 | | Borrow-weighted average lending borrow APY (0-1). |
| `lendingCollateralSeizedUSD` | Lending Collateral Seized (USD) | float64 | | Collateral seized in liquidations in USD. |
| `lendingLiquidationLossUSD` | Lending Liquidation Loss (USD) | float64 | | Liquidation losses in USD. |
| `lendingLiquidationCount` | Lending Liquidation Count | float64 | | Number of liquidations. |
| `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. |
| `transferUniqueSenders` | Transfer Unique Senders | float64 | | Distinct sending addresses. |
| `transferUniqueReceivers` | Transfer Unique Receivers | float64 | | Distinct receiving addresses. |

## 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 stablecoins-by-deployment timeseries model, the chain and token address joined with an underscore. (primary key) |
| `name` | string | `Eq`, `IsOneOf`, `Contains` | default | The deployment's display name, the symbol and chain. |
| `symbol` | string | `Eq`, `IsOneOf`, `Contains` | yes | The token's ticker symbol. |
| `tokenID` | string | `Eq`, `IsOneOf` | | The token id of this contract, the series key of the stablecoins-by-product timeseries model. |
| `productID` | string | `Eq`, `IsOneOf` | | The lowercase symbol, shared by token ids that label the same coin on different chains. |
| `referenceTokenID` | string | `Eq`, `IsOneOf` | | The token id of the product this contract represents, the underlying token for a bridged copy (USDC.e resolves to USDC) and otherwise its own token id. |
| `underlyingTokenID` | string | `Eq`, `IsOneOf` | | The token id of the product a bridged copy represents; null for a native deployment. |
| `tokenAddress` | string | `Eq`, `IsOneOf` | | The token contract address (the mint address on Solana). |
| `chain` | string | `Eq`, `IsOneOf` | yes | The short name of the chain (ethereum, base, solana). |
| `issuerID` | string | `Eq`, `IsOneOf` | | The identifier of the issuing company. |
| `pegCurrency` | string | `Eq`, `IsOneOf` | | The currency the stablecoin is pegged to. |
| `tokenSector` | string | `Eq`, `IsOneOf` | | The peg currency bucket the token is filed under. |
| `networkID` | string | `Eq`, `IsOneOf` | | The chain's networkID in the blockchains model; null when unmapped. |
| `networkSlug` | string | `Eq`, `IsOneOf` | | The chain's slug in the blockchains model; null when unmapped. |
| `projectID` | string | `Eq`, `IsOneOf` | | The identifier of the issuer's project record; null when unmapped. |
| `projectSlug` | string | `Eq`, `IsOneOf` | | The slug of the issuer's project record; null when unmapped. |

## Example

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

See [Get Stablecoin Deployment timeseries](https://docs.blockworks.com/api-reference/data-api/stablecoins/timeseries-stablecoins-by-deployment-by-id.md) for the response and the errors.


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