Data

Token Whitelist

Whitelist of a frozen token. The whitelist gates presale buys only (spot and leverage) while the token is frozen. It ends when the presale completes (Bonded) or when the creator lifts the freeze (FreezeLifted); after that the list has no effect (enforced: false). Pass a wallet query param to check one address, or omit it to list the whitelisted wallets. Removed wallets are not listed.

GET

/api/v1/tokens/{address}/whitelist

List whitelisted wallets, or check one wallet, for a frozen token in its presale.

Auth: API Key required

Query Parameters

Param	Type	Description
wallet	string	Check one wallet address
page	number	Page number (default: 1, ignored when wallet is set)
limit	number	Items per page (default: 20, max: 100)

Response (with ?wallet=)

Response

{
  "whitelisted": true,
  "entry": {
    "walletAddress": "0x...",
    "buyAmount": "1000000000000000000000",
    "note": "Early supporter",
    "txHash": "0x...",
    "timestamp": "2026-01-01T00:00:00.000Z",
    "removedAt": null,
    "auto": false
  },
  "isDev": false,
  "whitelistPhaseOver": false,
  "frozen": true,
  "presaleComplete": false,
  "enforced": true,
  "capTokens": "1000000000000000000000",
  "unlimited": false
}

buyAmount (also returned as capTokens) is the most tokens this wallet may buy during the freeze, in 18-decimal token units (not a USD or pair-asset amount). A very large value (2^256 − 1, unlimited: true) means no cap. A cap cannot be changed in place: the creator removes the wallet and adds it again. Market creators appear once per market with cap 0 and note Creator. What is left of a cap is read on chain: whitelistMaxBuyForUser(wallet) − whitelistBoughtByUser(wallet).

Response (list all)

Response

{
  "data": [
    {
      "walletAddress": "0x...",
      "buyAmount": "1000000000000000000000",
      "note": null,
      "txHash": "0x...",
      "timestamp": "2026-01-01T00:00:00.000Z",
      "auto": false,
      "capTokens": "1000000000000000000000",
      "unlimited": false
    }
  ],
  "pagination": {
    "total": 50,
    "page": 1,
    "limit": 20,
    "hasMore": true
  }
}

Example Code

// Check if a wallet is whitelisted for a frozen token
const check = await fetch(
  "https://launchonbasis.com/api/v1/tokens/0xTokenAddress/whitelist?wallet=0xWalletAddress",
  { headers: { "X-API-Key": "bsk_your_key" } }
);
const { whitelisted, entry } = await check.json();

// List all whitelisted wallets
const list = await fetch(
  "https://launchonbasis.com/api/v1/tokens/0xTokenAddress/whitelist?page=1&limit=50",
  { headers: { "X-API-Key": "bsk_your_key" } }
);