# 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 |
| `cursor`  | string | key 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&cursor=eyJpZCI6IjIwMjUtMTEtMTlUMTM6MzA6NDcifQ==' \
  -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](/documentation/references/supported-quote-tokens.md) 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](/documentation/references/supported-quote-tokens.md)
* `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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://clanker.gitbook.io/documentation/authenticated/get-tokens-deployed-by-address.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.