EUR stablecoin data, as JSON.

curl -H "Authorization: Bearer $ESK_KEY" https://www.eurostablecoins.xyz/api/v1/overview
curl -H "x-api-key: $ESK_KEY" https://www.eurostablecoins.xyz/api/v1/supply/eurc
curl -H "Authorization: Bearer $ESK_KEY" "https://www.eurostablecoins.xyz/api/v1/history/peg/eurc?period=30d"

{
  "coin_id": "eurc",
  "ticker": "EURC",
  "name": "EURC",
  "issuer": "Circle",
  "total_supply": 208450000,
  "total_onchain_supply": null,
  "onchain_supply_by_chain": null,
  "circulating_supply": 208450000,
  "treasury_held": 0,
  "chain_breakdown": {
    "ethereum": 121300000,
    "base": 62400000,
    "solana": 18900000,
    "avalanche": 5850000
  },
  "currency": "EUR",
  "recorded_at": "2026-08-06T04:12:00.000Z",
  "source": "https://www.eurostablecoins.xyz"
}

Stable lowercase identifier for a coin. Examples: eurc, eurs, euri, deuro, heuro. Same as the URL slug on coin detail pages. Valid values are listed in the Coin IDs section below and returned by /api/v1.

Query parameter accepted by all /history/* endpoints. Values: 7d · 14d · 30d · 3m · 90d · 6m · 12m · 1y · 2y · all · max. Default: 30d. Alternatively use ?start=YYYY-MM-DD and optionally ?end=YYYY-MM-DD for a custom range.

Chain key for /supply/{id}/{chain} and /history/supply/{id}/{chain}. Valid values depend on which chains a given coin is deployed on. Common keys: ethereum, polygon, arbitrum, base, optimism, avalanche, gnosis, solana, xrpl, stellar, algorand.

Missing rows in a series response are real omissions — they are not zeros. Activity history depth and peg coverage vary by coin. A coin absent from /v1/peg has no tracked public price source.

curl https://www.eurostablecoins.xyz/api/v1/overview

Data is cached internally for up to 5 minutes via unstable_cache; the HTTP response is private and never shared/CDN-cached (Cache-Control: private, no-store).

curl "https://www.eurostablecoins.xyz/api/v1/history/supply/eurc?period=30d"

History depth varies by coin. Coverage gaps are real omissions, not zeros.

curl https://www.eurostablecoins.xyz/api/v1/peg

Coins without an independent price source are omitted.

curl https://www.eurostablecoins.xyz/api/v1/peg/eurc

Returns 404 if the coin has no tracked price source.

curl "https://www.eurostablecoins.xyz/api/v1/history/mint-burn/eurc?period=30d"

Coverage varies by coin. Some assets have partial history; others have no mint/burn data.

curl "https://www.eurostablecoins.xyz/api/v1/transfer-volume?period=30d"

Mint, burn and self-transfers are excluded. Mathematically inconsistent and non-canonical rolling-window rows are rejected.

curl "https://www.eurostablecoins.xyz/api/v1/transfer-volume/eurc?period=30d"

Unavailable or partial coverage is returned explicitly, never converted to zero coverage.

curl "https://www.eurostablecoins.xyz/api/v1/history/transfer-volume/eurc?period=30d"

Transfers are reconstructed from on-chain Transfer events. Mint/burn transfers are excluded. Coverage varies by coin and chain.

curl https://www.eurostablecoins.xyz/api/v1/holders/eurc

No historical holder series is published. Snapshot cadence is daily. The source field encodes data quality per chain.

curl https://www.eurostablecoins.xyz/api/v1/markets/cex

CEX data is collected daily at 06:00 UTC via CCXT direct exchange APIs. Cached server-side for 1 hour. Prices and volumes are in each pair's native quote currency — not USD-normalised.

curl https://www.eurostablecoins.xyz/api/v1/markets/dex

DEX data is collected every 6 hours. Cached server-side for 1 hour. If the stored snapshot is stale the API falls back to a live fetch (fallback_live_fetch: true), which increases response time.

curl https://www.eurostablecoins.xyz/api/v1/markets/eurc

Combines /v1/markets/cex/{id} and /v1/markets/dex/{id} in one call. CEX and DEX keys are always present; inner arrays are empty when no coverage exists for that type.

No holder history — /v1/holders/{id} returns only the latest daily snapshot. There is no backfilled time series.

Peg coverage is a subset — coins not tracked by a public price feed are absent from /v1/peg and /v1/history/peg. A 404 response does not indicate a problem with the coin.

Activity coverage varies — not all coins have mint/burn or transfer history. Early periods may be sparse. A missing row is a real gap, not a zero.

XRPL holder counts may be floor estimates — if EURS pagination on XRPL reaches the page cap, the source field includes _partial and the count is a lower bound.

Snapshots are not real-time — data is collected on cron cadence and cached server-side. The freshness cadence table above shows the worst-case staleness per domain.

Treasury subtraction — circulating_supply subtracts only publicly identifiable treasury wallets. For ordinary coins where no wallets are identified, circulating_supply equals total_supply.

Unresolved circulating methodology — for a few coins the circulating basis is undefined (an unreconciled multi-chain on-chain total, or a collateralized-synthetic nominal). These return circulating_supply: null. For multi-chain totals (e.g. EURW) the combined amount is exposed under total_onchain_supply / onchain_supply_by_chain with total_supply null, and is never summed into the headline aggregate.