{"openapi":"3.1.0","info":{"title":"ApiToll — Crypto & DeFi market data for AI agents","description":"ApiToll runs pay-per-call data agents on x402 (USDC on Base + Solana). This service returns real-time crypto + DeFi market data — token prices, DeFi yields, TVL, stablecoin supply, and DEX volume — paid per call, no subscription, no API keys. Sourced from DefiLlama across every major chain.","contact":{"email":"eldeebomar@gmail.com"},"version":"1.0.0","x-guidance":"Flat $0.001 per call across every route. Call GET /v1/crypto/price?coins=BTC,ETH for prices, /v1/crypto/yields for APYs, /v1/crypto/tvl for chain/protocol TVL, /v1/crypto/stablecoins for stablecoin supply, /v1/crypto/dex for DEX volume. 4xx/5xx never charge."},"servers":[{"url":"https://crypto.apitoll.cloud"}],"tags":[{"name":"crypto","description":"Crypto market data"},{"name":"defi","description":"DeFi protocols + metrics"},{"name":"prices","description":"Token prices"},{"name":"market-data","description":"Real-time market data"},{"name":"apitoll","description":"ApiToll factory family"}],"paths":{"/v1/crypto/price":{"get":{"operationId":"getCryptoPrice","summary":"Live + historical token prices by symbol, coingecko id, or chain:address","description":"Latest crypto token prices by ticker symbol, CoinGecko id, or chain:address (BTC, ETH, SOL, or base:0x…): current spot price, token symbol, decimals, and a confidence score, for up to 50 coins in one call. Pass ?at=<unix> for the historical price at a point in time. Sourced from DefiLlama across every major chain.","tags":["crypto","prices","token-price","defi"],"x-keywords":["crypto price","token price","bitcoin price","ethereum price","spot price","historical price","coingecko","defillama","market data"],"x-use-cases":["Portfolio + position valuation","Price a token by contract address on any chain","Backfill historical prices for a timestamp"],"parameters":[{"name":"coins","in":"query","required":false,"schema":{"type":"string","default":"BTC,ETH,SOL"},"description":"Comma-separated symbols (BTC,ETH), coingecko ids (coingecko:solana), or chain:address (base:0x833…). Up to 50."},{"name":"at","in":"query","required":false,"schema":{"type":"integer"},"description":"Unix seconds for a historical price snapshot. Omit for current."}],"security":[{"x402":[]}],"x-payment-info":{"protocols":[{"x402":{"version":2,"network":"eip155:8453","asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3dA40A9aD36640a2C0F533BAC368490095574664","scheme":"exact","price":"$0.001"}},{"x402":{"version":2,"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","assetAddress":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"5Wxg3V6gcmFmmP6SXmGZQAUZPFYsSwoeN2Qewt5BotWz","scheme":"exact","price":"$0.001"}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"asOf":{"type":"string"},"historical":{"type":"boolean"},"requested":{"type":"number"},"count":{"type":"number"},"prices":{"type":"array","items":{"type":"object","properties":{"query":{"type":"string"},"key":{"type":"string"},"resolved":{"type":"boolean"},"symbol":{"type":"string"},"price":{"type":"number"},"decimals":{},"confidence":{"type":"number"},"timestamp":{"type":"number"}}}},"unresolved":{"type":"array","items":{"type":"object"}},"source":{"type":"object","properties":{"name":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Sign an x402 payment authorization and retry.","headers":{"Payment-Required":{"schema":{"type":"string"},"description":"Base64-encoded x402 v2 challenge."}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No data for this query (unknown token / empty filter) — not charged."},"405":{"description":"Method not allowed — use GET."},"502":{"description":"DefiLlama upstream unavailable — not charged."}}}},"/v1/crypto/yields":{"get":{"operationId":"getCryptoYields","summary":"DeFi yield/APY pools by chain, protocol, or asset — TVL, APY, reward split","description":"Highest-yield DeFi pools across every chain and protocol, filterable by chain, project, or asset symbol: each pool returns TVL in USD, total APY with base/reward split, stablecoin flag, impermanent-loss risk, and exposure. Sort by APY or TVL, and set sustainable=true to exclude IL-risky pure reward-emission farms. Find where to earn yield on USDC, ETH, SOL and more. Sourced from DefiLlama.","tags":["crypto","defi","yield","apy"],"x-keywords":["defi yield","apy","best yield","sustainable yield","staking rewards","lending rates","liquidity pool","usdc yield","eth staking","defillama"],"x-use-cases":["Find the best APY for a given asset","Screen pools by chain/protocol with a TVL floor","Sustainable real-yield only (sustainable=true)"],"parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string"},"description":"Filter to one chain (exact, case-insensitive): Ethereum, Solana, Base, Arbitrum…"},{"name":"project","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by protocol/project substring: aave, lido, uniswap…"},{"name":"symbol","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by pool asset substring: USDC, ETH, SOL…"},{"name":"minTvlUsd","in":"query","required":false,"schema":{"type":"number","default":10000},"description":"Minimum pool TVL in USD (default 10000 to hide dust)."},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["tvl","apy"],"default":"tvl"},"description":"Sort key (default tvl)."},{"name":"sustainable","in":"query","required":false,"schema":{"type":"boolean"},"description":"When true, keep only real-yield pools: no impermanent-loss risk, an organic base APY that outweighs reward-token emissions, and a plausible APY (drops transient spikes)."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Max pools returned (1–100, default 20)."}],"security":[{"x402":[]}],"x-payment-info":{"protocols":[{"x402":{"version":2,"network":"eip155:8453","asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3dA40A9aD36640a2C0F533BAC368490095574664","scheme":"exact","price":"$0.001"}},{"x402":{"version":2,"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","assetAddress":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"5Wxg3V6gcmFmmP6SXmGZQAUZPFYsSwoeN2Qewt5BotWz","scheme":"exact","price":"$0.001"}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"number"},"totalMatching":{"type":"number"},"filters":{"type":"object","properties":{"chain":{"type":"string"},"symbol":{"type":"string"},"sort":{"type":"string"},"sustainable":{"type":"boolean"}}},"pools":{"type":"array","items":{"type":"object","properties":{"pool":{"type":"string"},"chain":{"type":"string"},"project":{"type":"string"},"symbol":{"type":"string"},"tvlUsd":{"type":"number"},"apy":{"type":"number"},"apyBase":{"type":"number"},"apyReward":{"type":"number"},"stablecoin":{"type":"boolean"},"ilRisk":{"type":"string"},"exposure":{"type":"string"},"outlier":{"type":"boolean"},"apyMean30d":{"type":"number"},"predictedClass":{"type":"string"}}}},"source":{"type":"object","properties":{"name":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Sign an x402 payment authorization and retry.","headers":{"Payment-Required":{"schema":{"type":"string"},"description":"Base64-encoded x402 v2 challenge."}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No data for this query (unknown token / empty filter) — not charged."},"405":{"description":"Method not allowed — use GET."},"502":{"description":"DefiLlama upstream unavailable — not charged."}}}},"/v1/crypto/tvl":{"get":{"operationId":"getCryptoTvl","summary":"Total Value Locked by chain or protocol — current TVL + 1d/7d change","description":"DeFi Total Value Locked (TVL) by blockchain or by protocol. Default returns the top chains ranked by TVL in USD; pass ?chain=Ethereum for one chain, or ?protocol=aave-v3 for a protocol's current TVL, 24h and 7d change, category, market cap, and the chains it spans. Track capital flows across DeFi. Sourced from DefiLlama.","tags":["crypto","defi","tvl","total-value-locked"],"x-keywords":["tvl","total value locked","defi tvl","protocol tvl","chain tvl","capital flows","defillama","ethereum tvl","solana tvl"],"x-use-cases":["Rank chains by capital locked","Track a protocol's TVL trend (1d/7d change)","Compare DeFi footprint across chains"],"parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string"},"description":"One chain by name (exact, case-insensitive). Omit for the top-chains ranking."},{"name":"protocol","in":"query","required":false,"schema":{"type":"string"},"description":"A protocol by DefiLlama slug (aave-v3, lido, uniswap-v3). Takes precedence over chain. For a parent slug like \"uniswap\" use the /v1/crypto/protocol route."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Top-N chains in the default ranking (1–100, default 20)."}],"security":[{"x402":[]}],"x-payment-info":{"protocols":[{"x402":{"version":2,"network":"eip155:8453","asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3dA40A9aD36640a2C0F533BAC368490095574664","scheme":"exact","price":"$0.001"}},{"x402":{"version":2,"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","assetAddress":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"5Wxg3V6gcmFmmP6SXmGZQAUZPFYsSwoeN2Qewt5BotWz","scheme":"exact","price":"$0.001"}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"string"},"chain":{"type":"object","properties":{"name":{"type":"string"},"tvlUsd":{"type":"number"},"tokenSymbol":{"type":"string"},"chainId":{"type":"number"}}},"source":{"type":"object","properties":{"name":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Sign an x402 payment authorization and retry.","headers":{"Payment-Required":{"schema":{"type":"string"},"description":"Base64-encoded x402 v2 challenge."}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No data for this query (unknown token / empty filter) — not charged."},"405":{"description":"Method not allowed — use GET."},"502":{"description":"DefiLlama upstream unavailable — not charged."}}}},"/v1/crypto/stablecoins":{"get":{"operationId":"getCryptoStablecoins","summary":"Stablecoin supply, peg price, and chains — ranked by circulating USD","description":"Stablecoin market data ranked by USD-equivalent circulating supply: each coin returns its symbol, peg type and mechanism (fiat-backed, crypto-backed, algorithmic), peg currency (USD, EUR, JPY…), current peg price, native circulating supply, USD-converted supply, and the chains it lives on. Filter by symbol or chain. Track USDT, USDC, DAI, USDe, EURC and the rest of the stablecoin market. Sourced from DefiLlama.","tags":["crypto","stablecoins","usdc","usdt"],"x-keywords":["stablecoin","stablecoin supply","usdc supply","usdt market cap","peg","circulating supply","depeg","defillama"],"x-use-cases":["Rank stablecoins by circulating supply","Check a stablecoin's peg price + mechanism","See stablecoin supply on a specific chain"],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by symbol/name substring: USDC, USDT, DAI…"},{"name":"chain","in":"query","required":false,"schema":{"type":"string"},"description":"Filter to stablecoins present on a chain (exact, case-insensitive): Ethereum, Solana, Base…"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Max stablecoins returned (1–100, default 20)."}],"security":[{"x402":[]}],"x-payment-info":{"protocols":[{"x402":{"version":2,"network":"eip155:8453","asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3dA40A9aD36640a2C0F533BAC368490095574664","scheme":"exact","price":"$0.001"}},{"x402":{"version":2,"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","assetAddress":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"5Wxg3V6gcmFmmP6SXmGZQAUZPFYsSwoeN2Qewt5BotWz","scheme":"exact","price":"$0.001"}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"number"},"totalMatching":{"type":"number"},"totalCirculatingUsd":{"type":"number"},"filters":{"type":"object","properties":{"symbol":{"type":"string"},"chain":{}}},"stablecoins":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"symbol":{"type":"string"},"pegType":{"type":"string"},"pegCurrency":{"type":"string"},"pegMechanism":{"type":"string"},"price":{"type":"number"},"circulating":{"type":"number"},"circulatingUsd":{"type":"number"},"chains":{"type":"array","items":{"type":"string"}}}}},"source":{"type":"object","properties":{"name":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Sign an x402 payment authorization and retry.","headers":{"Payment-Required":{"schema":{"type":"string"},"description":"Base64-encoded x402 v2 challenge."}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No data for this query (unknown token / empty filter) — not charged."},"405":{"description":"Method not allowed — use GET."},"502":{"description":"DefiLlama upstream unavailable — not charged."}}}},"/v1/crypto/dex":{"get":{"operationId":"getCryptoDex","summary":"DEX trading volume by protocol — 24h + 7d, optionally per chain","description":"Decentralized exchange (DEX) trading volume ranked by protocol: 24-hour and 7-day volume in USD with 1d/7d change, plus the chains each DEX runs on. Pass ?chain=base to scope to one chain. See where on-chain trading is happening across Uniswap, Curve, Raydium, PancakeSwap and more. Sourced from DefiLlama.","tags":["crypto","defi","dex","trading-volume"],"x-keywords":["dex volume","trading volume","uniswap volume","dex","decentralized exchange","on-chain volume","defillama","curve","raydium"],"x-use-cases":["Rank DEXs by 24h volume","Scope on-chain trading volume to one chain","Track DEX volume trend (1d/7d change)"],"parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string"},"description":"Scope to one chain (case-insensitive): ethereum, base, solana, arbitrum… Omit for all chains."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Max DEXs returned (1–100, default 20)."}],"security":[{"x402":[]}],"x-payment-info":{"protocols":[{"x402":{"version":2,"network":"eip155:8453","asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3dA40A9aD36640a2C0F533BAC368490095574664","scheme":"exact","price":"$0.001"}},{"x402":{"version":2,"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","assetAddress":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"5Wxg3V6gcmFmmP6SXmGZQAUZPFYsSwoeN2Qewt5BotWz","scheme":"exact","price":"$0.001"}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"total24hUsd":{"type":"number"},"total7dUsd":{"type":"number"},"count":{"type":"number"},"dexs":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"volume24hUsd":{"type":"number"},"volume7dUsd":{"type":"number"},"change1dPct":{"type":"number"},"change7dPct":{"type":"number"},"chains":{"type":"array","items":{"type":"string"}}}}},"source":{"type":"object","properties":{"name":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Sign an x402 payment authorization and retry.","headers":{"Payment-Required":{"schema":{"type":"string"},"description":"Base64-encoded x402 v2 challenge."}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No data for this query (unknown token / empty filter) — not charged."},"405":{"description":"Method not allowed — use GET."},"502":{"description":"DefiLlama upstream unavailable — not charged."}}}},"/v1/crypto/fees":{"get":{"operationId":"getCryptoFees","summary":"Protocol fees + revenue ranked — who actually earns money in DeFi","description":"DeFi protocol fees and revenue ranked: which protocols actually earn money (not just hold TVL). Each returns 24-hour and 7-day fees in USD, revenue where DefiLlama breaks it out, 1d/7d change, category, and the chains it runs on. See where real economic activity is across Uniswap, Aave, Lido, Hyperliquid and more. Sourced from DefiLlama.","tags":["crypto","defi","fees","revenue"],"x-keywords":["protocol fees","defi revenue","fees","revenue","earnings","fundamentals","uniswap fees","defillama"],"x-use-cases":["Rank protocols by fees/revenue","Fundamental analysis (real earnings vs TVL)","Track fee trends (1d/7d change)"],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Max protocols returned (1–100, default 20)."}],"security":[{"x402":[]}],"x-payment-info":{"protocols":[{"x402":{"version":2,"network":"eip155:8453","asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3dA40A9aD36640a2C0F533BAC368490095574664","scheme":"exact","price":"$0.001"}},{"x402":{"version":2,"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","assetAddress":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"5Wxg3V6gcmFmmP6SXmGZQAUZPFYsSwoeN2Qewt5BotWz","scheme":"exact","price":"$0.001"}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"total24hUsd":{"type":"number"},"total7dUsd":{"type":"number"},"count":{"type":"number"},"protocols":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"category":{"type":"string"},"fees24hUsd":{"type":"number"},"fees7dUsd":{"type":"number"},"revenue24hUsd":{"type":"number"},"change1dPct":{"type":"number"},"change7dPct":{"type":"number"},"chains":{"type":"array","items":{"type":"string"}}}}},"source":{"type":"object","properties":{"name":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Sign an x402 payment authorization and retry.","headers":{"Payment-Required":{"schema":{"type":"string"},"description":"Base64-encoded x402 v2 challenge."}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No data for this query (unknown token / empty filter) — not charged."},"405":{"description":"Method not allowed — use GET."},"502":{"description":"DefiLlama upstream unavailable — not charged."}}}},"/v1/crypto/protocol":{"get":{"operationId":"getCryptoProtocol","summary":"Single-protocol deep dive — TVL, market cap, per-chain breakdown, 30d history","description":"Deep dive on any DeFi protocol by its DefiLlama slug (aave-v3, lido, uniswap…): current Total Value Locked, market cap, category, the chains it spans, a per-chain TVL breakdown, and a 30-day TVL history. Everything you need to size up a protocol in one call. Sourced from DefiLlama.","tags":["crypto","defi","protocol","tvl"],"x-keywords":["protocol detail","protocol tvl","defi protocol","aave","lido","uniswap","tvl history","market cap","defillama"],"x-use-cases":["Size up a protocol (TVL + mcap + chains)","Per-chain TVL breakdown for one protocol","30-day TVL trend for due diligence"],"parameters":[{"name":"protocol","in":"query","required":false,"schema":{"type":"string"},"description":"DefiLlama protocol slug (aave-v3, lido, uniswap, …). Defaults to aave-v3."}],"security":[{"x402":[]}],"x-payment-info":{"protocols":[{"x402":{"version":2,"network":"eip155:8453","asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3dA40A9aD36640a2C0F533BAC368490095574664","scheme":"exact","price":"$0.001"}},{"x402":{"version":2,"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","assetAddress":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"5Wxg3V6gcmFmmP6SXmGZQAUZPFYsSwoeN2Qewt5BotWz","scheme":"exact","price":"$0.001"}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"symbol":{"type":"string"},"category":{"type":"string"},"chains":{"type":"array","items":{"type":"string"}},"currentTvlUsd":{"type":"number"},"mcapUsd":{"type":"number"},"chainTvls":{"type":"array","items":{"type":"object","properties":{"chain":{"type":"string"},"tvlUsd":{"type":"number"}}}},"tvlHistory":{"type":"array","items":{"type":"object","properties":{"date":{"type":"number"},"tvlUsd":{"type":"number"}}}},"source":{"type":"object","properties":{"name":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Sign an x402 payment authorization and retry.","headers":{"Payment-Required":{"schema":{"type":"string"},"description":"Base64-encoded x402 v2 challenge."}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No data for this query (unknown token / empty filter) — not charged."},"405":{"description":"Method not allowed — use GET."},"502":{"description":"DefiLlama upstream unavailable — not charged."}}}},"/v1/crypto/chart":{"get":{"operationId":"getCryptoChart","summary":"Token price history (time series) by symbol, coingecko id, or chain:address","description":"Historical token price time series by ticker symbol, CoinGecko id, or chain:address (BTC, ETH, SOL, or base:0x…): a dated array of prices for up to 20 coins, with selectable span (number of points) and period (1d, 1h, 1w). For charting, backtesting, and trend analysis. Pairs with /v1/crypto/price for the live spot. Sourced from DefiLlama.","tags":["crypto","prices","price-history","chart"],"x-keywords":["price history","historical prices","price chart","time series","ohlc","backtest","bitcoin price history","defillama"],"x-use-cases":["Chart a token's price over time","Backtest against historical prices","Compute returns / volatility from a series"],"parameters":[{"name":"coins","in":"query","required":false,"schema":{"type":"string","default":"BTC,ETH"},"description":"Comma-separated symbols/coingecko-ids/chain:address (up to 20)."},{"name":"span","in":"query","required":false,"schema":{"type":"integer","minimum":2,"maximum":365,"default":30},"description":"Number of data points (2–365, default 30)."},{"name":"period","in":"query","required":false,"schema":{"type":"string","enum":["1d","1h","1w"],"default":"1d"},"description":"Sampling period (default 1d)."}],"security":[{"x402":[]}],"x-payment-info":{"protocols":[{"x402":{"version":2,"network":"eip155:8453","asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3dA40A9aD36640a2C0F533BAC368490095574664","scheme":"exact","price":"$0.001"}},{"x402":{"version":2,"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","assetAddress":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"5Wxg3V6gcmFmmP6SXmGZQAUZPFYsSwoeN2Qewt5BotWz","scheme":"exact","price":"$0.001"}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"period":{"type":"string"},"span":{"type":"number"},"requested":{"type":"number"},"count":{"type":"number"},"series":{"type":"array","items":{"type":"object","properties":{"query":{"type":"string"},"key":{"type":"string"},"resolved":{"type":"boolean"},"symbol":{"type":"string"},"confidence":{"type":"number"},"points":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"number"},"price":{"type":"number"}}}}}}},"unresolved":{"type":"array","items":{"type":"object"}},"source":{"type":"object","properties":{"name":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Sign an x402 payment authorization and retry.","headers":{"Payment-Required":{"schema":{"type":"string"},"description":"Base64-encoded x402 v2 challenge."}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No data for this query (unknown token / empty filter) — not charged."},"405":{"description":"Method not allowed — use GET."},"502":{"description":"DefiLlama upstream unavailable — not charged."}}}},"/v1/crypto/perps":{"get":{"operationId":"getCryptoPerps","summary":"Perpetual futures — funding rate, open interest, mark price, 24h volume","description":"Perpetual-futures market data from Hyperliquid for any coin (BTC, ETH, SOL, HYPE…): mark price, hourly funding rate and its annualized APR, open interest in coin and USD, 24-hour notional volume, 24h price change, and max leverage, across 200+ perp markets. Sort by volume, open interest, or funding. Track the perp market the way trading agents do. Sourced from Hyperliquid.","tags":["crypto","perps","perpetuals","futures"],"x-keywords":["perps","perpetuals","funding rate","open interest","hyperliquid","perp funding","futures","mark price","derivatives"],"x-use-cases":["Track funding rates + open interest","Find the highest-volume perp markets","Monitor one coin's perp (mark, funding, OI)"],"parameters":[{"name":"coin","in":"query","required":false,"schema":{"type":"string"},"description":"Filter to one perp market by symbol (BTC, ETH, SOL…). Omit for the ranking."},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["volume","oi","funding"],"default":"volume"},"description":"Sort key (default volume)."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Max markets returned (1–100, default 20)."}],"security":[{"x402":[]}],"x-payment-info":{"protocols":[{"x402":{"version":2,"network":"eip155:8453","asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3dA40A9aD36640a2C0F533BAC368490095574664","scheme":"exact","price":"$0.001"}},{"x402":{"version":2,"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","assetAddress":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"5Wxg3V6gcmFmmP6SXmGZQAUZPFYsSwoeN2Qewt5BotWz","scheme":"exact","price":"$0.001"}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"number"},"filters":{"type":"object","properties":{"coin":{"type":"string"},"sort":{"type":"string"}}},"markets":{"type":"array","items":{"type":"object","properties":{"coin":{"type":"string"},"markPrice":{"type":"number"},"oraclePrice":{"type":"number"},"priceQuotedPer":{"type":"number"},"fundingRateHourly":{"type":"number"},"fundingAprPct":{"type":"number"},"openInterest":{"type":"number"},"openInterestUsd":{"type":"number"},"volume24hUsd":{"type":"number"},"change24hPct":{"type":"number"},"maxLeverage":{"type":"number"}}}},"source":{"type":"object","properties":{"name":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Sign an x402 payment authorization and retry.","headers":{"Payment-Required":{"schema":{"type":"string"},"description":"Base64-encoded x402 v2 challenge."}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No data for this query (unknown token / empty filter) — not charged."},"405":{"description":"Method not allowed — use GET."},"502":{"description":"DefiLlama upstream unavailable — not charged."}}}},"/v1/crypto/sentiment":{"get":{"operationId":"getCryptoSentiment","summary":"Crypto Fear & Greed index — current value + history","description":"The Crypto Fear & Greed index: the current market-sentiment score (0–100) and its classification (Extreme Fear → Extreme Greed), plus optional daily history. A widely-watched contrarian signal for crypto market timing. Sourced from Alternative.me.","tags":["crypto","sentiment","fear-and-greed","market-sentiment"],"x-keywords":["fear and greed","crypto sentiment","market sentiment","fear greed index","sentiment indicator","market timing"],"x-use-cases":["Read current market sentiment","Contrarian signal (extreme fear/greed)","Track the sentiment trend over time"],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":90,"default":1},"description":"Days of history to include (1–90, default 1 = latest only)."}],"security":[{"x402":[]}],"x-payment-info":{"protocols":[{"x402":{"version":2,"network":"eip155:8453","asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3dA40A9aD36640a2C0F533BAC368490095574664","scheme":"exact","price":"$0.001"}},{"x402":{"version":2,"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","assetAddress":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"5Wxg3V6gcmFmmP6SXmGZQAUZPFYsSwoeN2Qewt5BotWz","scheme":"exact","price":"$0.001"}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"value":{"type":"number"},"classification":{"type":"string"},"asOf":{"type":"string"},"count":{"type":"number"},"history":{"type":"array","items":{"type":"object","properties":{"value":{"type":"number"},"classification":{"type":"string"},"timestamp":{"type":"number"},"asOf":{"type":"string"}}}},"source":{"type":"object","properties":{"name":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Sign an x402 payment authorization and retry.","headers":{"Payment-Required":{"schema":{"type":"string"},"description":"Base64-encoded x402 v2 challenge."}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No data for this query (unknown token / empty filter) — not charged."},"405":{"description":"Method not allowed — use GET."},"502":{"description":"DefiLlama upstream unavailable — not charged."}}}},"/v1/crypto/global":{"get":{"operationId":"getCryptoGlobal","summary":"Total crypto market cap, volume, and BTC/ETH dominance","description":"A snapshot of the total crypto market: aggregate market capitalization in USD, 24-hour trading volume, Bitcoin and Ethereum dominance percentages, 24h market-cap change, and the number of active cryptocurrencies and markets. The macro view in one call. Sourced from CoinGecko.","tags":["crypto","market-overview","market-cap","btc-dominance"],"x-keywords":["total market cap","crypto market cap","btc dominance","bitcoin dominance","market overview","global crypto","altseason"],"x-use-cases":["Total crypto market cap + volume","BTC/ETH dominance (altseason signal)","Macro market-cap trend"],"parameters":[],"security":[{"x402":[]}],"x-payment-info":{"protocols":[{"x402":{"version":2,"network":"eip155:8453","asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3dA40A9aD36640a2C0F533BAC368490095574664","scheme":"exact","price":"$0.001"}},{"x402":{"version":2,"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","assetAddress":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"5Wxg3V6gcmFmmP6SXmGZQAUZPFYsSwoeN2Qewt5BotWz","scheme":"exact","price":"$0.001"}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"asOf":{"type":"string"},"totalMarketCapUsd":{"type":"number"},"totalVolume24hUsd":{"type":"number"},"btcDominancePct":{"type":"number"},"ethDominancePct":{"type":"number"},"marketCapChange24hPct":{"type":"number"},"activeCryptocurrencies":{"type":"number"},"markets":{"type":"number"},"source":{"type":"object","properties":{"name":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Sign an x402 payment authorization and retry.","headers":{"Payment-Required":{"schema":{"type":"string"},"description":"Base64-encoded x402 v2 challenge."}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No data for this query (unknown token / empty filter) — not charged."},"405":{"description":"Method not allowed — use GET."},"502":{"description":"DefiLlama upstream unavailable — not charged."}}}}},"components":{"securitySchemes":{"x402":{"type":"apiKey","in":"header","name":"X-PAYMENT","description":"x402 v2 payment header. Flat $0.001 per response. USDC on eip155:8453 + solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp."}}}}