Get Tokens by Admin

Retrieves a paginated list of tokens where the specified address is the token admin.

Endpoint

GET /api/tokens/fetch-by-admin

Authentication

This endpoint requires API key authentication.

Header	Required	Description
x-api-key	Yes	Your API key for authentication

Query Parameters

Parameter	Type	Required	Default	Description
admin	string	Yes	-	The admin wallet address (0x...) to filter tokens by
limit	number	No	10	Number of tokens to return per page (min: 1, max: 200)
cursor	string	No	-	Pagination cursor for fetching the next page of results
chainId	number	No	-	Filter by specific chain ID (e.g., 8453 for Base)
includeUser	boolean	No	false	Include user/creator data in the response
includeMarket	boolean	No	false	Include market data (price, market cap, etc.) in the response

Response

Success (200 OK)

{
  "data": [
    {
      "id": "uuid",
      "contract_address": "0x...",
      "name": "Token Name",
      "symbol": "TKN",
      "admin": "0x...",
      "chain_id": 8453,
      "deployed_at": "2024-01-01T00:00:00.000Z",
      "pool_address": "0x...",
      "img_url": "https://...",
      ...
    }
  ],
  "total": 42,
  "cursor": "eyJpZCI6Ii4uLiJ9"
}

Field	Type	Description
data	array	Array of token objects
total	number	Total number of tokens matching the query
cursor	string | null	Cursor for the next page, null if no more results

Error Responses

401 Unauthorized

Missing or invalid API key.

{
  "error": "API key is required"
}

400 Bad Request

Missing or invalid admin address.

{
  "error": "Admin address is required"
}

{
  "error": "Invalid admin address"
}

Examples

Basic Request

curl -X GET "https://clanker.world/api/tokens/fetch-by-admin?admin=0x1234567890abcdef1234567890abcdef12345678" \
  -H "x-api-key: your-api-key"

With Pagination

curl -X GET "https://clanker.world/api/tokens/fetch-by-admin?admin=0x1234567890abcdef1234567890abcdef12345678&limit=20&cursor=eyJpZCI6Ii4uLiJ9" \
  -H "x-api-key: your-api-key"

With All Options

curl -X GET "https://clanker.world/api/tokens/fetch-by-admin?admin=0x1234567890abcdef1234567890abcdef12345678&limit=50&chainId=8453&includeUser=true&includeMarket=true" \
  -H "x-api-key: your-api-key"

JavaScript/TypeScript Example

const response = await fetch(
  'https://clanker.world/api/tokens/fetch-by-admin?' + new URLSearchParams({
    admin: '0x1234567890abcdef1234567890abcdef12345678',
    limit: '20',
    includeMarket: 'true',
  }),
  {
    headers: {
      'x-api-key': 'your-api-key',
    },
  }
);

const { data, total, cursor } = await response.json();

Pagination

To paginate through results:

1. Make an initial request without a cursor

2. If the response includes a cursor value, use it in your next request

3. Continue until cursor is null or undefined

let cursor: string | undefined;
const allTokens = [];

do {
  const params = new URLSearchParams({ admin: '0x...', limit: '50' });
  if (cursor) params.set('cursor', cursor);

  const response = await fetch(`/api/tokens/fetch-by-admin?${params}`, {
    headers: { 'x-api-key': 'your-api-key' },
  });
  
  const result = await response.json();
  allTokens.push(...result.data);
  cursor = result.cursor;
} while (cursor);

Rate Limits

Authenticated requests are subject to standard API rate limits. Contact support for rate limit details.