{"uid":"cap_fUhxYG8UKmcw7Wyxx7Kp2","slug":"x4o2-stonkfun-ohlcv-candles-875c12f6","name":"x4o2 StonkFun OHLCV Candles","description":"Exact-market OHLCV in quote units; 1m through 1d","url":"https://stonk.x4o2.com/v1/tokens/:mint/candles?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"},"pathParams":{"type":"object","required":["mint"],"properties":{"mint":{"type":"string","description":"Exact Solana token mint"}}},"queryParams":{"type":"object","required":[],"properties":{"res":{"enum":["1m","5m","15m","1h","4h","1d"],"type":"string","default":"5m","description":"Candle resolution"},"pool":{"type":"string","description":"Exact pool address; required for candles"},"limit":{"type":"integer","default":300,"maximum":1000,"minimum":1,"description":"Candle count"},"before":{"type":"integer","minimum":1,"description":"Exclusive candle bucket upper bound, Unix seconds"},"quoteMint":{"type":"string","description":"Exact quote mint; required for ranking or candles"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":["object","null"],"properties":{"data":{"type":["object","null"],"properties":{"res":{"type":["string","null"]},"busy":{"type":["boolean","null"]},"mint":{"type":["string","null"]},"pool":{"type":["string","null"]},"source":{"type":["string","null"]},"candles":{"type":["array","null"],"items":{"type":["object","null"]}},"measure":{"type":["string","null"]},"coverage":{"type":["object","null"],"properties":{"to":{"type":["number","null"]},"from":{"type":["number","null"]},"partial":{"type":["boolean","null"]},"ordering":{"type":["string","null"]},"retentionDays":{"type":["number","null"]},"historyComplete":{"type":["boolean","null"]}}},"currency":{"type":["string","null"]},"quoteUsd":{},"fetchedAt":{"type":["string","null"]},"quoteMint":{"type":["string","null"]},"serverTime":{"type":["string","null"]},"quoteUsdObservedAt":{}}},"meta":{"type":["object","null"],"properties":{"ageMs":{"type":["number","null"]},"source":{"type":["string","null"]},"partial":{"type":["boolean","null"]},"commitment":{"type":["string","null"]},"observedAt":{"type":["number","null"]},"discoveryAt":{"type":["string","null"]},"freshnessSeconds":{"type":["number","null"]}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3i3r-r3odnpmAwMNgeOZ3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns exact-market OHLCV candlestick data for a Solana SPL token in quote units, with resolutions from 1 minute to 1 day","exampleAgentPrompt":"Pull the last 100 hourly OHLCV candles for Solana token mint So11111111111111111111111111111111111111112 on pool 7XawhbbxtsRcQA8KTkHT9f9nc6d69UwqCDh6U5EEbEmX with USDC as the quote mint.","exampleUseCases":[{"title":"Intraday trading chart for memecoin","prompt":"Get me the last 200 five-minute candles for the Solana token at mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v using pool 8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj and SOL as the quote mint so I can plot a price chart."},{"title":"Daily price history for portfolio analysis","prompt":"Fetch 365 daily OHLCV candles for the SPL token mint DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 on pool 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM with USDC as the quote to analyze its long-term price trend."},{"title":"Real-time 1-minute scalping data","prompt":"Give me the latest 50 one-minute candles for Solana token mint 4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R on pool 6UmmUiYoBjSrhakAobLLSgfSZX85VUs72b7roTpjRaP5 with USDC quote so I can monitor short-term price action."}],"resultDescription":"Returns a JSON object containing an array of OHLCV candle objects for the specified token and pool, along with the resolution, pool address, quote mint, currency, coverage metadata (from/to timestamps, retention days, history completeness, ordering, partial flag), a busy flag indicating data-loading state, data source, USD quote price, fetch timestamp, and server time.","failureModes":["Missing required pool address returns an error since pool is required for candle queries","Missing or invalid quoteMint returns an error as it is required for candle resolution","Invalid mint address format causes a 4xx error","Requested resolution not in enum (1m, 5m, 15m, 1h, 4h, 1d) causes validation failure","Limit exceeding 1000 is rejected","Coverage may be partial or history incomplete for newly listed tokens","busy flag set to true indicates data is still being ingested and candles may be incomplete","Payment failure (non-payment of 0.001 USDC via x402) results in 402 response"],"whenToPreferThis":"Choose this endpoint when you need exact on-chain OHLCV price data for a specific Solana token on a specific pool and quote pair, particularly for charting, backtesting, or monitoring price action at resolutions from 1 minute to 1 day. It is ideal for DeFi analytics agents working with Solana SPL tokens that need precise candlestick data in quote units rather than estimated or aggregated cross-exchange prices.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:38:57.563Z","isFirstParty":false,"canonicalSlug":"x4o2-stonkfun-ohlcv-candles-875c12f6"}