API v1

PairsFun public API

Every PairsFun token, its pools, its fees, $PAIRS supply and burns, and the protocol totals, as JSON over HTTPS. No key, no sign-up, and CORS is open to any site, so a page can call it straight from the browser.

Quick start

Base URL https://pairsfun.xyz/v1 (the same calls also answer under /api/v1). Plain GET requests, nothing to sign up for.

curl "https://pairsfun.xyz/v1/tokens?sort=mcap&limit=10"
curl "https://pairsfun.xyz/v1/tokens/WecNBsywJKQLGfBKZzBSix3ykXJ11DfAGUiXCLypair"
curl "https://pairsfun.xyz/v1/stats"

From a browser or a bot, with fetch only. This reads every token on the bonding curve, page by page:

const API = 'https://pairsfun.xyz/v1'

async function get(path) {
  const res = await fetch(API + path)
  const json = await res.json()
  // Errors always look the same: { error: { code, message, status, requestId, retryAfterSec? } }
  if (!res.ok) throw Object.assign(new Error(json.error.message), json.error)
  return json
}

const tokens = []
let cursor = null
do {
  const page = await get('/tokens?status=curve&sort=progress&limit=100' + (cursor ? '&cursor=' + cursor : ''))
  tokens.push(...page.tokens)
  cursor = page.nextCursor
} while (cursor)

for (const t of tokens) console.log(t.symbol, t.curve.progressPct + '%', t.marketCapUsd)

Endpoints

All of them are GET and need no key. The cache column says how long the same answer is served to everyone; polling faster than that returns the same data.

Token list

GET /tokens lists every token on PairsFun. Test coins and tokens taken down by moderation are not in it.

The answer is { "tokens": [...], "nextCursor": "50", "total": 214 }, where total counts every token that matches status and q. A new launch can shift a page by a token or two while you page through, so de-duplicate by mint.

The token object

The same object comes in /tokens, in the top lists of /stats, and inside /tokens/{mint} (with more fields). The official $PAIRS, as an example:

{
  "mint": "WecNBsywJKQLGfBKZzBSix3ykXJ11DfAGUiXCLypair",
  "name": "PairsFun",
  "symbol": "PAIRS",
  "image": "https://pairsfun.xyz/meta/img/WecNBsywJKQLGfBKZzBSix3ykXJ11DfAGUiXCLypair.png",
  "status": "graduated",
  "createdAt": "2026-11-05T04:28:05.000Z",
  "creator": "C478RVVWiAg2eFBr8BTw619qhkKSQFQuudEZUuqNtw5y",
  "decimals": 6,
  "priceUsd": 0.0000496,
  "marketCapUsd": 49601.22,
  "liquidityUsd": 15368.72,
  "volume24hUsd": 338568.45,
  "volumeAllUsd": 338568.45,
  "curve": {
    "pool": "F3vscNPnybdZJG7k3tWG7XdHCGZZBAs8nYoxRd3vt1cT",
    "quoteMint": "So11111111111111111111111111111111111111112",
    "quoteDecimals": 9,
    "progressPct": 100,
    "raisedRaw": "200000000196",
    "targetRaw": "200000000000",
    "priceInQuote": 5.134e-7,
    "migrating": false
  },
  "mainPool": "4qq6m4MMfd84fW5USDMWvzvFoJZVETsuuVuqvLRuuBW3",
  "pairAssets": [
    { "mint": "XsDoVfqeBukxuZHWhdvWHBhgEHjGNst4MLodqsJHzoB", "symbol": "TSLAx", "weightBps": null, "pool": null },
    { "mint": "Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh", "symbol": "NVDAx", "weightBps": null, "pool": null },
    { "mint": "XsoCS1TfEyfFhfvj8EtZ528L3CaKBDBRqRapnBbDF2W", "symbol": "SPYx", "weightBps": null, "pool": null }
  ],
  "fake": false,
  "url": "https://pairsfun.xyz/coin/WecNBsywJKQLGfBKZzBSix3ykXJ11DfAGUiXCLypair"
}

GET /tokens/{mint} answers { "token": { ... } } with all of the above plus description, links (the creator's website, X, Telegram), supplyRaw, launch (dev buy, launch and migration transactions), pools (each with its role: curve, main, basket or multipair) and proofs, the on-chain checks shown on the token page, each with a link to check it yourself.

Conventions

• Amounts whose name ends in Raw or Lamports are integers in base units, as strings, so nothing is lost to floating point. Divide by 10^decimals (SOL has 9).
• USD values are numbers. null means not known right now.
• Times are ISO 8601 in UTC, such as 2026-11-05T04:28:05.000Z. Chart points use unix seconds to stay compact.
• Pct is a percent (0.5 means half a percent). Bps are basis points (4500 means 45%).
• Unknown fields: ignore them. New fields and new enum values can appear at any time within v1.

Limits

Every answer, a 304 and an error included, carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset (seconds); only /config and /openapi.json have no limit and no such headers. Over the limit you get 429 rate_limited with Retry-After, the same number in error.retryAfterSec. Need more? DM @pairsfun_xyz on X.

Caching

Answers are shared: everyone asking the same thing within the cache time in Endpoints gets the same answer, and it comes with Cache-Control: public, max-age for the time it has left. Each answer also carries an ETag: send it back as If-None-Match and an unchanged answer is 304 Not Modified with no body. A 304 still counts toward the limit.

Errors

HTTP 404
{
  "error": {
    "code": "not_found",
    "message": "No PairsFun token with this mint.",
    "status": 404,
    "requestId": "req_9f2c41d07a3b55e1"
  }
}

Branch on code, show message, quote requestId when you write to us. The text can change, the code does not.

Versioning