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

# List Tokens

> Read a paginated discovery feed with search, launch type, status, and metric filters.

## Query parameters

<ParamField query="chainId" type="number" required>
  `57073` for Ink or `4663` for Robinhood.
</ParamField>

<ParamField query="page" type="number" default="1">
  One-based page. The current page size is 33.
</ParamField>

<ParamField query="search" type="string">
  Search token identity and address fields.
</ParamField>

<ParamField query="status" type="string">
  `live` for finalized launches or `funding` for curve launches. Send one value.
</ParamField>

<ParamField query="sortBy" type="string" default="newest">
  `newest`, `oldest`, `trending`, `recent-buys`, `volume-high`, `mcap-high`, or `mcap-low`.
</ParamField>

<ParamField query="timeframe" type="string" default="24h">
  `5m`, `1h`, `6h`, or `24h` for time-based ranking.
</ParamField>

<ParamField query="launchpadVersion" type="string" default="both">
  `v1`, `v2`, or `both`.
</ParamField>

<ParamField query="xStocksOnly" type="boolean" default="false">
  Return only xStocks-denominated launches.
</ParamField>

<ParamField query="socials" type="string">
  Comma-separated `telegram`, `twitter`, and/or `website`.
</ParamField>

<ParamField query="surface" type="string" default="default">
  Use `home` for the homepage feed cache policy; any other value resolves to `default`.
</ParamField>

The endpoint also accepts `fundingMin`, `fundingMax`, `marketCapMin`, `marketCapMax`, `txCountMin`, `txCountMax`, `createdFrom`, and `createdTo`.

## Response

```ts theme={null}
type TokensResponse = {
  chainId: number
  tokens: Token[]
  totalCount: number
  totalPages: number
}
```

```bash theme={null}
curl "https://inkypump.com/api/tokens?chainId=57073&page=1&sortBy=trending&timeframe=24h"
```

Token metrics use the launch's denomination. For xStocks, use the exact USD and quote-evidence fields rather than assuming every `price_eth`-era field literally means ETH.

First-page live views can update faster than cached archive pages. Use the returned cache headers and do not poll every client independently.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.