{"uid":"cap_ZbJdL16t76bdz-j_bMah0","slug":"stablecoin-market-data-via-x402-24cf6fca","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/api/defillama/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_h_bYY4vpzrXAsRKUJ8tQA","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, payable per-call via x402 USDC on Base.","exampleAgentPrompt":"Check if USDC and USDT are holding their pegs right now — show me peg deviation in basis points, current supply, and whether there are any depeg alerts for the top 5 stablecoins.","exampleUseCases":[{"title":"Depeg alert monitoring for trading bot","prompt":"Are any of the top 10 stablecoins currently depegging? Give me the peg deviation in basis points and any active alerts right now."},{"title":"USDC vs USDT supply comparison","prompt":"Pull the latest supply and 7-day flow data for USDC and USDT so I can see which one is growing and which is shrinking."},{"title":"Stablecoin dominance snapshot for portfolio report","prompt":"Give me the current dominance percentage and total USD supply for each of the top 5 stablecoins — I need a snapshot of the stablecoin market for my weekly report."}],"resultDescription":"A JSON object containing an array of stablecoin records (each with symbol, USD price, Kraken spot price, peg deviation in basis points, supply in USD, dominance percentage, 1-day and 7-day supply change percentages, and Base chain supply), plus aggregate 7-day flow data, a peg verdict (e.g. ALL_PEGGED), liquidity trend label, total stablecoin market supply, any active alerts, data sources, and an updated_at timestamp.","failureModes":["Invalid or unrecognized symbol strings return empty coin arrays","top parameter out of range (must be 1–30) returns validation error","Upstream DefiLlama or Kraken API outage may cause stale or missing data","Payment failure via x402 (insufficient USDC balance on Base) blocks the request","Network timeout from the Cloudflare Worker if upstream APIs are slow"],"whenToPreferThis":"Choose this endpoint when an AI agent needs real-time stablecoin peg health, supply, and dominance data without requiring API key setup — ideal for autonomous trading or onchain agents that pay per call with USDC via x402. Prefer this over manual DefiLlama scraping when you need Kraken-cross-validated prices and peg deviation already computed in basis points. Not suitable for historical time-series or non-stablecoin token data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:33:01.659Z","isFirstParty":false,"canonicalSlug":"stablecoin-market-data-via-x402-9f7844e7"}