# DEX Pair Price via GeckoTerminal

> DEX Pair Price via GeckoTerminal is a paid API for AI agents from dex-pair-price.hergertsynthora.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Returns real-time on-chain DEX price, liquidity, and 24h volume for a token on a specified network using GeckoTerminal data

## Facts

- Endpoint: POST https://dex-pair-price.hergertsynthora.com/service
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/dex-pair-price-via-geckoterminal-9cb00e4d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4INFRjxnY7LTtSq_Vv1K4

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-pair-price-via-geckoterminal-9cb00e4d -d '<json body>'
```

Example prompt: What's the current on-chain price, liquidity, and 24h volume for the token at address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum?

## When to prefer this

Choose this endpoint when you need live on-chain DEX price data (not CEX prices), especially for long-tail or newly listed tokens that may not appear on centralized exchange APIs. Ideal for DeFi routing agents, arbitrage bots, or portfolio trackers that need pool-level liquidity and volume alongside price. Prefer over CoinGecko/CoinMarketCap when you need DEX-specific pool data rather than aggregated market prices.

## Known failure modes

- Token address not found on specified network — returns upstream error with no charge
- Invalid or unsupported network identifier — returns validation error
- GeckoTerminal upstream failure — no charge applied per service terms
- Malformed token_address format — returns error
- Rate limit or wallet quota exhausted

## How this service works

Real-time on-chain DEX price, liquidity and 24h volume for any pool/token on any chain via GeckoTerminal. For DeFi routing agents. Free source. $0.01 USDC via x402 on Base. SYNTHORA. First 3 calls FREE per wallet — send header X-WALLET: 0x<addr>. No charge on upstream failure.

## Output

Returns the real-time spot price, total liquidity (in USD), and 24-hour trading volume for the specified token/pool on the given chain, sourced from GeckoTerminal's on-chain DEX data aggregation.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "network": {
   "type": "string",
   "description": "network"
  },
  "token_address": {
   "type": "string",
   "description": "token_address"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "niche": "dex-pair-price",
  "result": {
   "network": "base",
   "liquidity": null,
   "price_usd": "1.0040515644",
   "volume_24h": null,
   "token_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
  },
  "provenance": {
   "url": "https://api.geckoterminal.com/api/v2/networks/base/tokens",
   "source": "SYNTHORA DEX Pair Price"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dex-pair-price-via-geckoterminal-9cb00e4d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from dex-pair-price.hergertsynthora.com](https://www.zero.xyz/host/dex-pair-price.hergertsynthora.com/llms.txt)