Skip to content
Circlo Docs

API Overview

Circlo exposes the same data that powers the site as free JSON endpoints.

Base URL: https://circlo.family/api

No authentication required. Responses are cached at the edge for ~60 seconds; underlying market data refreshes every 5 minutes. CORS is open (*).

Endpoints

Section titled “Endpoints”
Endpoint Description
GET /api/overview Market totals for the stats bar
GET /api/stocks All tracked tokenized stocks
GET /api/stocks/:ticker One stock + its pairs
GET /api/pairs All paired markets, volume-ranked
GET /api/pairs/:pool One pair by pool address

GET /api/overview

Section titled “GET /api/overview”
Terminal window
curl https://circlo.family/api/overview
{
  "updatedAt": "2026-09-07T17:33:59.192Z",
  "stats": {
    "stockCount": 20,
    "pairCount": 150,
    "totalLiquidity": 1102250128,
    "totalVolume24h": 279820508
  }
}

USD amounts are plain numbers. updatedAt is the snapshot timestamp of the last successful refresh.

Errors

Section titled “Errors”

When market data is unavailable the API returns 503 with { "error": "market data unavailable" } rather than zeroed values. Unknown tickers or pools return 404.