# GeckoTerminal On-Chain DEX Pools API
> Live on-chain DEX pool discovery from GeckoTerminal (CoinGecko's on-chain data product), served as clean JSON. List every supported blockchain network; see the trending liquidity pools on a network right now — the pools drawing the most attention; pull the most recently created pools on a network — freshly launched markets; read one pool's live state (base/quote token USD price, liquidity, 24h volume, price change and buy/sell transaction counts); or search pools by token name, symbol or address. Read live from GeckoTerminal, nothing cached. This is the on-chain DEX pool-discovery, trending-pool and new-pool layer for any trading, analytics or token-launch app — distinct from DEX volume-ranking feeds and from token/pair lookup APIs: this is per-network pool discovery (what is trending, what just launched) with live pool economics across 100+ networks.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/geckoterminal-api/..."
```

## Pricing
- **Free** (Free) — 800 calls/Mo, 2 req/s
- **Starter** ($9/Mo) — 30,000 calls/Mo, 8 req/s
- **Pro** ($26/Mo) — 160,000 calls/Mo, 20 req/s
- **Business** ($63/Mo) — 800,000 calls/Mo, 40 req/s

## Endpoints

### Networks

#### `GET /v1/networks` — Every supported blockchain network

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/geckoterminal-api/v1/networks"
```

**Response:**
```json
{
    "data": {
        "page": 1,
        "count": 100,
        "source": "GeckoTerminal",
        "networks": [
            {
                "id": "eth",
                "name": "Ethereum",
                "coingecko_asset_platform_id": "ethereum"
            },
            {
                "id": "bsc",
                "name": "BNB Chain",
                "coingecko_asset_platform_id": "binance-smart-chain"
            },
            {
                "id": "polygon_pos",
                "name": "Polygon POS",
                "coingecko_asset_platform_id": "polygon-pos"
            },
            {
                "id": "avax",
                "name": "Avalanche",
                "coingecko_asset_platform_id": "avalanche"
            },
            {
                "id": "movr",
                "name": "Moonriver",
                "coingecko_asset_platform_id": "moonriver"
            },
            {
                "id": "cro",
                "name": "Cronos",
                "coingecko_asset_platform_id": "cronos"
            },
            {
                "id": "one",
                "name": "Harmony",
                "coingecko_asset_platform_id": "harmony-shard-0"
            },
            {
                "id": "boba",
                "name": "Boba Network",
                "coingecko_asset_platform_id": "boba"
            },
            {
                "id": "ftm",
                "name": "Fantom",
                "coingecko_asset_platform_id": "fantom"
  
…(truncated, see openapi.json for full schema)
```

### Trending

#### `GET /v1/trending` — Trending liquidity pools on a network

**Parameters:**
- `network` (query, optional, string) — Network id (see /v1/networks) Example: `eth`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/geckoterminal-api/v1/trending?network=eth"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "pools": [
            {
                "dex": "uniswap_v2",
                "name": "SPCX / WETH",
                "fdv_usd": 2924599.3,
                "network": "eth",
                "txns_24h": {
                    "buys": 2234,
                    "sells": 1060,
                    "buyers": 1272,
                    "sellers": 404
                },
                "created_at": "2026-05-25T00:54:11Z",
                "reserve_usd": 158316.15,
                "pool_address": "0x4438a8af0231b27f54da4b6c32a56d1357b369e7",
                "market_cap_usd": null,
                "volume_24h_usd": 1362717.34,
                "base_token_address": "0xcb891c8f1e3a4d04229e4d871dc27124411d8952",
                "quote_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                "base_token_price_usd": 0.0029128364,
                "price_change_24h_pct": -24.873,
                "quote_token_price_usd": 1655.9944562
            },
            {
                "dex": "uniswap_v2",
                "name": "ASTEROID / WETH",
                "fdv_usd": 44825409.85,
                "network": "eth",
                "txns_24h": {
                    "buys": 1816,
                    "sells": 1338,
                    "buyers": 774,
                    "sellers": 562
                },
                "created_at": "2024-09-10T10:18:23Z",
                "reserve_usd": 1911757.2,
                "pool_address": "0x76a41
…(truncated, see openapi.json for full schema)
```

### New

#### `GET /v1/new` — Most recently created pools on a network

**Parameters:**
- `network` (query, optional, string) — Network id Example: `eth`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/geckoterminal-api/v1/new?network=eth"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "pools": [
            {
                "dex": "uniswap_v2",
                "name": "MMG / WETH",
                "fdv_usd": 2310.48,
                "network": "eth",
                "txns_24h": {
                    "buys": 21,
                    "sells": 0,
                    "buyers": 21,
                    "sellers": 0
                },
                "created_at": "2026-06-10T13:58:23Z",
                "reserve_usd": 2764.19,
                "pool_address": "0x460387d2b48e7b1e47f5e59ecf14aee6006a2c3a",
                "market_cap_usd": null,
                "volume_24h_usd": 554.13,
                "base_token_address": "0x5940bc64ae082898450f667e251e6952410706db",
                "quote_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                "base_token_price_usd": 2.3105e-6,
                "price_change_24h_pct": 130.298,
                "quote_token_price_usd": 1655.9944562
            },
            {
                "dex": "uniswap_v2",
                "name": "TRILLIONUS / WETH",
                "fdv_usd": 2194.38,
                "network": "eth",
                "txns_24h": {
                    "buys": 3,
                    "sells": 0,
                    "buyers": 3,
                    "sellers": 0
                },
                "created_at": "2026-06-10T13:57:47Z",
                "reserve_usd": 4081.2,
                "pool_address": "0xa1e38ae07a6d606078f8588241b0302ef097e70d"
…(truncated, see openapi.json for full schema)
```

### Pool

#### `GET /v1/pool` — One pool's live price, liquidity, volume and transactions

**Parameters:**
- `address` (query, required, string) — Pool contract address Example: `0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640`
- `network` (query, optional, string) — Network id Example: `eth`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/geckoterminal-api/v1/pool?address=0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640&network=eth"
```

**Response:**
```json
{
    "data": {
        "dex": "uniswap_v3",
        "name": "WETH / USDC 0.05%",
        "source": "GeckoTerminal",
        "fdv_usd": 4347147372.31,
        "network": "eth",
        "txns_24h": {
            "buys": 3310,
            "sells": 2702,
            "buyers": 1081,
            "sellers": 1177
        },
        "created_at": "2021-12-29T12:35:14Z",
        "reserve_usd": 85622201.49,
        "pool_address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
        "market_cap_usd": 4348750822.48,
        "volume_24h_usd": 59560581.16,
        "base_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "quote_token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "base_token_price_usd": 1656.2217712562,
        "price_change_24h_pct": -0.942,
        "quote_token_price_usd": 1.00251406
    },
    "meta": {
        "timestamp": "2026-06-10T13:59:21.442Z",
        "request_id": "5dd9f5fd-920c-43c0-93ec-95e2e3b0455b"
    },
    "status": "ok",
    "message": "Pool retrieved successfully",
    "success": true
}
```

### Search

#### `GET /v1/search` — Find pools by token name, symbol or address

**Parameters:**
- `q` (query, required, string) — Token name, symbol or address Example: `WETH`
- `network` (query, optional, string) — Restrict to a network Example: `eth`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/geckoterminal-api/v1/search?q=WETH&network=eth"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "pools": [
            {
                "dex": "uniswap_v3",
                "name": "WETH / USDC 0.05%",
                "fdv_usd": 4346939074.79,
                "network": "eth",
                "txns_24h": {
                    "buys": 3310,
                    "sells": 2703,
                    "buyers": 1081,
                    "sellers": 1177
                },
                "created_at": "2021-12-29T12:35:14Z",
                "reserve_usd": 85603348.66,
                "pool_address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
                "market_cap_usd": 4348542448.13,
                "volume_24h_usd": 59563520.47,
                "base_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                "quote_token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
                "base_token_price_usd": 1655.9963978931,
                "price_change_24h_pct": -0.947,
                "quote_token_price_usd": 1.00345068
            },
            {
                "dex": "uniswap_v3",
                "name": "WETH / USDT 0.3%",
                "fdv_usd": 4346781910.12,
                "network": "eth",
                "txns_24h": {
                    "buys": 1085,
                    "sells": 446,
                    "buyers": 237,
                    "sellers": 155
                },
                "created_at": "2021-12-29T12:36:12Z",
                "reserve_usd": 67082359.09,
             
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/geckoterminal-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "GeckoTerminal API (api.geckoterminal.com, live)",
        "service": "geckoterminal-api",
        "endpoints": {
            "GET /v1/new": "Most recently created pools on a network (network=eth).",
            "GET /v1/meta": "This document.",
            "GET /v1/pool": "One pool's live price, liquidity, volume and transactions (network=eth, address=0x...).",
            "GET /v1/search": "Find pools by token name, symbol or address (q=WETH, optional network=eth).",
            "GET /v1/networks": "Every supported blockchain network (page=1).",
            "GET /v1/trending": "Trending liquidity pools on a network (network=eth)."
        },
        "description": "Live on-chain DEX pool discovery from GeckoTerminal (CoinGecko's on-chain data product), via its public API. The networks endpoint lists every supported blockchain network; the trending endpoint returns the trending liquidity pools on a network right now; the new endpoint returns the most recently created pools on a network; the pool endpoint returns one pool's live base/quote USD price, liquidity, 24h volume, price change and buy/sell transaction counts; the search endpoint finds pools by token name, symbol or address. Live, no key, nothing stored. Distinct from DEX volume-ranking feeds and from token/pair lookup APIs — this is per-network pool discovery (what's trending, what just launched) with live pool economics.",
        "upstream_status": null,
        "sample_network_c
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/geckoterminal-api
OpenAPI spec: https://www.oanor.com/api/geckoterminal-api/openapi.json