Tokens

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

GET `/api/tokens`

Search and list Clanker tokens with filters, sorting, and cursor-based pagination. Authentication: Public Query Parameters

Parameter	Type	Required	Default	Description
`q`	`string`	No	—	Free-text search query (max 100 chars).
`fid`	`number`	No	—	Filter by a single Farcaster FID.
`fids`	`string`	No	—	Comma-separated list of Farcaster FIDs.
`msgSender`	`address`	No	—	Filter by deployer wallet address.
`pairAddress`	`address`	No	—	Filter by pool/pair address.
`pair`	`string`	No	all	Paired token filter (e.g. “WETH”).
`sort`	`"asc" \| "desc"`	No	desc	Sort direction.
`sortBy`	`"market-cap" \| "tx-h24" \| "price-percent-h24" \| "price-percent-h1" \| "deployed-at"`	No	—	Field to sort by.
`socialInterface`	`string`	No	—	Filter by social interface.
`cursor`	`string`	No	—	Pagination cursor returned by a previous request.
`startDate`	`number`	No	—	Unix timestamp — only return tokens deployed after this date.
`limit`	`number`	No	10	Page size (0–20).
`offset`	`number`	No	0	Offset for pagination.
`includeUser`	`boolean`	No	false	Include deployer user data in the response.
`includeMarket`	`boolean`	No	false	Include market data (price, volume) in the response.
`chainId`	`number`	No	—	Chain ID (e.g. 8453 for Base).
`champagne`	`boolean`	No	false	Filter for champagne tokens.

Response: Paginated list of tokens with optional user and market data.

{
  "data": [ { "contract_address": "0x...", "name": "Token", "symbol": "TKN", ... } ],
  "total": 1234,
  "cursor": "eyJ...",
  "tokensDeployed": 1234
}

Returns 503 with Retry-After: 5 on search timeout. Cached for 2 s at the edge.

Returns trending token pools from CoinGecko. Authentication: Public Query Parameters

Parameter	Type	Required	Default	Description
`page`	`number`	No	1	Page number.
`order`	`string`	No	h24_price_change_percentage_desc	Sort order (see CoinGecko order values).
`chainId`	`number`	No	—	Chain ID.

Response: List of trending pool addresses and their pool data.

{
  "trending": ["0xabc...", "0xdef..."],
  "tokens": { "0xabc...": { ... } }
}

Cached for 5 minutes (s-maxage=300).

GET `/api/tokens/fetch-deployed-by-fid`

Returns tokens deployed by a Farcaster FID. Authentication: Public Query Parameters

Parameter	Type	Required	Default	Description
`fid`	`string`	Yes	—	Farcaster ID.
`cursor`	`string`	No	—	Pagination cursor.

Response: Paginated token list.

{
  "data": [ ... ],
  "total": 42,
  "cursor": "eyJ..."
}

GET `/api/tokens/fetch-deployed-by-address`

Returns tokens deployed by a wallet address. Authentication: Public Query Parameters

Parameter	Type	Required	Default	Description
`address`	`address`	Yes	—	Wallet address.
`cursor`	`string`	No	—	Pagination cursor.

Response: Paginated token list.

{
  "data": [ ... ],
  "cursor": "eyJ...",
  "total": 5
}

GET `/api/tokens/fetch-by-pool-address`

Returns token data for a single pool address. Authentication: Public Query Parameters

Parameter	Type	Required	Default	Description
`poolAddress`	`address`	Yes	—	Uniswap pool address.

Response: Token object or undefined.

{
  "data": { "contract_address": "0x...", ... }
}

POST `/api/tokens/fetch-by-pool-addresses`

Returns token data for multiple pool addresses (max 100). Authentication: Public Body Parameters

Parameter	Type	Required	Default	Description
`poolAddresses`	`string[]`	Yes	—	Array of pool addresses.

Response: Map of lowercase pool addresses to token objects.

{
  "data": {
    "0xabc...": { "contract_address": "0x...", ... }
  }
}

GET `/api/tokens/search`

Deprecated: Use GET /api/tokens instead.

Search tokens by query or FIDs. Authentication: Public Query Parameters

Parameter	Type	Required	Default	Description
`q`	`string`	No	—	Search query.
`fids`	`string`	No	—	Comma-separated FIDs.
`cursor`	`string`	No	—	Pagination cursor.

Response: Paginated token list (fixed limit of 5).

{
  "data": [ ... ],
  "total": 10,
  "cursor": "eyJ..."
}

GET `/api/tokens/estimate-rewards-by-pool-address`

Deprecated: This endpoint is deprecated. Use the clanker-sdk availableRewards() method instead.

Estimate uncollected rewards for a pool. Authentication: Public

Introduction

General

Droids

API Reference

SDK Reference

References

GET `/api/tokens`

GET `/api/tokens/fetch-deployed-by-fid`

GET `/api/tokens/fetch-deployed-by-address`

GET `/api/tokens/fetch-by-pool-address`

POST `/api/tokens/fetch-by-pool-addresses`

GET `/api/tokens/search`

GET `/api/tokens/estimate-rewards-by-pool-address`

​GET /api/tokens

​GET /api/tokens/trending

​GET /api/tokens/fetch-deployed-by-fid

​GET /api/tokens/fetch-deployed-by-address

​GET /api/tokens/fetch-by-pool-address

​POST /api/tokens/fetch-by-pool-addresses

​GET /api/tokens/search

​GET /api/tokens/estimate-rewards-by-pool-address

GET `/api/tokens`

GET `/api/tokens/trending`

GET `/api/tokens/fetch-deployed-by-fid`

GET `/api/tokens/fetch-deployed-by-address`

GET `/api/tokens/fetch-by-pool-address`

POST `/api/tokens/fetch-by-pool-addresses`

GET `/api/tokens/search`

GET `/api/tokens/estimate-rewards-by-pool-address`