Docs / API: Markets

Trending pools

Returns pools that GeckoTerminal ranks as trending on one chain, cached for 5 minutes. A rank here is not a signal or a recommendation.

GET/api/v1/markets/pools

Property	Value
Authentication	Optional. A key raises your limit.
Rate-limit cost	1 unit
Status	Live

#Parameters

Name	In	Type	Required	Description
`chain`	query	string	No	One of `ethereum`, `base`, `bnb`, `arbitrum`, `optimism`, `polygon`, `solana`. Default `solana`.

#Request

curl -s "https://farbeamlabs.com/api/v1/markets/pools?chain=base"

const res = await fetch("https://farbeamlabs.com/api/v1/markets/pools?chain=base");
const { data, meta, error } = await res.json();
if (error) throw new Error(`${error.code}: ${error.message}`);
console.log(data);

import os, requests

res = requests.get(
    "https://farbeamlabs.com/api/v1/markets/pools?chain=base",
    timeout=30,
)
body = res.json()
if "error" in body:
    raise RuntimeError(body["error"]["code"])
print(body["data"])

You can send this request now in the API playground.

#Response

This response is real. It was captured from the running API when this page was built. Arrays are cut to two items.

JSON

{
  "data": [
    {
      "name": "CLANKER / WETH 1%",
      "pool": "0xc1a6fbedae68e1472dbb91fe29b51f7a0bd44f97",
      "base_token": "0x1bc0c42215582d5a085795f4badbac3ff36d1bcb",
      "price_usd": 23.3161859333654,
      "liquidity_usd": 2354273,
      "volume_24h_usd": 2345317,
      "change_24h_pct": 80.311,
      "created_at": "2024-11-08T20:43:33Z"
    },
    {
      "name": "Reboot / WETH",
      "pool": "0x66586da3aea24479b77183ef74dca95eb2b28541cb92f45d273e9790a4dd464a",
      "base_token": "0x6f18277e5566090ad8ab35e401ce9155739bfb07",
      "price_usd": 4.99701550224519e-06,
      "liquidity_usd": 387472,
      "volume_24h_usd": 1131034,
      "change_24h_pct": -0.543,
      "created_at": "2026-11-03T18:52:17Z"
    }
  ],
  "meta": {
    "request_id": "req_7db06b2383b8",
    "as_of": "2026-11-04T20:10:58.158Z",
    "source": "geckoterminal",
    "chain": "base"
  }
}

#Errors

HTTP	Code	Meaning
400	`invalid_chain`	The chain is unknown.
502	`upstream_unavailable`	A public data source did not answer.

All errors share one format. See errors.

PreviousDEX volume NextStart wallet sign-in