{"uid":"cap_l-yVDWbAX86Bfkox794_d","slug":"ohlc-candle-data-for-token-by-mint-apexfaucet-xyz-1adb6c1a","name":"OHLC Candle Data for Token by Mint (apexfaucet.xyz)","description":"OHLC candles for a token, built from indexed trades. Pass ?tf=1m, 5m, 15m, 1h, 4h or 1d (default 5m) and ?limit=N up to 1000 (default 200); ?before=<unix seconds> pages backwards. Timestamps are unix seconds. The description used to name the timeframes without naming the PARAMETER, so a paying agent had no way to ask for one and silently got 5m whatever it sent (found 2026-09-17).","url":"https://apexfaucet.xyz/api/x402/candles/:mint?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","pathParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["mint"],"properties":{"mint":{"type":"string","description":"X1 token mint address (base58), e.g. Du6Z596DwGnfUcMSyRHSBQzNybiQKu8GESVfruEv9Jqr (APEX)"}}}}},"output":{"type":"object"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DjMDpfWn914VqkK4vJgu3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns OHLC candlestick data for a specific token (identified by mint address) built from indexed on-chain trades, with configurable timeframes and pagination.","exampleAgentPrompt":"Can you pull the last 100 hourly OHLC candles for the token with mint address 0xabc123... on apexfaucet.xyz?","exampleUseCases":[{"title":"Trading bot price analysis","prompt":"Get me the last 200 five-minute candles for the token with mint 0xTokenMint456 so I can check for a breakout pattern."},{"title":"Daily chart review for a token","prompt":"Fetch the past 50 daily candles for mint address 0xXNTMintAddress so I can see how the token has trended over the past two months."},{"title":"Paginate through historical candle data","prompt":"I need 4-hour candles for mint 0xSomeMint789 going back before September 1st 2025 — give me 100 candles starting from that point and page backwards."}],"resultDescription":"A list of OHLC candlestick records for the specified token, each containing open, high, low, close prices and a unix-second timestamp, aggregated from indexed on-chain trades at the requested timeframe granularity (1m, 5m, 15m, 1h, 4h, or 1d).","failureModes":["Invalid or unknown mint address returns empty or error response","Unsupported timeframe value may silently default to 5m","limit exceeding 1000 may be clamped or rejected","Invalid 'before' timestamp causes pagination errors","Token with no indexed trades returns empty candle array","Service unavailability returns a non-200 HTTP error"],"whenToPreferThis":"Use this endpoint when you need structured OHLC candlestick data for a specific on-chain token (identified by mint address) on Arc, built from actual indexed trades rather than estimated or interpolated data. Prefer this over generic price feeds when you need multi-timeframe historical candle data with backward pagination support.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T18:35:23.117Z","isFirstParty":false,"canonicalSlug":"ohlc-candle-data-for-token-by-mint-apexfaucet-xyz-1adb6c1a"}