Tokens

List Tokens

GET

/api/v1/tokens

List, search, and filter tokens with offset pagination.

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	boolean	Filter by token type
sort	string	`newest` (default) or `oldest`
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"
    }
  ],
  "pagination": {
    "total": 1250,
    "page": 1,
    "limit": 20,
    "hasMore": true
  }
}

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 }