> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clanker.world/llms.txt
> Use this file to discover all available pages before exploring further.

# Airdrops

Endpoints for managing and claiming airdrops.

### GET `/api/airdrops`

Returns airdrop claim amounts for a claimer on a given token.

**Authentication:** Public

**Query Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `tokenAddress` | `address` | Yes | — | Token contract address. |
| `claimerAddress` | `address` | Yes | — | Claimer wallet address. |

**Response:** Array of claimable amounts in wei.

```json theme={null}
{
  "claims": ["1000000000000000000"]
}
```

***

### POST `/api/airdrops`

Saves an airdrop Merkle tree for a token.

**Authentication:** Public

**Body Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `tokenAddress` | `address` | Yes | — | Token contract address. |
| `merkleRoot` | `string` | Yes | — | Hex-encoded Merkle root. |
| `tree` | `object` | Yes | — | MerkleTreeDump object. |
| `enqueue` | `boolean` | No | false | If true, save is enqueued asynchronously. |
| `delaySeconds` | `number` | No | 10 | Delay before enqueued save executes. |

**Response:** Success confirmation.

```json theme={null}
{ "success": true }
```

***

### GET `/api/airdrops/allocations`

Returns all allocations for an airdrop.

**Authentication:** Public

**Query Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `tokenAddress` | `address` | Yes | — | Token contract address. |

**Response:** List of account/amount pairs.

```json theme={null}
{
  "allocations": [
    { "account": "0x...", "amount": "1000000000000000000" }
  ]
}
```

***

### GET `/api/airdrops/claim`

Returns Merkle proofs needed to claim airdrop allocations.

**Authentication:** Public

**Query Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `tokenAddress` | `address` | Yes | — | Token contract address. |
| `claimerAddress` | `address` | Yes | — | Claimer wallet address. |

**Response:** Array of proofs with their allocation entries.

```json theme={null}
{
  "proofs": [
    {
      "proof": ["0x..."],
      "entry": { "account": "0x...", "amount": "1000000000000000000" }
    }
  ]
}
```

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.