Base URL
https://eurostablecoins.xyz/api/v1
All endpoints return JSON. CORS is enabled for any origin. No authentication is required.
Endpoint categories
- Meta —
/api/v1,/coins,/coins/{id},/overview - Supply —
/supply,/supply/{id},/supply/{id}/{chain},/history/supply/{id},/history/supply/{id}/{chain} - Peg —
/peg,/peg/{id},/history/peg/{id} - Activity —
/history/mint-burn/{id},/history/transfer-volume/{id} - Holders —
/holders/{id}
Full schema and parameters are documented at /docs.
Example requests
# Latest market overview curl https://eurostablecoins.xyz/api/v1/overview # Latest EURC supply across all chains curl https://eurostablecoins.xyz/api/v1/supply/eurc # 90-day peg history for EURC curl "https://eurostablecoins.xyz/api/v1/history/peg/eurc?period=90d" # Latest holder snapshot for EUROP curl https://eurostablecoins.xyz/api/v1/holders/europ
Example response
GET /api/v1/supply/eurc
{
"coin_id": "eurc",
"ticker": "EURC",
"name": "EURC",
"issuer": "Circle",
"total_supply": 423827536.00,
"circulating_supply": 366849221.26,
"treasury_held": 56978314.74,
"chain_breakdown": { "ethereum": 202817723.11, "solana": 105019323.32, ... },
"currency": "EUR",
"recorded_at": "2026-04-30T...Z",
"source": "https://eurostablecoins.xyz"
}Coin IDs
Path parameters use lowercase IDs:
eurceursaeureurcveurieureeuraeurqeurreuropheuroeuraudeuroCaching
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; please cache on your side too.
Citation
Free for any use. Attribution requested. When citing data, include the endpoint URL and the access date. Example:
Source: eurostablecoins.xyz API, accessed 2026-04-30 URL: https://eurostablecoins.xyz/api/v1/supply/eurc
Limitations
- On-chain data may differ slightly from issuer-reported figures.
- Historical depth depends on source availability per coin and chain.
- Exchange/venue liquidity is not currently published.
- Legal/regulatory metadata may be partial; check issuer/regulator sources.
Stability
Endpoints under /api/v1/* follow stable contracts. Field additions are non-breaking. Breaking changes would be released under a new namespace with overlap. See /docs.