# Vybe Solana Token OHLCV Candles

> Vybe Solana Token OHLCV Candles is a paid API for AI agents from x402-api.vybenetwork.xyz, paid per call via x402, $0.009/call, status unknown (last checked 2026-10-01).

Returns OHLCV (open, high, low, close, volume) candlestick data for a Solana token by mint address, with configurable time range and resolution.

## Facts

- Endpoint: POST https://x402-api.vybenetwork.xyz/v4/tokens/%7BmintAddress%7D/candles?utm_source=zero.xyz
- Price: $0.009/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Success rate: 0% of calls made through Zero
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vybe-solana-token-ohlcv-candles-674b04ed
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5ehE8uvW6d6E3iANvl4_q

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 vybe-solana-token-ohlcv-candles-674b04ed -d '<json body>'
```

Example prompt: Pull hourly OHLCV candles for the Solana token with mint address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v from January 1 2025 to January 31 2025 — I want up to 1000 candles per page with gaps filled using the previous close as the next open.

## When to prefer this

Use this endpoint when you need historical OHLCV price candles for a specific Solana token identified by its mint address, especially for charting, backtesting, or price analysis. Prefer this over generic crypto price APIs when working specifically with Solana on-chain data and needing fine-grained resolution control (down to 1-minute candles). It requires no API key — only a micropayment in USDC via x402.

## Known failure modes

- Invalid or unknown mint address returns an error or empty result set
- Time range too wide for the requested resolution may hit pagination limits
- Resolution value outside allowed enum returns a validation error
- Payment not attached or insufficient USDC balance returns HTTP 402
- Rate limiting or network issues may cause transient failures

## How this service works

Read access to Solana on-chain data — tokens, wallets, markets, prices, trades, transfers. No API key, no signup. Pay in USDC per request with the x402 protocol; the per-route price is declared in `x-payment-info`. WebSocket streaming uses prepaid credits.

## Output

Returns an array of OHLCV candlestick records (TradeOhlcvCandleVecReturn) for the requested token, each containing open, high, low, close prices and trading volume for the specified time bucket. Candles are aligned to the chosen resolution (e.g. 1m, 1h, 1d) and optionally have close-to-open gaps eliminated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "mintAddress"
 ],
 "properties": {
  "page": {
   "type": "integer",
   "description": "Page number for paginated results"
  },
  "limit": {
   "type": "integer",
   "description": "Result page size specifier. Default is 1000."
  },
  "timeEnd": {
   "type": "integer",
   "description": "End time of the data to return (unix timestamp)"
  },
  "timeStart": {
   "type": "integer",
   "description": "Start time of the data to return (unix timestamp)"
  },
  "resolution": {
   "type": "string",
   "description": "Resolution of the data. Possible values: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 3h, 4h, 1d, 1w, 1mo, 1y. Default is \"1h\"."
  },
  "mintAddress": {
   "type": "string",
   "description": "The public key of the token of interest"
  },
  "eliminateCloseToOpenGaps": {
   "type": "boolean",
   "description": "Eliminate gaps between candles by using previous close as next open. Default is true."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "$ref": "#/components/schemas/TradeOhlcvCandleVecReturn"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vybe-solana-token-ohlcv-candles-674b04ed/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-api.vybenetwork.xyz](https://www.zero.xyz/host/x402-api.vybenetwork.xyz/llms.txt)