{"uid":"cap_Fmodz6dBcbGzYv0k3VbEk","slug":"stablecoin-prices-peg-health-via-defillama-x402-82d27744","name":"Stablecoin Prices & Peg Health via DeFiLlama (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-prices?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_uI4wvcdQXR4O5xlGztBYA","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 prices, peg deviation, supply trends, Kraken reference price, and market dominance for top stablecoins, paid per-call via x402 USDC.","exampleAgentPrompt":"Check the current peg health and supply trends for USDC and USDT — I want to know if either is deviating from $1 and how their 7-day flows look.","exampleUseCases":[{"title":"Pre-trade stablecoin safety check","prompt":"Before I swap into USDC, check whether it's holding its peg — give me the peg deviation in basis points and the 7-day supply change."},{"title":"Stablecoin market dominance snapshot","prompt":"Pull the top 5 stablecoins by supply right now and tell me their market dominance percentages and whether any are showing depeg risk."},{"title":"Automated depeg alert for trading bot","prompt":"I need you to check the stablecoin peg status for USDC, USDT, and DAI and flag any that are off-peg by more than 20 basis points."}],"resultDescription":"Returns a JSON object with a list of stablecoins each containing: symbol, USD price, Kraken reference price, peg deviation in basis points, market dominance %, 1-day and 7-day supply changes, Base chain supply, and an overall verdict (e.g. ALL_PEGGED). Also includes 7-day aggregate flow in USD and %, total stablecoin market supply, liquidity trend, any active alerts, data sources, and an updated_at timestamp.","failureModes":["Payment not received via x402 → 402 Payment Required response","Invalid symbol string (e.g. misspelled ticker) → empty coins array or missing entries","top parameter out of range (must be 1–30) → validation error","DeFiLlama or Kraken upstream unavailable → stale or partial data","No symbols and no top param → defaults to top 10 by supply"],"whenToPreferThis":"Use this endpoint when an AI trading or onchain agent needs real-time stablecoin peg health and supply data without managing API keys — paying only $0.001 USDC per call via x402. Prefer this over general price APIs when peg deviation (basis points), supply trends, and a human-readable depeg verdict are specifically needed. It is especially useful in pre-trade safety checks, risk monitoring loops, and onchain agents that need lightweight, pay-as-you-go access.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:21.081Z","isFirstParty":false,"canonicalSlug":"stablecoin-prices-peg-health-via-defillama-x402-82d27744"}