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

# Tokens

Endpoints for searching, listing, and retrieving Clanker token data.

### GET `/api/tokens/authenticated`

Search and list tokens (authenticated variant with higher limits up to 200 per page).

**Authentication:** Partner API Key (`x-api-key` header)

**Query Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `q` | `string` | No | — | Free-text search query. |
| `fids` | `string` | No | — | Comma-separated FIDs. |
| `msgSender` | `address` | No | — | Deployer address filter. |
| `pairAddress` | `address` | No | — | Pool/pair address filter. |
| `sort` | `"asc" \| "desc"` | No | desc | Sort direction. |
| `sortBy` | `"market-cap" \| "tx-h24" \| "price-percent-h24" \| "price-percent-h1" \| "deployed-at"` | No | — | Sort field. |
| `socialInterface` | `string` | No | — | Social interface filter. |
| `cursor` | `string` | No | — | Pagination cursor. |
| `startDate` | `number` | No | — | Start date filter (unix timestamp). |
| `limit` | `number` | No | 10 | Page size (0–200). |
| `offset` | `number` | No | 0 | Offset. |
| `includeUser` | `boolean` | No | false | Include user data. |
| `includeMarket` | `boolean` | No | false | Include market data. |
| `chainId` | `number` | No | — | Chain ID. |
| `champagne` | `boolean` | No | false | Champagne filter. |
| `pair` | `string` | No | all | Paired token filter. |

**Response:** Paginated token list.

```json theme={null}
{
  "data": [ ... ],
  "total": 1234,
  "cursor": "eyJ..."
}
```

***

### GET `/api/get-clanker-by-address`

Returns detailed token data by EVM contract address or Solana token mint, including deployer info and social URLs.

**Authentication:** Partner API Key (`x-api-key` header)

**Query Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `address` | `address` | Yes | — | EVM token contract (0x…) or Solana mint address. |

**Response:** Token data with social URLs and verified address.

```json theme={null}
{
  "data": {
    "contract_address": "0x...",
    "name": "Token",
    "symbol": "TKN",
    "farcasterVerifiedEthAddress": "0x...",
    "twitterUrl": "https://...",
    "websiteUrl": "https://...",
    ...
  }
}
```

> Cached for 2 minutes.

***

### GET `/api/get-clankers-by-fid`

Returns tokens deployed by a Farcaster FID.

**Authentication:** Partner API Key (`x-api-key` header)

**Query Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `fid` | `number` | Yes | — | Farcaster ID (positive integer). |
| `cursor` | `string` | No | — | Pagination cursor. |

**Response:** Paginated token list.

```json theme={null}
{
  "data": [ ... ],
  "pagination": { "cursor": "eyJ...", "total": 42, "totalPages": 5 }
}
```

> Fixed page size of 10. Cached for 5 seconds.

***

### GET `/api/tokens/fetch-by-admin`

Returns tokens administered by a given address.

**Authentication:** Partner API Key (`x-api-key` header)

**Query Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `admin` | `address` | Yes | — | Admin wallet address. |
| `cursor` | `string` | No | — | Pagination cursor. |
| `limit` | `number` | No | 10 | Page size (1–200). |
| `includeUser` | `boolean` | No | false | Include user data. |
| `includeMarket` | `boolean` | No | false | Include market data. |
| `chainId` | `number` | No | — | Chain ID. |

**Response:** Paginated token list.

```json theme={null}
{
  "data": [ ... ],
  "total": 10,
  "cursor": "eyJ..."
}
```

***

### GET `/api/tokens/is-blocked`

Checks whether a token address is blocked.

**Authentication:** Partner API Key (`x-api-key` header)

**Query Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `address` | `address` | Yes | — | Token contract address. |
| `chainId` | `number` | No | — | Chain ID (optional — checks globally if omitted). |

**Response:** Blocked status.

```json theme={null}
{
  "address": "0x...",
  "blocked": false
}
```

> Cached for 1 minute.

***


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