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

# List Tokens

> Get all indexed tokens with metadata, prices, and 24h volume

# List Tokens

Returns all tokens that have been created on the Launchpad or indexed from AMM trading. Each token includes its current price, XYZ reserves, 24-hour volume, and graduation status.

## Endpoint

```
GET /api/tokens
```

## Request

No parameters required.

```bash theme={null}
curl http://67.205.164.156:3001/api/tokens
```

## Response

```json theme={null}
{
  "tokens": [
    {
      "address": "xyz1cw20contractaddress...",
      "name": "Example Token",
      "symbol": "EXT",
      "image": "https://...",
      "description": "An example token launched on XYZ",
      "creator": "xyz1creatoraddress...",
      "source": "launchpad",
      "graduated": true,
      "xyz_reserves": "5200000000000",
      "current_price": "52000",
      "volume_24h": "1500000000000",
      "trade_count_24h": 342,
      "created_at": "2026-02-10T08:00:00.000Z",
      "first_seen_at": "2026-02-10T08:00:15.000Z"
    },
    {
      "address": "xyz1anothertoken...",
      "name": "Meme Coin",
      "symbol": "MEME",
      "image": null,
      "description": null,
      "creator": "xyz1someuser...",
      "source": "launchpad",
      "graduated": false,
      "xyz_reserves": "320000000000",
      "current_price": "3200",
      "volume_24h": "50000000000",
      "trade_count_24h": 18,
      "created_at": "2026-02-18T14:00:00.000Z",
      "first_seen_at": "2026-02-18T14:00:10.000Z"
    }
  ]
}
```

## Response Fields

| Field             | Type           | Description                                                                                                                                                 |
| ----------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `address`         | string         | CW20 contract address of the token                                                                                                                          |
| `name`            | string \| null | Token name (set at creation)                                                                                                                                |
| `symbol`          | string \| null | Token ticker symbol                                                                                                                                         |
| `image`           | string \| null | Token image URL                                                                                                                                             |
| `description`     | string \| null | Token description                                                                                                                                           |
| `creator`         | string \| null | Address that created the token                                                                                                                              |
| `source`          | string         | Where the token originated: `"launchpad"` or `"amm"`                                                                                                        |
| `graduated`       | boolean        | `true` if the token has graduated from bonding curve to AMM                                                                                                 |
| `xyz_reserves`    | string         | Current XYZ reserves in `uxyz`. For bonding curve tokens, this is the curve's reserve. For graduated tokens, this reflects the last known AMM pool reserve. |
| `current_price`   | string         | Latest trade price in `uxyz` per token, scaled by 10^6. Divide by 10^6 to get price in `uxyz`.                                                              |
| `volume_24h`      | string         | Total trading volume in `uxyz` over the last 24 hours                                                                                                       |
| `trade_count_24h` | number         | Number of trades in the last 24 hours                                                                                                                       |
| `created_at`      | string \| null | Token creation timestamp (from on-chain event)                                                                                                              |
| `first_seen_at`   | string         | When the indexer first observed this token                                                                                                                  |

### Understanding Prices

Prices are stored as integers scaled by 10^6 to avoid floating-point precision issues:

```
current_price = "52000"  →  52000 / 10^6 = 0.052 uxyz per micro-token
                         →  0.052 XYZ per token (since both have 6 decimals)
```

### Understanding Reserves

For tokens still on the bonding curve, `xyz_reserves` indicates how close the token is to graduation:

```
Graduation threshold is dynamic per token (computed from oracle XYZ/USD price).
Query the launchpad contract's "progress" endpoint for exact threshold.
Current reserves:  3200000000000 uxyz
Progress: reserves / threshold = percentage toward graduation
```

## Ordering

Tokens are returned ordered by `first_seen_at` descending (newest first).