# DefiLlama Stablecoin Market Cap by Chain (Historical)

> DefiLlama Stablecoin Market Cap by Chain (Historical) is a paid API for AI agents from defillama.use.x402atlas.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Returns historical circulating-supply time series for stablecoins on a single blockchain chain from DefiLlama.

## Facts

- Endpoint: GET https://defillama.use.x402atlas.com/stablecoin-charts-chain
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defillama-stablecoin-market-cap-by-chain-historical-2d842ef3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0veEcvhRNFzqD-1ue1zzw

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability defillama-stablecoin-market-cap-by-chain-historical-2d842ef3
```

Example prompt: Pull me the historical stablecoin circulating-supply chart for Ethereum from DefiLlama — specifically for Tether (stablecoin id 1) — so I can see how the market cap has changed over time.

## When to prefer this

Use this endpoint when you need chain-specific historical stablecoin circulating supply data rather than aggregate cross-chain totals. Prefer this over the global stablecoin chart endpoint when the analysis is scoped to one blockchain (e.g. Ethereum, Arbitrum, Polygon). Use the optional stablecoin id parameter to narrow results to a single asset like Tether or USDC.

## Known failure modes

- Invalid or unrecognized chain name returns an error or empty dataset
- Unknown stablecoin id returns empty or error response
- Payment not processed (402) blocks access
- Rate limiting if too many calls are made
- Network timeouts for slow upstream DefiLlama API responses

## How this service works

Historical stablecoin market cap on one chain from DefiLlama — circulating-supply time series for a single chain.

## Output

A time series array of stablecoin circulating supply data points for the specified chain, optionally scoped to a single stablecoin by DefiLlama id. Each data point includes a timestamp and the total or per-stablecoin supply figures on that chain.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "chain"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "pattern": "^[^/?#]+$",
       "maxLength": 100,
       "minLength": 1,
       "description": "Chain name (e.g. Ethereum, Arbitrum)"
      },
      "stablecoin": {
       "type": "string",
       "maxLength": 200,
       "description": "Optional DefiLlama stablecoin id to scope the chart (e.g. 1 for Tether)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "queried_at",
      "data"
     ],
     "properties": {
      "data": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "date": {
          "type": "string",
          "description": "Unix timestamp (seconds) as a string"
         },
         "totalCirculatingUSD": {
          "type": "object",
          "description": "Total circulating stablecoin USD on this chain and date, keyed by peg type (e.g. peggedUSD)"
         }
        }
       }
      },
      "queried_at": {
       "type": "string",
       "format": "date-time",
       "description": "Time the upstream was queried"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "date": "1656633600",
    "totalCirculatingUSD": {
     "peggedUSD": 80000000000
    }
   }
  ],
  "queried_at": "2026-07-01T12:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defillama-stablecoin-market-cap-by-chain-historical-2d842ef3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from defillama.use.x402atlas.com](https://www.zero.xyz/host/defillama.use.x402atlas.com/llms.txt)