> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alphscan.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Token API

> List tokens with pagination via client.token

The **Token API** lists registered tokens from `GET /token/all`. It is **public** (no API key required).

## client.token

```typescript theme={null}
const client = alphscan({ apiUrl: "https://api.alphscan.io" });
const result = await client.token.list({ page: 1, pageSize: 20 });
```

## TokenApi

| Method          | Returns                      | Description           |
| --------------- | ---------------------------- | --------------------- |
| `list(params?)` | `Promise<TokenListResponse>` | Paginated token list. |

## TokenListParams

| Field      | Type     | Default | Description          |
| ---------- | -------- | ------- | -------------------- |
| `page`     | `number` | `1`     | 1-based page index.  |
| `pageSize` | `number` | `20`    | Page size (max 999). |

## TokenListResponse

| Field       | Type           | Description          |
| ----------- | -------------- | -------------------- |
| `tokens`    | `TokenEntry[]` | Page of tokens.      |
| `total`     | `number`       | Total count.         |
| `page`      | `number`       | Current page.        |
| `pageSize`  | `number`       | Page size used.      |
| `networkId` | `number`       | Optional network id. |

## TokenEntry

| Field              | Type       | Description           |
| ------------------ | ---------- | --------------------- |
| `id`               | `string`   | Token id.             |
| `name`             | `string`   | Display name.         |
| `symbol`           | `string`   | Symbol.               |
| `decimals`         | `number`   | Decimals.             |
| `description`      | `string`   | Optional description. |
| `logoURI`          | `string`   | Logo URL.             |
| `nameOnChain`      | `string`   | On-chain name.        |
| `symbolOnChain`    | `string`   | On-chain symbol.      |
| `originChain`      | `string`   | Origin chain.         |
| `unchainedLogoURI` | `string`   | Alternative logo.     |
| `category`         | `string`   | Single category.      |
| `categories`       | `string[]` | Category list.        |
| `dapp`             | `string`   | Dapp id.              |
| `chainId`          | `number`   | Chain id.             |
| `moderation`       | `string`   | Moderation status.    |
| `marketDisplay`    | `boolean`  | Show in market.       |

## Example

```typescript theme={null}
import { alphscan } from "@alphscan/sdk";

const client = alphscan({ apiUrl: "https://api.alphscan.io" });

const { tokens, total, page, pageSize } = await client.token.list({
  page: 1,
  pageSize: 50,
});

console.log(`Page ${page}: ${tokens.length} of ${total} tokens`);
tokens.forEach((t) => console.log(t.id, t.symbol, t.name));
```