{"uid":"cap_gi4tKiTQ0LxD39CFyEdZx","slug":"x4o2-fomo-data-token-price-candles-a94b6c11","name":"x4o2 FOMO Data – Token Price Candles","description":"Historical USD candles for one token as FOMO charts it: t (bucket start, unix ms), o, h, l, c and v (USD volume) for the 300 buckets ending at to, optionally trimmed to those at or after from. period picks the bucket size (5m, 30m, 1h, 4h, 12h). Use for price history and chart analysis.","url":"https://fomo.x4o2.com/v1/token/:chain/:address/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":["chain","address"],"properties":{"chain":{"type":"string","description":"solana, base, ethereum, bsc, monad, robinhood or a numeric network id"},"address":{"type":"string","description":"Token mint (Solana) or contract address (EVM)"}}},"queryParams":{"type":"object","required":[],"properties":{"to":{"type":"integer","minimum":0,"description":"Last bucket at or before this time, unix ms (default: now)"},"from":{"type":"integer","minimum":0,"description":"Drop buckets before this time, unix ms"},"stale":{"enum":[0,1],"type":"integer","description":"1 returns any cached copy immediately and refreshes in the background"},"maxAge":{"type":"integer","minimum":0,"description":"Serve a cached copy up to this many seconds old; 0 forces the freshest allowed"},"period":{"enum":["5m","30m","1h","4h","12h"],"type":"string","default":"1h","description":"Bucket size"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","meta"],"properties":{"data":{"type":["array","null"],"items":{"type":["object","null"],"properties":{"c":{"type":["number","null"]},"h":{"type":["number","null"]},"l":{"type":["number","null"]},"o":{"type":["number","null"]},"t":{"type":["number","null"]},"v":{"type":["number","null"]}}}},"meta":{"type":"object","required":["observedAt","ageMs","source"],"properties":{"ageMs":{"type":"integer","description":"Age of the oldest part when served, ms"},"parts":{"type":"object","description":"observedAt and source per upstream part"},"source":{"enum":["cache","fresh","stale"],"type":"string"},"observedAt":{"type":"integer","description":"Unix ms when the oldest part was observed upstream"}},"description":"Freshness of the response"}}}}}}},"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_qwQ25q22fqzDLUaSUtFmm","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 historical OHLCV USD candles for a specific token as displayed on FOMO, covering up to 300 buckets ending at a given time with configurable period sizes.","exampleAgentPrompt":"Pull 1-hour OHLCV candles from FOMO for the Solana token at address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v — give me the last 300 buckets up to now.","exampleUseCases":[{"title":"Token price chart for trading analysis","prompt":"Get me the 4-hour candles from FOMO for the Ethereum token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 — I want the last 300 buckets so I can chart its recent price action."},{"title":"Short-term momentum check with 5-minute candles","prompt":"Fetch 5-minute OHLCV data from FOMO for the Base chain token at 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 for the past few hours — I need to see if there's any short-term momentum building."},{"title":"Historical backtesting data for a Solana token","prompt":"Can you pull 12-hour candles from FOMO for the Solana token mint So11111111111111111111111111111111111111112 starting from January 1 2025 through March 31 2025? I want to backtest a strategy against that window."}],"resultDescription":"An array of up to 300 OHLCV candle objects, each containing t (bucket start in unix ms), o (open), h (high), l (low), c (close), and v (USD volume), plus a meta object with observedAt timestamp, ageMs, and source (cache/fresh/stale) indicating data freshness.","failureModes":["Invalid or unsupported chain name returns an error","Token address not found or not indexed by FOMO returns null data array","Invalid period enum value (not 5m/30m/1h/4h/12h) causes request failure","From timestamp after to timestamp produces empty or error response","Stale cache with no background data may return incomplete candles","Network or payment authentication failure returns 402 or 5xx"],"whenToPreferThis":"Choose this endpoint when you need FOMO-sourced historical OHLCV candlestick data for a specific token across supported chains (Solana, Base, Ethereum, BSC, Monad, Robinhood), especially when you want configurable bucket sizes from 5 minutes to 12 hours and up to 300 historical buckets. Prefer this over generic DEX aggregators when you want price history as FOMO specifically charts it, with freshness controls via stale/maxAge parameters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T12:36:44.074Z","isFirstParty":false,"canonicalSlug":"x4o2-fomo-data-token-price-candles-a94b6c11"}