---
description: Retrieve all tokens deployed by a specific Ethereum address.
---

# Get Tokens Deployed by Address

```bash
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:**

{% code overflow="wrap" %}
```bash
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'
```
{% endcode %}

### Response Format

**Example Response:**

```json
{
  "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](../references/supported-quote-tokens "mention") 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](../references/supported-quote-tokens "mention")
* `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
