Get Tokens Deployed by Address

Retrieve all tokens deployed by a specific Ethereum address.

GET https://www.clanker.world/api/tokens/fetch-deployed-by-address

Headers:

x-api-key: your_api_key

Query Parameters:

Parameter	Type	Description
address	string	Ethereum address to fetch tokens for
page	integer	Page number for pagination

Example Request:

curl -X GET \
'https://www.clanker.world/api/tokens/fetch-deployed-by-address?address=user_eth_address&page=1' \
  -H 'x-api-key: your_api_key'

Response Format

Example Response:

{
  "data": [
    {
      "id": 94,
      "created_at": "2024-12-24T12:09:09.678778+00:00",
      "tx_hash": "0x8fb2e2a15e1ca88be604d9fbbcb16f9afbd8e8c1f19bab96b7127aa17b29d6e5",
      "requestor_fid": 211845,
      "contract_address": "0x0B0190Ff8aBef267906Cd5AaC21379B73b57a949",
      "name": "test",
      "symbol": "tt",
      "img_url": null,
      "pool_address": "0x5D95E4c674d4d7169874D2d549CC26f727EB388f",
      "cast_hash": "0x84ecb88d0a5f62158a2155e9af31445723cca52b",
      "type": "clanker_v2",
      "pair": "WETH"
    }
  ],
  "hasMore": true,
  "total": 55
}

Response Fields

Top-Level Fields:

Field	Type	Description
data	array	Array of token objects
hasMore	boolean	Indicates if there are more pages of results
total	integer	Total number of tokens deployed by the address

Token Object Fields:

Field	Type	Description
id	integer	Unique identifier for the token
created_at	string	ISO 8601 timestamp of token creation
tx_hash	string	Transaction hash of the deployment
requestor_fid	integer	Farcaster ID of the requestor
contract_address	string	Deployed token contract address
name	string	Token name
symbol	string	Token symbol
img_url	string|null	URL of token image, null if not provided
pool_address	string	Address of the token's liquidity pool
cast_hash	string	Associated Farcaster cast hash
type	string	Token factory type (e.g., "clanker_v2")
pair	string	Quote token that is paired with the deployed token

Best Practices

1. Cache responses when appropriate to minimize calls

2. Handle null values for optional fields like img_url

3. Validate Ethereum addresses before making requests