Skip to content
Circlo Docs

Stocks API

GET /api/stocks

Section titled “GET /api/stocks”

All tracked tokenized stocks, Pons v2 pairing assets first, then by 24-hour volume.

Terminal window
curl https://circlo.family/api/stocks
{
  "updatedAt": "2026-09-07T17:33:59.192Z",
  "stocks": [
    {
      "symbol": "NVDA",
      "ticker": "NVDA",
      "name": "NVIDIA",
      "address": "0xd0601ce157db5bdc3162bbac2a2c8af5320d9eec",
      "usedByPons": true,
      "logoUrl": "https://coin-images.coingecko.com/coins/images/.../nvda.png",
      "priceUsd": 232.06,
      "change24h": 0.32,
      "volume24h": 59035789,
      "liquidity": 35692108,
      "poolCount": 20
    }
  ]
}
Field Meaning
usedByPons Stock appears as a pairing asset in live Pons v2 pools
priceUsd Latest on-chain price (USD); null if unavailable
change24h 24-hour price change (%) from the deepest pool
volume24h / liquidity Totals across all indexed pools (USD)

GET /api/stocks/:ticker

Section titled “GET /api/stocks/:ticker”

One stock plus every paired market containing it. :ticker is the stock symbol, case-insensitive.

Terminal window
curl https://circlo.family/api/stocks/aapl

Returns { updatedAt, stock, pairs } where pairs uses the pair object shape.