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": 241400,
      "created_at": "2025-04-15T00:16:39.464442+00:00",
      "tx_hash": "0x581b54f7b59def7483eb0306d924f82910582d3d024f2dd9a2195341eacd43b9",
      "contract_address": "0x6270BCB5398927335AEf599EdD1CC666FcC77797",
      "name": "deployer",
      "symbol": "$deployer",
      "pool_address": "0x213264B1Bc0F39f705687fdaBe97E8b3F8B3455F",
      "cast_hash": "bankr deployment",
      "type": "clanker_v3_1",
      "pair": "WETH",
      "chain_id": 8453,
      "metadata": {
        "auditUrls": [],
        "description": "",
        "socialMediaUrls": []
      },
      "deploy_config": {
        "devBuyAmount": 0,
        "lockupPercentage": 0,
        "vestingUnlockDate": 0
      },
      "social_context": {
        "interface": "Bankr",
        "messageId": "bankr deployment",
        "id": "886870"
        "platform": "Farcaster"
      },
      "requestor_fid": 886870,
      "deployed_at": "2025-04-15T00:16:35",
      "msg_sender": "0x2112b8456AC07c15fA31ddf3Bf713E77716fF3F9",
      "factory_address": "0x2A787b2362021cC3eEa3C24C4748a6cD5B687382",
      "locker_address": "0x33e2Eda238edcF470309b8c6D228986A1204c8f9",
      "warnings": [],
      "pool_config": {
        "pairedToken": "0x4200000000000000000000000000000000000006",
        "tickIfToken0IsNewToken": -230400
      },
      "starting_market_cap": 9.870869513221747
    },
    {
      "id": 241399,
      "created_at": "2025-04-15T00:15:37.032429+00:00",
      "tx_hash": "0x0088ae9400e6cc0de3414bd4b9ad13d68c6822b05a4895fa14a4181cb0ef4b58",
      "contract_address": "0x6B2B40bF4c0c6734fd738f7090e8D694C817e91D",
      "name": "Pokemon",
      "symbol": "PKMON",
      "img_url": "https://pbs.twimg.com/media/GogsV0mWIAA6YnY.jpg",
      "pool_address": "0xf8827866d4bd7a8Ef237a457d5924C87E702Da81",
      "cast_hash": "https://twitter.com/millionbby12/status/1911936222257197369",
      "type": "clanker_v3_1",
      "pair": "WETH",
      "chain_id": 8453,
      "metadata": {
        "auditUrls": [],
        "description": "Deployed using Bankr on X",
        "socialMediaUrls": []
      },
      "deploy_config": "{\"devBuyAmount\":0,\"lockupPercentage\":0,\"vestingUnlockDate\":0}",
      "social_context": "{\"interface\":\"Bankr\",\"messageId\":\"https://twitter.com/millionbby12/status/1911936222257197369\",\"id\":\"886870\"}",
      "requestor_fid": 886870,
      "deployed_at": "2025-04-15T00:15:33",
      "msg_sender": "0x2112b8456AC07c15fA31ddf3Bf713E77716fF3F9",
      "factory_address": "0x2A787b2362021cC3eEa3C24C4748a6cD5B687382",
      "locker_address": "0x33e2Eda238edcF470309b8c6D228986A1204c8f9",
      "warnings": [],
      "pool_config": {
        "pairedToken": "0x4200000000000000000000000000000000000006",
        "tickIfToken0IsNewToken": -230400
      },
      "starting_market_cap": 9.870869513221747
    },
  ],
  "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

Data Object Fields:

Field	Type	Description
id	number	Unique identifier for the token
created_at	string	ISO 8601 timestamp of token creation
tx_hash	string	Transaction hash of the deployment
contract_address	string	Token contract address
requestor_fid	integer	Farcaster ID of the token requestor
name	string	Token name
symbol	string	Token symbol
img_url	string	URL of the token's image
pool_address	string	Address of the token's liquidity pool
cast_hash	string	Associated Farcaster cast hash
type	string | null	Token type identifier
pair	string | null	Trading pair identifier
presale_id	integer | null	ID of associated presale if applicable
chain_id	integer	Blockchain chain ID
metadata	string	Additional token metadata
deploy_config	object	Deployment configuration details: creator buy, creator vault, etc.
social_context	object	Social context of the token creation
deployed_at	string	Timestamp of token deployment
msg_sender	string	Address that sent the deployment transaction
factory_address	string	Address of the Clanker token factory conract
locker_address	string	Address of the Clanker token locker contract
warnings	array	Array of warning flags. See "Warning Flags" section below
starting_market_cap	number	Starting market cap of the pool denominated in the quote token
pool_config	object	Pool configuration details: quote token address and initial tick of the pool

Warning Flags

• UNUSUAL_TICK

  • WETH-denominated tokens with a starting market cap of < 1 ETH (WETH)

  • Non-WETH tokens listed in Supported Quote Tokens with pools that do not match the initial tick listed in that table

• UNUSUAL_PAIR_ADDRESS

  • Tokens paired with a quote token not listed in Supported Quote Tokens

• MISSING_POOL_CONFIG

  • Tokens with incomplete or missing pool configuration info. These are primary legacy tokens that were deployed with a standard configuration

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