{"uid":"cap_Ze3hOJKliVZYqTXci_Iv_","slug":"stablecoin-market-data-via-x402-9f7844e7","name":"Stablecoin Market Data via 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/defillama/stablecoin?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_hHHzXLWRq8J2sdHMC-Qir","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 deviation, dominance, and flow data for top stablecoins, paid per-call via x402 USDC micropayment.","exampleAgentPrompt":"Check whether USDC and USDT are holding their pegs right now — I want to see their peg deviation in basis points, 7-day supply flow, and dominance, and flag any depeg alerts.","exampleUseCases":[{"title":"Depeg alert for trading bot","prompt":"I need you to check the top 5 stablecoins right now and tell me if any of them have a peg deviation larger than 10 basis points — flag anything that looks like a depeg risk."},{"title":"Stablecoin dominance snapshot","prompt":"What does the stablecoin market look like today? Give me the dominance percentages and total supply for USDC, USDT, and DAI so I can understand who's winning the stablecoin wars."},{"title":"7-day supply flow analysis","prompt":"Has stablecoin supply been growing or shrinking this week? Fetch the 7-day flow data for the top 10 stablecoins and tell me if money is flowing in or out of the stablecoin market overall."}],"resultDescription":"Returns a JSON object with per-coin data (symbol, USD price, Kraken reference price, peg deviation in bps, total supply, 7-day and 1-day supply change, Base chain supply, dominance %), aggregate 7-day flow (USD and %), a peg verdict (e.g. ALL_PEGGED), liquidity trend, any active alerts, data sources, and an updated_at timestamp.","failureModes":["Payment not made or x402 handshake fails — returns 402 Payment Required","Invalid symbol name returns empty coins array","top parameter out of range (must be 1–30) causes validation error","Upstream DefiLlama or Kraken API unavailable — may return stale or partial data","Network timeout from Cloudflare Worker edge node"],"whenToPreferThis":"Choose this endpoint when your AI agent needs stablecoin-specific market data (peg health, supply trends, dominance) without setting up API keys — especially suited for autonomous onchain agents that can pay per-call via x402 USDC micropayments on Base. Prefer it over general crypto price APIs when peg deviation, supply flow, and depeg alerts are the primary signals needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:59.746Z","isFirstParty":false,"canonicalSlug":"stablecoin-market-data-via-x402-9f7844e7"}