{"name":"Euro Stablecoins API","version":"v1","description":"Public API for tracking supply, peg, activity, holders, and chain distribution of euro stablecoins.","base_url":"https://www.eurostablecoins.xyz/api/v1","docs_page":"https://www.eurostablecoins.xyz/docs","cors":"enabled (Access-Control-Allow-Origin: *)","cache":"Authorized /api/v1 responses are Cache-Control: private, no-store (Vary: Authorization, x-api-key). Never cache an authorized response or share a key across users.","auth":{"type":"api_key","access":"Requires an active EUR 49/month subscription and a personal API key.","free_api_access":false,"required":false,"required_at":null,"how_to_send":"Authorization: Bearer <key>  (or)  x-api-key: <key>  — never in a URL or query string","subscribe_url":"https://www.eurostablecoins.xyz/account","rate_limit":"120 requests/minute per key; 429 RATE_LIMITED + Retry-After when exceeded","errors":{"400":["API_KEY_IN_URL","API_KEY_CONFLICT"],"401":["API_KEY_REQUIRED","API_KEY_INVALID","API_KEY_REVOKED","API_KEY_EXPIRED"],"403":["SUBSCRIPTION_REQUIRED"],"429":["RATE_LIMITED"],"503":["VERIFICATION_UNAVAILABLE"],"format":"{ \"error\": { \"code\": \"...\", \"message\": \"...\" } }"},"csv":"The subscription also includes official CSV exports, downloaded from the logged-in website (session-authenticated). API keys do NOT authenticate CSV downloads.","cancellation":"On cancellation, access continues until the end of the paid period; once entitlement ends, the API and CSV stop returning data.","note":"Registration alone does not grant API access. The discovery root and /api/v1/openapi.json are the only keyless endpoints. When \"required\" is false the gate is not yet enforced (pre-enforcement compatibility) — do not rely on keyless access."},"license":"API access requires an active EUR 49/month subscription. Data retrieved through the API remains licensed CC BY 4.0 with attribution: \"Data from eurostablecoins.xyz\".","contact":{"telegram":"https://t.me/Craael","twitter":"https://x.com/Matt_Oksa","linkedin":"https://www.linkedin.com/in/matt-oksa/"},"endpoints":{"meta":[{"method":"GET","path":"/api/v1","description":"This documentation"},{"method":"GET","path":"/api/v1/coins","description":"List all active coins with metadata + current state"},{"method":"GET","path":"/api/v1/coins/{coin_id}","description":"Single coin metadata + current state"},{"method":"GET","path":"/api/v1/overview","description":"Aggregated market stats: total cap, MiCA breakdown, HHI, dominance"}],"supply":[{"method":"GET","path":"/api/v1/supply","description":"Latest supply snapshot for all coins"},{"method":"GET","path":"/api/v1/aggregate-supply","description":"Aggregate supply across all coins (market total + per-coin breakdown)"},{"method":"GET","path":"/api/v1/supply/{coin_id}","description":"Latest supply snapshot for one coin"},{"method":"GET","path":"/api/v1/supply/{coin_id}/{chain}","description":"Latest supply for one coin on one specific chain (e.g. europ/solana)"},{"method":"GET","path":"/api/v1/history/supply/{coin_id}","description":"Daily supply history (use ?period=30d|90d|1y|2y|max or ?start=YYYY-MM-DD&end=YYYY-MM-DD)"},{"method":"GET","path":"/api/v1/history/supply/{coin_id}/{chain}","description":"Daily supply history for one chain (use ?period=...)"}],"peg":[{"method":"GET","path":"/api/v1/peg","description":"Latest peg metrics for all coins (price, deviation, rolling averages)"},{"method":"GET","path":"/api/v1/peg/{coin_id}","description":"Latest peg metrics for one coin"},{"method":"GET","path":"/api/v1/history/peg/{coin_id}","description":"Daily peg/price history (use ?period=...)"}],"activity":[{"method":"GET","path":"/api/v1/transfer-volume","description":"Peer transfer-volume totals for all coins (?period=7d|14d|30d|3m|6m|12m|all)"},{"method":"GET","path":"/api/v1/transfer-volume/{coin_id}","description":"Peer transfer-volume summary and daily series for one coin (?period=...)"},{"method":"GET","path":"/api/v1/mint-burn/{coin_id}","description":"Latest mint/burn summary for one coin"},{"method":"GET","path":"/api/v1/market-mint-burn","description":"Market-wide mint/burn totals across all coins"},{"method":"GET","path":"/api/v1/history/mint-burn/{coin_id}","description":"Daily mint/burn history (?period=...)"},{"method":"GET","path":"/api/v1/history/transfer-volume/{coin_id}","description":"Daily transfer volume + active addresses (?period=...)"}],"holders":[{"method":"GET","path":"/api/v1/holders/{coin_id}","description":"Latest holder snapshot (no historical backfill)"}],"markets":[{"method":"GET","path":"/api/v1/markets","description":"Top-level markets overview — CEX and DEX summary counts, generated timestamps, cadence notes"},{"method":"GET","path":"/api/v1/markets/cex","description":"All direct CEX market data — exchange, symbol, price, bid/ask, spread, 24h volume (CCXT direct exchange feeds)"},{"method":"GET","path":"/api/v1/markets/cex/{coin_id}","description":"CEX market data for one coin; 404 for unknown coin; empty array with note if no coverage"},{"method":"GET","path":"/api/v1/markets/dex","description":"Latest DEX pool snapshots — price, liquidity, 24h volume, tx counts across all tracked EUR stablecoin pairs"},{"method":"GET","path":"/api/v1/markets/dex/{coin_id}","description":"DEX pool data for one coin; 404 for unknown coin; empty array with note if no coverage"},{"method":"GET","path":"/api/v1/markets/{coin_id}","description":"Combined CEX + DEX market data for one coin in a single response"}]},"valid_coin_ids":["eurc","eurs","aeur","eurcv","euri","eure","eura","eurq","eurr","europ","heuro","eurau","eurod","deuro","eurm","eur0","euros","jeur","par","seur","veur","euro3","blueur","breur","eurxt","eursm","eurd","euroe","eneur","eurpa","eurw","mykoboeurc","dforceeux","biteur"],"transfer_volume_period_values":["7d","14d","30d","3m","6m","12m","all"],"history_period_values":["7d","14d","30d","3m","90d","6m","12m","1y","2y","all","max"],"data_freshness":{"supply":"Every 4 hours (scheduled 00:05, 04:05, 08:05, 12:05, 16:05, 20:05 UTC; best-effort scheduler — recorded_at on each response is the authoritative collection time)","peg":"Every 6 hours (00:35, 06:35, 12:35, 18:35 UTC) — coins with a tracked public price source only","activity":"Daily at 08:30 UTC — peer transfer volume reconstructed from canonical on-chain transfers; mint and burn excluded","holders":"Daily at 10:00 UTC","dex":"Every 6 hours"}}