{"uid":"cap_RUH9IRTdDEaqsQt2IfcZP","slug":"stablecoin-market-data-api-x402-86fe2a79","name":"Stablecoin Market Data API (x402)","description":"Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.","url":"https://kr-x402-mvp.kgy5612.workers.dev/v1/stablecoins?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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","properties":{"top":{"type":"integer","maximum":30,"minimum":1,"description":"Top N by supply when no symbols (default 10)"},"symbols":{"type":"string","examples":["USDC,USDT","USDC"],"description":"Comma-separated filter, e.g. USDC,USDT"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"coins":[{"status":"OK","symbol":"USDC","price_usd":0.99948,"kraken_usd":0.9999,"supply_usd":71356496475,"peg_dev_bps":-5.2,"dominance_pct":24.6,"supply_1d_pct":0.089,"supply_7d_pct":-1.74,"base_supply_usd":4100000000}],"alerts":[],"flow_7d":{"pct":-0.72,"usd":-2100000000},"sources":["https://stablecoins.llama.fi","https://api.kraken.com"],"verdict":"ALL_PEGGED","updated_at":"2026-10-29T12:30:00Z","liquidity_trend":"flat","total_usd_stablecoin_supply":290000000000}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Oi07tIqCri96MJyEN77eT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time stablecoin supply, peg health, dominance, and 7-day flow data for top stablecoins, paid per-call via x402 USDC micropayment.","exampleAgentPrompt":"Check the current peg health and 7-day supply flow for USDC and USDT — I want to know if either has depegged and what the overall stablecoin market trend looks like.","exampleUseCases":[{"title":"Depeg alert before DeFi trade","prompt":"Before I move funds into a yield strategy, check whether USDC and USDT are both properly pegged right now and flag any active depeg alerts."},{"title":"Stablecoin dominance research","prompt":"Show me the top 5 stablecoins by supply, their dominance percentages, and whether supply has been growing or shrinking over the past 7 days."},{"title":"Base chain stablecoin exposure check","prompt":"How much USDC supply is sitting on Base right now, and what's the 7-day flow trend for the overall stablecoin market?"}],"resultDescription":"A JSON object containing an array of stablecoin records (symbol, USD price, Kraken price, peg deviation in basis points, total supply, 7-day supply change, Base chain supply, dominance %), plus aggregate fields: total stablecoin supply, 7-day flow (USD and %), liquidity trend label, peg verdict (e.g. ALL_PEGGED), any alerts, data sources, and an updated_at timestamp.","failureModes":["Payment not received or x402 handshake fails — 402 Payment Required returned","Invalid symbol in 'symbols' param — may return empty coins array or error","top param out of range (must be 1–30) — validation error","Upstream DefiLlama or Kraken API down — stale or partial data returned","No query params provided — defaults to top 10 stablecoins by supply"],"whenToPreferThis":"Choose this endpoint when an AI agent needs real-time stablecoin peg health, supply trends, and dominance data without setting up API keys — especially for onchain trading agents operating on Base that can pay $0.001 USDC per call via x402. Prefer over free alternatives when micropayment-native agent workflows are required and freshness from dual sources (DefiLlama + Kraken) matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:58.666Z","isFirstParty":false,"canonicalSlug":"stablecoin-market-data-api-x402-86fe2a79"}