Developers

Everything an explorer, screener or wallet needs to index usebnb coins on BNB Chain: a free public API, token metadata with logos, and the on-chain events. No API key needed.

Overview

Every usebnb coin is a plain 18-decimal ERC-20 with a fixed supply of 1,000,000,000, created by the Launchpad contract. It trades on a bonding curve inside the Launchpad until 800M tokens are sold, then its liquidity moves to a PancakeSwap V3 1% pool that is locked forever. Each token stores a metadataURI() pointing to JSON with its logo and links.

Contracts (BNB Smart Chain, chain id 56)

Public API

JSON over HTTPS, CORS enabled, 120 requests per minute per IP. Responses are cached for about 10 seconds. Fields are only ever added, never renamed or removed.

  • GET https://usebnb.app/api/public/v1/tokens?order=desc&limit=50&before=<unix>
  • GET https://usebnb.app/api/public/v1/tokens?order=asc&since=<unix>
  • GET https://usebnb.app/api/public/v1/tokens/<address>
  • GET https://usebnb.app/api/public/v1/launchpad

/tokens lists coins by launch time. Use order=asc&since= to poll for new launches, or before= to page back through history. Cursors are inclusive, so dedupe by address. When a page is full, next holds the cursor for the next request; otherwise it is null. /tokens/<address> returns 404 for tokens not created by usebnb.

status is trading (on the bonding curve), completed (curve sold out, migrating) or migrated (trading on pool.address).

{
  "token": {
    "chainId": 56,
    "address": "0x…",
    "name": "Example",
    "symbol": "EXM",
    "decimals": 18,
    "totalSupply": "1000000000000000000000000000",
    "image": "https://usebnb.app/api/img/<sha256>.png",
    "description": "…",
    "website": "https://…",
    "twitter": "https://x.com/…",
    "telegram": null,
    "metadataUri": "https://usebnb.app/api/meta/<sha256>",
    "creator": "0x…",
    "feeRecipientX": { "id": "44196397", "username": "elonmusk", "url": "https://x.com/elonmusk" },
    "launchpad": { "name": "usebnb", "url": "https://usebnb.app", "contract": "0x93C0824C9d279903049991A9fC04CC71DD779F1E" },
    "url": "https://usebnb.app/t/0x…",
    "createdAt": "2026-09-28T08:00:00.000Z",
    "createdTimestamp": 1790582400,
    "launchBlock": 124500000,
    "launchTx": "0x…",
    "status": "trading",
    "bondingCurveProgress": 0.1234,
    "pool": null,
    "priceBnb": 0.0000000061,
    "priceUsd": 0.0000038,
    "marketCapBnb": 6.1,
    "marketCapUsd": 3800,
    "curveLiquidityBnb": 0.42,
    "volumeBnb": 1.8,
    "trades": 37,
    "holders": 12,
    "lastTradeAt": "2026-09-28T08:05:00.000Z"
  }
}

Token metadata and logos

metadataURI() on each token and the metadataURI field of TokenLaunched point to a content-addressed JSON file. It never changes and is served with CORS enabled. Logos are PNG, JPG, GIF or WEBP, at most 2 MB, at absolute HTTPS URLs.

{
  "name": "Example",
  "symbol": "EXM",
  "description": "…",
  "image": "https://usebnb.app/api/img/<sha256>.png",
  "website": "https://…",
  "twitter": "https://x.com/…",
  "telegram": "https://t.me/…",
  "createdOn": "https://usebnb.app"
}

Events

Index these to follow launches, curve trades and graduation without the API.

TokenLaunched · Launchpad

TokenLaunched(address indexed token, address indexed creator, uint64 indexed xUserId, string name, string symbol, string metadataURI, uint16 deployerBps)

topic0 0xcd93be88c09eec89b4f7bb0691382cd039d2ab95c9b2ce261543cac4ad9eb872

Trade · Launchpad

Trade(address indexed token, address indexed trader, bool isBuy, uint256 bnbAmount, uint256 tokenAmount, uint256 protocolFee, uint256 creatorFee, uint256 tokenReserve, uint256 bnbReserve)

topic0 0x952ff8d90add9fdeaeb478102d54441cf0cc0cbe53b1d99e51f747cdc8379e54

CurveCompleted · Launchpad

CurveCompleted(address indexed token)

topic0 0xa0a0c0fe2202393c1af7f6919ecd56c835ac1395aa519b430721ea8135e51acc

Migrated · LpLocker

Migrated(address indexed token, address indexed pool, uint256 tokenId, uint128 liquidity)

topic0 0x1e424623b1c84405af782b96042a0f8d2aa1b2b747b077c0fc1fca8784192d9a

Curve price in BNB per token is (bnbReserve + 6.14) / (tokenReserve + 107,036,752) using the reserves from the latest Trade event (both in whole units). After migration, use the PancakeSwap V3 pool.

Contact

Integrating usebnb or need a higher rate limit? Email [email protected].