Token Endpoints

Token stats, first buyers, launch analytics.

token_first_buyers

First addresses to receive an ERC20 token. Launchpad analytics: who got in first?

ParamRequiredDescription
tokenYesToken contract address
limitNoMax buyers (default 20)
 
GET /api/token_first_buyers?token=0x...&limit=20

Returns: buyers (address, firstSeenBlock, firstSeenAt, transferCount)

token_stats

Token summary: transfer count, holder count, unique wallets, first seen block.

GET /api/token_stats?token=0x...

Returns: transferCount, holderCount, uniqueWallets, firstSeenBlock, firstSeenAt

token_holders

Get the top holders of an ERC-20 token with estimated balances (computed from transfer deltas).

GET /api/token_holders?token=0x...&limit=50

Response:

{
  "token": "0x...",
  "holders": [
    { "address": "0xabc...", "balance": "1000000" },
    { "address": "0xdef...", "balance": "500000" }
  ],
  "count": 50
}

Note: Balances are estimates from indexed transfer data, not real-time on-chain state.

whale_transfers

Large native MON transfers within a recent block window.

GET /api/whale_transfers?min_mon=100&blocks=10000&limit=50
ParamDefaultDescription
min_mon100Minimum MON value to qualify as "whale"
blocks10000Look back window (blocks)
limit50Max results (max 200)

Response:

{
  "minMon": 100,
  "blocksWindow": 10000,
  "transfers": [
    { "from": "0x...", "to": "0x...", "amount": "5000.000000", "amountWei": "5000000000000000000000", "txHash": "0x...", "blockNumber": 72400000, "timestamp": "...", "transferType": "native" }
  ],
  "count": 1
}

Use case: Whale watching, large movement alerts, market impact analysis.