> For the complete documentation index, see [llms.txt](https://clanker.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://clanker.gitbook.io/documentation/api-reference/public.md).

# Public API

These endpoints are publicly accessible and require no authentication.

**Base URL:** `https://www.clanker.world`

## Endpoints

### Tokens

* `GET /api/tokens` — Search and list Clanker tokens with filters, sorting, and cursor-based pagination.
* `GET /api/tokens/trending` — Returns trending token pools from CoinGecko.
* `GET /api/tokens/fetch-deployed-by-fid` — Returns tokens deployed by a Farcaster FID.
* `GET /api/tokens/fetch-deployed-by-address` — Returns tokens deployed by a wallet address.
* `GET /api/tokens/fetch-by-pool-address` — Returns token data for a single pool address.
* `POST /api/tokens/fetch-by-pool-addresses` — Returns token data for multiple pool addresses (max 100).
* `GET /api/tokens/search` — Search tokens by query or FIDs. *(deprecated)*
* `GET /api/tokens/estimate-rewards-by-pool-address` — Estimate uncollected rewards for a pool. *(deprecated)*

### Users

* `GET /api/get-user-by-fid` — Returns a Farcaster user profile by FID.
* `GET /api/get-user-by-address` — Returns a Farcaster user profile by verified wallet address.
* `GET /api/get-user-by-name` — Returns a Farcaster user profile by username.
* `GET /api/get-multiple-users-by-fid` — Returns multiple Farcaster user profiles by FIDs.

### Creators

* `GET /api/search-creator` — Search creators by Farcaster username, Twitter handle, or wallet address. Returns matching tokens with trust status.
* `GET /api/creator-earnings/{tokenAddress}` — Returns creator fee earnings for a token.
* `GET /api/creator/{address}` — Returns a creator profile with stats.
* `GET /api/get-clankers-deployed/by-following` — Returns tokens deployed by accounts that a given FID follows.

### Presales

* `GET /api/presales` — Search and list presales with filters and pagination.
* `GET /api/presales/allowlists` — Returns the allowlist for a presale.
* `POST /api/presales/allowlists` — Saves a presale allowlist Merkle tree.
* `GET /api/presales/allowlists/proof` — Returns a Merkle proof for a buyer in a presale allowlist.
* `GET /api/presales/refresh` — Enqueues a presale for re-indexing by transaction hash.

### Airdrops

* `GET /api/airdrops` — Returns airdrop claim amounts for a claimer on a given token.
* `POST /api/airdrops` — Saves an airdrop Merkle tree for a token.
* `GET /api/airdrops/allocations` — Returns all allocations for an airdrop.
* `GET /api/airdrops/claim` — Returns Merkle proofs needed to claim airdrop allocations.

### Market Data

* `GET /api/marketcap` — Returns the market cap for a token calculated from its Uniswap V3 pool.
* `GET /api/quotes` — Returns a swap quote via the spanDEX aggregator.
* `GET /api/metadata/factories` — Returns Clanker factory contract addresses and event selectors.

### Legion

* `GET /api/droid/leaderboard` — Ranked droid leaderboard rows for a given interval. Public projection covers token, runs, actions, cast metrics, creator, and last-active fields. The composite `score` object (composite, components, washConfidence, washFlags) is admin-only and omitted from non-admin responses.

### Fees

* `GET /api/get-estimated-uncollected-fees/{address}` — Estimate uncollected fees for a position. *(deprecated)*

### Deployment

* `POST /api/tokens/index-by-address` — Index a token by contract address. Looks up the deployment transaction on-chain. Base chain only.