{"uid":"cap_Md9kLBre_anX16GSleRt3","slug":"tbs-crypto-defi-api-market-data-endpoint-03e4ea7b","name":"TBS Crypto & DeFi API – Market Data Endpoint","description":"Crypto & DeFi data for AI agents in one sub-cent call: real-time token prices, market data (market cap, volume, supply), DeFi TVL by protocol or chain, yield/APY pools, and a flagship bundle combining all of it. DefiLlama + Coinpaprika, keyless, unified schema, USDC-payable via x402 on Base.","url":"https://crypto-x402.tbs-digital.com/crypto/market?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":{"id":{"type":"string","description":"Coinpaprika id, e.g. btc-bitcoin"},"symbol":{"type":"string","description":"Common ticker, e.g. btc, eth, sol"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"payer":{"type":"object","properties":{"address":{"type":"string","nullable":true},"network":{"type":"string"}}},"market":{"type":"object"},"source":{"type":"string"},"request_id":{"type":"string"},"generated_at":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"payer":{"address":"0x0000000000000000000000000000000000000000","network":"base"},"market":{"id":"btc-bitcoin","name":"Bitcoin","rank":1,"symbol":"BTC","price_usd":64980.12,"observed_at":"2026-08-11T12:00:00.000Z","total_supply":21000000,"market_cap_usd":1281000000000,"volume_24h_usd":25400000000,"circulating_supply":19720000,"percent_change_24h":1.24},"source":"coinpaprika","request_id":"0b21c0e6-6a3f-4e2a-8b1e-2f9d4c7a1e55","generated_at":"2026-08-11T12:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XFp89F17NjBFPLLcMzCH8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time token market data (price, market cap, volume, supply, 24h change) for a given cryptocurrency by ID or symbol, powered by Coinpaprika.","exampleAgentPrompt":"What's the current price, market cap, 24h volume, and percent change for Bitcoin right now? Use its Coinpaprika ID btc-bitcoin.","exampleUseCases":[{"title":"Live crypto price check for portfolio","prompt":"Pull the current USD price, market cap, and 24h percent change for Ethereum — use the symbol ETH — so I can update my portfolio dashboard."},{"title":"Token market cap comparison","prompt":"I need the market cap and rank for both Bitcoin and Solana right now. Start with btc-bitcoin and then sol-solana so I can compare them side by side."},{"title":"Trading signal enrichment","prompt":"My trading bot just flagged SOL — can you grab its current price, 24h volume, and percent change using the symbol SOL so I can decide whether to act?"}],"resultDescription":"A JSON object containing the token's Coinpaprika ID, name, symbol, rank, current USD price, market cap, 24h trading volume, circulating supply, total supply, 24h percent change, and observation timestamp, plus metadata (source, request ID, generated_at, payer address/network).","failureModes":["Invalid or unrecognized symbol/ID returns an error or empty market object","Stale data if Coinpaprika upstream is delayed","Missing optional query params (id or symbol) may result in a default or error response","Rate limiting or payment failure if USDC balance is insufficient for x402 micropayment","Network timeout if upstream data provider is unavailable"],"whenToPreferThis":"Choose this endpoint when you need real-time spot price and core market metrics (market cap, volume, supply, rank, 24h change) for a single cryptocurrency, billed at sub-cent cost via USDC on Base with no API key required. Prefer it over aggregator APIs when operating in agentic or autonomous workflows that benefit from micropayment-native, keyless access. It is best suited for single-token lookups rather than bulk or historical queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:34:06.588Z","isFirstParty":false,"canonicalSlug":"tbs-crypto-defi-api-market-data-endpoint-03e4ea7b"}