# x4o2 FOMO Data – Token Price Candles

> x4o2 FOMO Data – Token Price Candles is a paid API for AI agents from fomo.x4o2.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-28).

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.

## Facts

- Endpoint: GET https://fomo.x4o2.com/v1/token/:chain/:address/candles?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x4o2-fomo-data-token-price-candles-a94b6c11
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gi4tKiTQ0LxD39CFyEdZx

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x4o2-fomo-data-token-price-candles-a94b6c11
```

Example prompt: Pull 1-hour OHLCV candles from FOMO for the Solana token at address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v — give me the last 300 buckets up to now.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
          ]
 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x4o2-fomo-data-token-price-candles-a94b6c11/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fomo.x4o2.com](https://www.zero.xyz/host/fomo.x4o2.com/llms.txt)