Data

Token Whitelist

Check whitelist status for frozen tokens. Pass a wallet query param to check a specific address, or omit it to list all whitelisted wallets.

GET

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

List whitelisted wallets or check a specific wallet for a frozen token.

Auth: API Key required

Query Parameters

Param	Type	Description
wallet	string	Check a specific wallet address (returns boolean result)
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": "1000000",
    "note": "Early supporter",
    "txHash": "0x...",
    "timestamp": "2026-01-01T00:00:00.000Z"
  }
}

Response (list all)

Response

{
  "data": [
    {
      "walletAddress": "0x...",
      "buyAmount": "1000000",
      "note": null,
      "txHash": "0x...",
      "timestamp": "2026-01-01T00:00:00.000Z"
    }
  ],
  "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" } }
);