{"uid":"cap_55ro-OpvaOgSULYbprIOG","slug":"token-ohlcv-candles-klymax402-57435107","name":"Token OHLCV Candles — klymax402","description":"One MCP endpoint gives your AI agent access to 100 APIs -- crypto, DeFi, web, AI, finance and utilities. No API keys, USDC on Base from $0.003/call.","url":"https://klymax402.com/api/token-ohlcv/api/candles","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","required":[],"properties":{"days":{"type":"number","description":"Number of days of history (default 30, max 365). For 1h interval max 2 days, for 4h max 90 days."},"chain":{"type":"string","description":"Blockchain network for contract lookup: base, ethereum, solana, arbitrum, polygon, optimism, bsc."},"token":{"type":"string","description":"CoinGecko token ID (e.g. bitcoin, ethereum, solana). Use this OR contract+chain."},"contract":{"type":"string","description":"On-chain contract address (e.g. 0x...). Use with chain parameter for GeckoTerminal lookup."},"interval":{"type":"string","description":"Candle interval: daily (default), 4h (if days <= 90), 1h (if days <= 2)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"source":"example","candles":[],"results":1,"tokenId":"example","interval":"example"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.00","successRate":"0.00","reviews":1,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_C61894wRE-4sQm9fXnVdV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns OHLCV (open, high, low, close, volume) candlestick data for a crypto token by CoinGecko ID or on-chain contract address, across configurable time intervals and history windows.","exampleAgentPrompt":"Can you pull the last 30 days of daily candlestick (OHLCV) data for Bitcoin using its CoinGecko ID 'bitcoin'?","exampleUseCases":[{"title":"Bitcoin price history for trading analysis","prompt":"Fetch 90 days of daily OHLCV candles for Bitcoin — I want to see the open, high, low, close, and volume history for the past 3 months."},{"title":"DeFi token candles by contract address","prompt":"Get me 4-hour candle data for the last 60 days for this Base chain token at contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — I need the OHLCV breakdown."},{"title":"Hourly price action for a new meme coin","prompt":"Pull the last 2 days of 1-hour candles for Solana token with contract 0xabcdef1234567890 on the solana chain so I can see recent intraday price movement."}],"resultDescription":"A JSON object containing a list of OHLCV candles (each with open, high, low, close, and volume values), the token ID, the data source (CoinGecko or GeckoTerminal), the candle interval used, and a result count.","failureModes":["Invalid or unknown CoinGecko token ID returns empty candles or an error","Contract address not found on specified chain returns no data","Interval not supported for the requested day range (e.g. 1h with days > 2) causes an error or fallback","Missing required token or contract parameter causes a validation error","Exceeding max days limit (365) returns an error"],"whenToPreferThis":"Use this endpoint when you need structured OHLCV candlestick data for a specific crypto token identified either by CoinGecko ID or on-chain contract address, across multiple blockchains, with flexible interval granularity (daily, 4h, 1h). Prefer this over generic price endpoints when you need chart-ready time-series data with volume included, especially for DeFi or newer tokens only identifiable by contract address.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-07-28T22:16:00.665Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:56:23.660Z","isFirstParty":false}