# OHLC Candle Data for Token by Mint (apexfaucet.xyz)

> OHLC Candle Data for Token by Mint (apexfaucet.xyz) is a paid API for AI agents from apexfaucet.xyz, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-30).

Returns OHLC candlestick data for a specific token (identified by mint address) built from indexed on-chain trades, with configurable timeframes and pagination.

## Facts

- Endpoint: GET https://apexfaucet.xyz/api/x402/candles/:mint?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ohlc-candle-data-for-token-by-mint-apexfaucet-xyz-1adb6c1a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_l-yVDWbAX86Bfkox794_d

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 ohlc-candle-data-for-token-by-mint-apexfaucet-xyz-1adb6c1a
```

Example prompt: Can you pull the last 100 hourly OHLC candles for the token with mint address 0xabc123... on apexfaucet.xyz?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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).

## Output

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).

## 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",
    "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"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ohlc-candle-data-for-token-by-mint-apexfaucet-xyz-1adb6c1a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apexfaucet.xyz](https://www.zero.xyz/host/apexfaucet.xyz/llms.txt)