Skip to content
Circlo Docs

Pairs API

GET /api/pairs

Section titled “GET /api/pairs”

Every indexed pool with a tokenized stock on one side, ranked by 24-hour volume (top 150).

Terminal window
curl https://circlo.family/api/pairs
{
  "updatedAt": "2026-09-07T17:33:59.192Z",
  "pairs": [
    {
      "poolAddress": "0x61374f1c9dfa87fee1e5104c78406a6dabb60a02",
      "name": "NVDA / USDG 0.05%",
      "dex": "uniswap-v3-robinhood",
      "dexLabel": "Uniswap v3",
      "display": "NVDA / USDG",
      "stockTicker": "NVDA",
      "stockSymbol": "NVDA",
      "otherSymbol": "USDG",
      "otherAddress": "0x5fc5360d0400a0fd4f2af552add042d716f1d168",
      "otherLogoUrl": "https://coin-images.coingecko.com/coins/images/.../usdg.png",
      "feePct": 0.05,
      "volume24h": 22934148,
      "liquidity": 6931673,
      "change24h": 0.3,
      "trades24h": 41230,
      "createdAt": "2026-07-02T20:51:08Z"
    }
  ]
}
Field Meaning
display Circlo display name — the tokenized stock is always the anchor
dexLabel Venue: Pons v2, Uniswap v3/v4, Bankr, …
feePct Fee tier (%) when the venue exposes it, else null
trades24h Buys + sells over 24 hours

GET /api/pairs/:pool

Section titled “GET /api/pairs/:pool”

One pair by its pool address (lowercase hex).

Terminal window
curl https://circlo.family/api/pairs/0x61374f1c9dfa87fee1e5104c78406a6dabb60a02

Returns { updatedAt, pair, stock } — stock is the anchor tokenized stock.