Tokens

List Tokens

GET

/api/v1/tokens

Every token in the on-chain registry (the mains and every FactoryToken), with or without posted metadata, offset paged. Rows carry main, pair asset, kind, price (priceE18, priceUsdE18), 24 h change, trades and USD volume, circulating supply, market cap, liquidity and depth.

Auth: API Key required

Query Parameters

Param	Type	Description
search	string	Filter by name, symbol, or address
dev	string	Filter by creator wallet address
isPrediction	string	`true` or `false` (400 on any other value)
main	string	Main token address or key: only tokens of that main (and the main itself)
kind	string	`main`, `token`, `reversed`, `market`, `marketPrivate` or `updownPool`
predictionStatus	string	Only markets in this indexed status (for example `active`)
sort	string	`newest` (default), `oldest`, `volume24h`, `change24h`, `mcap` or `trades24h`
order	string	`desc` (default) or `asc`, for the volume24h, change24h, mcap and trades24h sorts. Nulls always sort last.
page	number	Page number (default: 1)
limit	number	Items per page (default: 20, max: 100)

Response

{
  "data": [
    {
      "id": 1,
      "address": "0x...",
      "name": "My Token",
      "symbol": "MTK",
      "description": "...",
      "dev": "0x...",
      "image": "https://...",
      "multiplier": 50,
      "isPrediction": false,
      "predictionType": null,
      "predictionStatus": null,
      "createdAt": "2026-01-01T00:00:00.000Z",
      "lastActivityAt": "2026-03-13T00:00:00.000Z",
      "chainId": 4663,
      "main": "0x...",
      "pairAsset": "0x...",
      "pairDecimals": 6,
      "pairSymbol": "USDG",
      "kind": "token",
      "reversed": false,
      "hybridMultiplier": 50,
      "rewardsEnabled": true,
      "frozen": false,
      "presaleTarget": "0",
      "presaleComplete": true,
      "listed": true,
      "creator": "0x...",
      "host": null,
      "volume24hUsdE18": "0"
    }
  ],
  "pagination": {
    "total": 1250,
    "page": 1,
    "limit": 20,
    "hasMore": true
  }
}

main is the main token the row trades against (a main names itself, with kind: main); pairAsset / pairDecimals are that main's pair asset. Registry fields are null until the token is indexed. volume24hUsdE18 is USD × 1e18 over the last 24 h. Before the deployment is live the endpoint answers 503.

Example Code

// List tokens with search and pagination
const res = await fetch(
  "https://launchonbasis.com/api/v1/tokens?search=ETH&isPrediction=false&sort=newest&page=1&limit=20",
  { headers: { "X-API-Key": "bsk_your_key" } }
);
const { data, pagination } = await res.json();
// pagination = { total, page, limit, hasMore }