---
description: >-
  Get estimated uncollected fees (in base and quote tokens) for a specific token
  contract.
---

# Get Uncollected Fees

**V3.1:**

```bash
GET https://www.clanker.world/api/get-estimated-uncollected-fees/[contract_address]
```

{% hint style="warning" %}
**For v4 clankers**: you must include the reward recipient address you are getting the uncollected fee amounts for, as multiple reward recipients may be assigned for the token.&#x20;
{% endhint %}

**V4:**

```
GET https://www.clanker.world/api/get-estimated-uncollected-fees/[contract_address]?rewardRecipientAddress=[reward_recipient_address]
```

**Headers:**

```
x-api-key: your_api_key
```

**Query Parameters:**

<table><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td><code>contract_address</code></td><td>string</td><td>The token contract address to query</td></tr><tr><td><pre><code>rewardRecipientAddress
</code></pre></td><td>string</td><td>The reward recipient address   (required for v4's)</td></tr></tbody></table>

**Example Request (v3.1):**

```bash
curl -X GET \
  'https://www.clanker.world/api/get-estimated-uncollected-fees/[token_address]' \
  -H 'x-api-key: your_api_key'
```

**Example Request (v4):**

```
curl -X GET 'http://localhost:3000/api/get-estimated-uncollected-fees/[token_address]?rewardRecipientAddress=[reward_recipient_address]' \
-H 'x-api-key: your_api_key' | jq
```

### Response Format

**Example Response:**

```json
{
  "lockerAddress": "0x618A9840691334eE8d24445a4AdA4284Bf42417D",
  "lpNftId": 1605020,
  "token1UncollectedRewards": "25549999999999",
  "token0UncollectedRewards": "256188371342895862809729",
  "token0": {
    "chainId": 8453,
    "address": "0x054E4121a946da752a5Cab371BE52B2E6A897ba8",
    "symbol": "MTK",
    "decimals": 18,
    "name": "My Token"
  },
  "token1": {
    "chainId": 8453,
    "address": "0x4200000000000000000000000000000000000006",
    "symbol": "WETH",
    "decimals": 18,
    "name": "Wrapped Ether"
  }
}
```

#### Response Fields

**Top-Level Fields:**

| Field                      | Type    | Description                                      |
| -------------------------- | ------- | ------------------------------------------------ |
| `lockerAddress`            | string  | Address of the fee locker contract               |
| `lpNftId`                  | integer | Unique identifier for the liquidity position NFT |
| `token0UncollectedRewards` | string  | Uncollected rewards for token0 (in base units)   |
| `token1UncollectedRewards` | string  | Uncollected rewards for token1 (in base units)   |
| `token0`                   | object  | Details of the first token in the pair           |
| `token1`                   | object  | Details of the second token in the pair          |

**Token Object Fields:**

| Field      | Type    | Description                            |
| ---------- | ------- | -------------------------------------- |
| `chainId`  | integer | Chain ID where the token is deployed   |
| `address`  | string  | Token contract address                 |
| `symbol`   | string  | Token symbol                           |
| `decimals` | integer | Number of decimal places for the token |
| `name`     | string  | Token name                             |
