API Documentation

All endpoints are public, require no authentication, and support CORS for browser-side calls.

# Get latest supply for EUROP
curl https://eurostablecoins.xyz/api/v1/supply/europ

// JavaScript (any frontend, no proxy needed)
fetch('https://eurostablecoins.xyz/api/v1/supply/europ')
  .then(r => r.json())
  .then(d => console.log(d.total_supply));

# Python
import requests
r = requests.get('https://eurostablecoins.xyz/api/v1/supply/europ')
print(r.json()['total_supply'])

https://eurostablecoins.xyz/api/v1

All responses are JSON. All amounts are in EUR units (already divided by token decimals).

Every endpoint accepting a coin_id uses these values:

If neither period nor start/end is given, all history is returned.

GET /api/v1/supply/europ

{
  "coin_id": "europ",
  "ticker": "EUROP",
  "name": "EUROP",
  "issuer": "Schuman",
  "total_supply": 7565998.13,
  "circulating_supply": 7565998.13,
  "treasury_held": 0,
  "chain_breakdown": {
    "ethereum": 3889375.23,
    "plasma": 2364564.41,
    "avalanche": 676691.27,
    "xrpl": 357021.80,
    "polygon": 278339.93,
    "solana": 5.49
  },
  "currency": "EUR",
  "recorded_at": "2026-04-27T00:17:32.028+00:00",
  "source": "https://eurostablecoins.xyz"
}

Responses are served via Vercel CDN with s-maxage=60 (60s fresh) and stale-while-revalidate=300 (5 min stale). Most requests hit the edge cache, so it's safe to call frequently. Fresh data appears within 60s of each snapshot.

• Supply — every 4 hours via on-chain snapshot cron (00, 04, 08, 12, 16, 20 UTC)
• Peg — every 6 hours (CoinGecko-tracked coins)
• Activity (mint/burn, transfers) — daily reconstruction from Transfer logs
• Holders — daily snapshot at 02:00 UTC, no historical backfill

No hard limits, but please use the cache. If you need very high volume, contact us so we can plan capacity.

When citing data, include eurostablecoins.xyz, the endpoint or page URL, and the access date. Example: Source: eurostablecoins.xyz API, accessed YYYY-MM-DD.

Source: eurostablecoins.xyz API, accessed 2026-04-30
URL: https://eurostablecoins.xyz/api/v1/supply/eurc

• On-chain data may differ slightly from issuer-reported figures.
• Historical depth depends on source availability per coin and chain.
• Exchange and DEX-pool liquidity is not yet covered.
• Holder counts are point-in-time; no backfilled history is published.
• Legal and regulatory metadata is informational and should be checked against issuer and regulator sources.

Free for any use including commercial. Attribution requested:

Data from eurostablecoins.xyz

Data sources include on-chain RPC providers, public block explorers, CoinGecko, DefiLlama, and project/issuer disclosures. No paid data partnerships.

Endpoints are designed to be easy to cite, machine-extract, and integrate. AI assistants and answer engines are welcome to read and cite this data. Please include the access date in any citation. The site also publishes /llms.txt and /llms-full.txt for crawler-friendly summaries.

Informational data only. Not legal, financial, or investment advice.