# pump.x4o2.com Coin Candles

> pump.x4o2.com Coin Candles is a paid API for AI agents from pump.x4o2.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-16).

Returns historical OHLCV candlestick data (open, high, low, close, volume, trade count) for a specific pump.fun token, bucketed by configurable time intervals.

## Facts

- Endpoint: GET https://pump.x4o2.com/v1/coin/:mint/candles?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pump-x4o2-com-coin-candles-9903aa4a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_njXBhWHGWhdybD7x6vUSH

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 pump-x4o2-com-coin-candles-9903aa4a
```

Example prompt: Pull the last 50 hourly candles for the pump.fun token with mint address 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU, measuring price in USD.

## When to prefer this

Use this endpoint when you need historical OHLCV candlestick data sourced directly from pump.fun's own chart infrastructure for a specific Solana meme coin. Prefer it over on-chain DEX aggregators when the coin is in its bonding-curve phase on pump.fun and hasn't graduated to Raydium yet, since pump.fun's native data will be most accurate. Choose this over generic Solana price APIs (e.g. Birdeye, Dexscreener) when you specifically need pump.fun's canonical chart view with configurable measures (price vs market cap, USD vs SOL).

## Known failure modes

- Invalid or unknown mint address returns empty results or 404
- Unsupported resolution value for 'res' causes a 400 error
- Count out of range (less than 1 or over 1000) may cause validation error
- Token too new may have insufficient history for requested bucket count
- Network or upstream pump.fun data unavailability causes 5xx error
- Stale cache parameter misuse may return outdated data unexpectedly

## How this service works

Historical candles for one coin from pump.fun's own chart data: open, high, low, close, USD volume and trade count per bucket. res picks the bucket (1m, 5m, 15m, 30m, 1h, 4h, 6h, 12h, 1d), count how many of the most recent buckets, measure whether values are price or market cap in USD or SOL.

## Output

An array of candlestick buckets for the requested token, each containing open, high, low, close values (in the requested measure: price_usd, price_sol, market_cap_usd, or market_cap_sol), USD volume, and trade count per bucket, ordered from oldest to most recent within the requested count.

## 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": [
      "mint"
     ],
     "properties": {
      "mint": {
       "type": "string",
       "description": "Token mint address (base58)"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "res": {
       "enum": [
        "1m",
        "5m",
        "15m",
        "30m",
        "1h",
        "4h",
        "6h",
        "12h",
        "1d"
       ],
       "type": "string",
       "description": "Bucket size"
      },
      "count": {
       "type": "integer",
       "maximum": 1000,
       "minimum": 1,
       "description": "Number of most recent buckets"
      },
      "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"
      },
      "measure": {
       "enum": [
        "price_usd",
        "price_sol",
        "market_cap_usd",
        "market_cap_sol"
       ],
       "type": "string",
       "description": "Whether values are price or market cap, in USD or SOL"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data",
      "meta"
     ],
     "properties": {
      "data": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "served": {
         "type": [
          "object",
          "null"
         ],
         "properties": {
          "res": {
           "type": [
            "string",
            "null"
           ]
          },
          "measure": {
           "type": [
            "string",
            "null"
           ]
          }
         }
        },
        "source": {
         "type": [
          "string
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pump-x4o2-com-coin-candles-9903aa4a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pump.x4o2.com](https://www.zero.xyz/host/pump.x4o2.com/llms.txt)