{"uid":"cap_spzHD2yh2Q5p0ZClPMB5R","slug":"2s-io-dex-ohlcv-candlestick-data-c989a187","name":"2s.io DEX OHLCV Candlestick Data","description":"OHLCV candlesticks for a DEX pool (via GeckoTerminal, free/keyless). Pass network + pool address + timeframe (day/hour/minute) with optional aggregate (e.g. 4 = 4-hour) and limit. Returns time/open/high/low/close/volumeUsd bars for on-chain technical analysis. Pair with crypto.dex-pools / dex-token-pools to find a pool address.","url":"https://2s.io/api/crypto/dex-ohlcv","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["network","address"],"properties":{"limit":{"type":"integer","maximum":1000,"minimum":1},"address":{"type":"string","maxLength":120,"minLength":1,"description":"Pool address (not token address)."},"network":{"type":"string","maxLength":40,"minLength":1},"aggregate":{"type":"integer","maximum":60,"minimum":1},"timeframe":{"enum":["day","hour","minute"],"type":"string"}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0036","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.0036/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0036","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0036","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tGxcsmgQXMK5_A8WlShnX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0036","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches OHLCV (open/high/low/close/volume) candlestick bars for a specific decentralized exchange pool, sourced from GeckoTerminal, for on-chain technical analysis.","exampleAgentPrompt":"Pull the last 200 hourly OHLCV candles for the Uniswap ETH/USDC pool at address 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640 on Ethereum so I can run some technical analysis on it.","exampleUseCases":null,"resultDescription":"Returns an array of OHLCV candlestick bars, each containing a Unix timestamp, open price, high price, low price, close price, and trading volume in USD, covering the requested timeframe and aggregate interval for the specified DEX pool.","failureModes":["Invalid or non-existent pool address returns an error or empty result","Unsupported network slug causes a lookup failure","Aggregate value out of range (must be 1–60) returns a validation error","Limit exceeding 1000 returns a validation error","Pool exists but has insufficient trading history for the requested range, returning fewer bars than requested","GeckoTerminal upstream unavailability causes a timeout or 503 error"],"whenToPreferThis":"Use this endpoint when you need historical OHLCV price and volume data for a specific on-chain DEX liquidity pool for charting or technical analysis. It is free/keyless (no API key required) and proxies GeckoTerminal data. Best used after identifying the pool address via a pool-discovery endpoint. Prefer this over CEX OHLCV endpoints when the token you need only trades on decentralized exchanges.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:01:03.479Z","isFirstParty":false}