# DEX Pool OHLCV Candles (GeckoTerminal)

> DEX Pool OHLCV Candles (GeckoTerminal) is a paid API for AI agents from opportunity-api-production.up.railway.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns OHLCV candlestick data (open/high/low/close/volume) for a DEX liquidity pool, sourced from GeckoTerminal, for charting and backtesting.

## Facts

- Endpoint: GET https://opportunity-api-production.up.railway.app/api/pool-ohlcv
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/dex-pool-ohlcv-candles-geckoterminal-f865dbf0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_i4M5J-r7yPI-g2KcFT_DU

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 dex-pool-ohlcv-candles-geckoterminal-f865dbf0
```

Example prompt: Can you pull the last 100 hourly OHLCV candles for the USDC/ETH pool at address 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640 on Ethereum so I can chart the price action?

## When to prefer this

Use this endpoint when you need historical OHLCV candlestick price data for a specific DEX liquidity pool for charting, technical analysis, or backtesting. Prefer this over general token price APIs when you need granular open/high/low/close/volume broken down by time period (minute, hour, or day) at the pool level rather than aggregated token prices.

## Known failure modes

- Invalid or unknown pool address returns an error or empty result
- Unsupported network identifier causes a bad request response
- Limit exceeding 300 is rejected or clamped
- Invalid timeframe value (not minute/hour/day) returns an error
- Pool address not found on GeckoTerminal returns empty data

## How this service works

OHLCV candles for a DEX pool (GeckoTerminal): open/high/low/close/volume. For charting and backtesting agents. Params: network, pool (address), timeframe (minute|hour|day), limit (max 300).

## Output

An array of OHLCV candlestick records for the specified DEX pool, each containing open, high, low, close prices in USD and trading volume, indexed by timestamp. Up to 300 candles returned depending on the limit parameter.

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "network",
      "pool"
     ],
     "properties": {
      "pool": {
       "type": "string",
       "description": "pool address (from search-pools)"
      },
      "limit": {
       "type": "string",
       "description": "max 300, default 100"
      },
      "network": {
       "type": "string"
      },
      "timeframe": {
       "type": "string",
       "description": "minute|hour|day, default hour"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dex-pool-ohlcv-candles-geckoterminal-f865dbf0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from opportunity-api-production.up.railway.app](https://www.zero.xyz/host/opportunity-api-production.up.railway.app/llms.txt)