Get Tokens by Creator

Search for clanker tokens deployed by a Farcaster username or wallet address.

Endpoint

GET https://clanker.world/api/search-creator

Query Parameters

Parameter	Type	Required	Default	Description
q	string	Yes	-	Search query: Farcaster username (e.g., dish) or wallet address (0x...)
limit	integer	No	20	Number of results per page (1-50)
offset	integer	No	0	Pagination offset for loading more results
sort	string	No	desc	Sort order by deployment date: asc (oldest first) or desc (newest first)
trustedOnly	boolean	No	false	When true, only returns verified/trusted tokens

Response

Success Response (200 OK)

{
  "tokens": [
    {
      "contract_address": "0x...",
      "name": "Token Name",
      "symbol": "TKN",
      "img_url": "https://...",
      "chain_id": 8453,
      "deployed_at": "2024-01-15T10:30:00.000Z",
      "created_at": "2024-01-15T10:30:00.000Z",
      "msg_sender": "0x...",
      "social_context": {
        "platform": "farcaster",
        "id": "12345"
      },
      "related": {
        "market": {
          "marketCap": 50000,
          "price": 0.0001
        }
      },
      "trustStatus": {
        "isTrustedDeployer": false,
        "isTrustedClanker": false,
        "fidMatchesDeployer": true,
        "verifiedAddresses": ["0x..."]
      }
    }
  ],
  "user": {
    "fid": 12345,
    "username": "alice",
    "displayName": "Alice",
    "pfpUrl": "https://...",
    "verifiedAddresses": ["0x..."]
  },
  "searchedAddress": "0x...",
  "total": 42,
  "hasMore": true
}

Response Fields

Field	Type	Description
tokens	array	Array of token objects with trust status
user	object	Farcaster user info if found (may be undefined)
searchedAddress	string	The wallet address used for searching (may be undefined)
total	integer	Total number of tokens matching the query (after filtering)
hasMore	boolean	Whether more results are available for pagination

Trust Status

Each token includes a trustStatus object indicating verification level:

Field	Type	Description
isTrustedDeployer	boolean	Token was deployed by a known trusted deployer address
isTrustedClanker	boolean	Token contract is on the allowlist
fidMatchesDeployer	boolean	Creator's verified Farcaster address matches the deployer wallet
verifiedAddresses	array	The token creator's verified Farcaster addresses

Trust Levels (in order of priority):

1. Allowlisted - Token is on the trusted clanker allowlist

2. Trusted Deployer - Deployed by an official clanker deployer contract

3. FID Verified - Creator's Farcaster verified address matches the deployer

4. Unverified - None of the above (exercise caution)

Error Responses

400 Bad Request

{
  "error": "Query parameter \"q\" is required"
}

500 Internal Server Error

{
  "error": "Failed to search"
}

Examples

Search by Farcaster Username

curl "https://clanker.world/api/search-creator?q=dish"

Search by Wallet Address

curl "https://clanker.world/api/search-creator?q=0x1234567890abcdef1234567890abcdef12345678"

Paginated Request

# First page
curl "https://clanker.world/api/search-creator?q=alice&limit=20&offset=0"

# Second page
curl "https://clanker.world/api/search-creator?q=alice&limit=20&offset=20"

Filter Trusted Only, Sorted by Oldest

curl "https://clanker.world/api/search-creator?q=alice&trustedOnly=true&sort=asc"

Notes

• The API searches tokens by:

  • Farcaster FID (from username lookup)

  • Deployer address (msg_sender)

  • Admin address

• Results are deduplicated by contract address

• Invalid limit/offset values are automatically corrected to safe defaults

• Maximum 50 results per request

• Results are optimized for creators with up to ~1000 tokens

Rate Limits

Standard API rate limits apply. Contact support for higher limits.