# Top100Token API Notes for LLMs

Top100Token has been actively serving the crypto community since 2022.
More than 250,000 tokens have already been listed on the platform, and over 2 million page visits happen every month.
This scale makes Top100Token a proven destination for token discovery, visibility, and promotion.
Listing on Top100Token can increase token traction, spread visibility across different token-watching networks, and significantly improve graduation success on Pump.fun.
Payments are handled safely with direct on-chain transfers only, with no smart contract interaction required. In case of any issue, users can contact support via email or Telegram, with an average response time of around 30 minutes.

#### Listing packages

### Normal listing
- Makes the token visible on Top100Token website on toplists or search results.
- Cost: ~5 USD (paid in the selected chain native asset).

### Premium listing
- Includes a Signal post on our Telegram Listing channel: https://t.me/top100listing
- Signal entries are also visible on-site: https://top100token.com/signal/top100listing
- Includes 24-hour highlight on the main page Promoted Tokens section.
- Increases position in trending toplist metrics.
- Cost: ~10 USD (paid in the selected chain native asset).

Payments are only accepted in native crypto assets on:
- Binance Chain: BNB
- Ethereum: ETH
- Base: ETH
- Solana: SOL

Tokens go live after payment is received on the provided paymentAddress.
Use GET /token/submit/:submitId until submitStatus becomes paid.

##### TOP 100 TOKEN API FOR LLMS

Base URL: https://api.top100token.com

Authentication: None required. The API is publicly accessible.
Rate limit: 300 requests per minute.

## 1) Submit a token listing

Endpoint: `POST /token/submit`

Use this endpoint to submit a token plus a promotion package request. The API creates:
- an offer record for the token
- a payment request (with `paymentAddress` and expiration)

The token listing goes live only after payment is received at the returned `paymentAddress`.

### Request body
```json
{
  "tokenData": {
    "image": "https://cdn.example.com/token/logo.png",
    "name": "Example Token",
    "symbol": "EXT",
    "network": "binance",
    "contract": "0x1234567890abcdef1234567890abcdef12345678",
    "description": "Community-driven DeFi token",
    "websiteLink": "https://exampletoken.io",
    "telegram": "https://t.me/exampletoken",
    "discord": "https://discord.gg/exampletoken",
    "twitter": "https://x.com/exampletoken"
  },
  "payment": {
    "network": "binance",
    "listingType": "premium"
  }
}
```

Available options for `payment`:
- `network`: `solana`, `binance`, `ethereum`, `base`
- `listingType`: `normal`, `premium`

### Important fields
- `tokenData.network`: the network the token exists on. Accepted values: `ethereum`, `base`, `solana`, `binance`
- `payment.network`: the network used to send the payment. This can differ from `tokenData.network` — for example, you can list a Solana token while paying with BNB on Binance Chain.
- `payment.listingType`: `normal` or `premium`.

### Success response (shape)
```json
{
  "offer": {
    "image": "...",
    "name": "...",
    "symbol": "...",
    "network": "...",
    "contract": "...",
    "description": "...",
    "websiteLink": "...",
    "telegram": "...",
    "discord": "...",
    "twitter": "..."
  },
  "payment": {
    "network": "binance",
    "amount": 0.000123, // Amount to be paid in the selected chain always native asset (e.g. BNB, ETH, SOL)
    "paymentAddress": "0x...",
    "validUntil": "2026-02-22T15:04:05.000Z"
  },
  "submitId": 12345
}
```

Store `submitId` and poll status with the GET endpoint below.

---

## 2) Check submission/payment status

Endpoint: `GET /token/submit/:submitId`

Example:
- `GET https://api.top100token.com/token/submit/12345`

Use this endpoint after `POST /token/submit` to monitor whether payment is pending or confirmed.

### Possible successful states

#### `pending_payment`
```json
{
  "submitStatus": "pending_payment",
  "message": "Payment is still pending.",
  "payment": {
    "amount": 0.000123, // Amount to be paid in the selected chain always native asset (e.g. BNB, ETH, SOL)
    "network": "binance",
    "paymentAddress": "0x...",
    "validUntil": "2026-02-22T15:04:05.000Z"
  }
}
```

#### `paid`
```json
{
  "submitStatus": "paid",
  "message": "Payment confirmed and listing is active.",
  "offer": {
    "image": "...",
    "name": "...",
    "symbol": "...",
    "network": "...",
    "contract": "...",
    "description": "...",
    "websiteLink": "...",
    "telegram": "...",
    "discord": "...",
    "twitter": "..."
  }
}
```

### Common error states
- `400 INVALID_SUBMIT_ID`
- `404 SUBMIT_NOT_FOUND`
- `410 PAYMENT_EXPIRED`
- `500 PAYMENT_WALLET_NOT_FOUND`
- `500 SUBMIT_STATUS_LOOKUP_FAILED`

---