# Address Airdrops (full)

**This endpoint returns all revealed airdrop details.**\
If you want to use this data within your own app, note that since airdrop information is the core value of Drops, **this is a paid endpoint.**

Pricing ranges from **$0.025–$0.10 per credit**, depending on the package size. **Minimum starter package is $500**, which includes **5,000 address check credits**.

**Credit System:**

* **First check of any address costs 1 credit.** That credit covers unlimited re-checks of the same address for the rest of the month
* **Repeated checks** of the same address within the same month **are** **free**
* Usage resets at the start of each calendar month (midnight UTC)
* **Unused credits roll over** automatically to the next month

Contact [Drops on X](https://x.com/DropsBotHQ) for details. Include your expected monthly request amount in the message.

{% hint style="info" %}
There are also **free API endpoints:** [**Address Airdrops (simple)**](/api-reference/endpoints/address-airdrops-simple.md) and [**Address Airdrops Value**](/api-reference/endpoints/address-airdrops-value.md)**,** which return the total airdrop value **without the** **claiming details.**\
For full claiming details, users should be redirected to Drops to view the information.
{% endhint %}

### Endpoints

#### Get Address Airdrops with full details

<mark style="color:$primary;">GET</mark>  `/shared/v1/full/airdrops/:network/:address`

Get the eligible airdrops for a specific address.

**Headers**

| Header      | Type   | Required | Description                     |
| ----------- | ------ | -------- | ------------------------------- |
| `x-api-key` | string | ✅        | Your API key for authentication |

**Path Parameters**

| Parameter | Type   | Required | Description                                                                  |
| --------- | ------ | -------- | ---------------------------------------------------------------------------- |
| `network` | string | ✅        | Network to query                                                             |
| `address` | string | ✅        | The wallet address to check (must be a valid address with the network param) |

**Example Requests**

**cURL - Ethereum Address**

```bash
curl -X GET "https://api.drops.bot/shared/v1/full/airdrops/evm/0xBADA550000000000000000000000000000000001" \
  -H "x-api-key: YOUR_API_KEY"
```

The following networks are supported for address airdrop queries:

| Network ID | Name                                                         |
| ---------- | ------------------------------------------------------------ |
| `evm`      | All EVM and L2 chains                                        |
| `solana`   | Solana                                                       |
| `move`     | Sui, Aptos, and all other Move Networks                      |
| `cosmos`   | Cosmos and all subnets (address must start with \`cosmos1\`) |
| `bitcoin`  | Bitcoin                                                      |
| `starknet` | Starknet                                                     |

### Response

#### 200 - Successful Response

```typescript
{
  "success": true,
  "data": {
    "eligibleAirdrops": FullAddressAirdropData[],
    "claimedAirdrops": FullAddressAirdropData[],
    "errors": EligibilityCheckErrors[]
  }
}
```

#### FullAddressAirdropData

| Field                  | Type             | Description                                                                                                                                                                         |
| ---------------------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `airdropId`            | `string`         | Unique identifier of the airdrop                                                                                                                                                    |
| `airdropName`          | `string`         | Name of the airdrop                                                                                                                                                                 |
| `usdValue`             | `number`         | Fiat equivalent value of the claim                                                                                                                                                  |
| `imgUrl`               | `string`         | URL of the airdrop image/logo                                                                                                                                                       |
| `note`                 | `string \| null` | Extra notes if available (otherwise `null`)                                                                                                                                         |
| `tokenSymbol`          | `string`         | Symbol of the airdropped token                                                                                                                                                      |
| `claimFrom`            | `string \| null` | Date/time when claiming opens (UTC). ISO 8601 string                                                                                                                                |
| `claimUntil`           | `string \| null` | Date/time when claiming closes (UTC).  ISO 8601 string                                                                                                                              |
| `directlySent`         | `boolean`        | Whether the tokens are sent automatically without user claim                                                                                                                        |
| `claimUrl`             | `string`         | Official URL where eligible users can claim the airdrop                                                                                                                             |
| `eligibleAmount`       | `number`         | Amount of tokens the address is eligible to claim                                                                                                                                   |
| `isUnknownUsdValue`    | `boolean`        | Whether the fiat value of the airdrop is known (false = value is known)                                                                                                             |
| `addressUrl`           | `string`         | URL to the airdrop details page for the given address on Drops                                                                                                                      |
| `isClaimStatusChecked` | `boolean`        | Indicates whether the claim status of the airdrop was successfully verified. If `false`, the claim status couldn’t be checked (for example, due to an unavailable contract or API). |

#### EligibilityCheckErrors

When one or more airdrops eligibility check fails, they appear in the `errors` array.\
These are usually **temporary issues** and can be retried later.

| Field         | Type   | Description                                          |
| ------------- | ------ | ---------------------------------------------------- |
| `airdropId`   | string | Unique identifier of the airdrop that failed to load |
| `address`     | string | Address for which the airdrop check failed           |
| `reason`      | string | Short message describing the error or failed check   |
| `airdropName` | string | Human-readable name of the airdrop                   |
| `airdropUrl`  | string | Link to the airdrop details page on Drops            |

### Testing Addresses

The Full Airdrops API provides special testing addresses that return predictable mock data without consuming credits. These addresses are useful for integration testing, debugging, and development.

#### Available Testing Addresses

All testing addresses use the EVM network and start with the prefix `0xBADA55`.

**1. Two Eligible Airdrops (With Fiat Value)**

Address: `0xBADA550000000000000000000000000000000001` Network: evm

**Returns:**

* 2 eligible airdrops, 1 claimed airdrop
* Airdrop 1: 1,000 TEST1 tokens ($100 USD)
* Airdrop 2: 2,500 TEST2 tokens ($250 USD)
* Airdrop 3: 2,500 TEST3 tokens ($250 USD) ***claimed***

**2. Two Eligible Airdrops (No Fiat Value)**

Address: `0xBADA550000000000000000000000000000000002` Network: evm

**Returns:**

* 2 eligible airdrops
* Airdrop 3: 5,000 TEST3 tokens ($0 USD)
* Airdrop 4: 10,000 TEST4 tokens ($0 USD)

**3. Failed Eligibility Check (One Error)**

Address: `0xBADA550000000000000000000000000000000003` Network: evm

**Returns:**

* 0 eligible airdrops
* 1 error in the `errors` array
* Error reason: "Test error: Unable to verify eligibility"

**Use case:** Testing error handling and display.

**4. No Airdrops Found**

Address: `0xBADA550000000000000000000000000000000004` Network: evm

**Returns:**

* 0 eligible airdrops
* 0 errors
* Empty response

**Use case:** Testing addresses with no airdrop eligibility.

#### Example Request

```bash
curl -X GET \
  'https://www.drops.bot/api/shared/v1/full/ai
rdrops/evm/0xBADA55000000000000000000000000000
0000001' \
  -H 'x-api-key: YOUR_API_KEY'
```

#### Example Response

```json
{
  "success": true,
  "data": {
    "eligibleAirdrops": [
      {
        "airdropId": "test-airdrop-1",
        "airdropName": "Test Airdrop 1",
        "usdValue": 100,
        "eligibleAmount": 1000,
        "tokenSymbol": "TEST1",
        "isUnknownUsdValue": false,
        "imgUrl": "https://www.drops.bot/images/airdrops/mystery-drop-600px.png",
        "claimFrom": "2025-01-01T00:00:00.000Z",
        "claimUntil": "2045-12-31T23:59:59.999Z",
        "claimUrl": "https://test1.example.com/claim",
        "directlySent": false,
        "note": "Test airdrop with fiat value",
        "isClaimStatusChecked": true,
        "addressUrl": "https://www.drops.bot/address/0xBADA550000000000000000000000000000000001/EVM"
      },
      {
        "airdropId": "test-airdrop-2",
        "airdropName": "Test Airdrop 2",
        "usdValue": 250,
        "eligibleAmount": 2500,
        "tokenSymbol": "TEST2",
        "isUnknownUsdValue": false,
        "imgUrl": "https://www.drops.bot/images/airdrops/mystery-drop-600px.png",
        "claimFrom": "2025-01-01T00:00:00.000Z",
        "claimUntil": "2045-12-31T23:59:59.999Z",
        "claimUrl": "https://test2.example.com/claim",
        "directlySent": false,
        "note": "Another test airdrop with fiat value",
        "isClaimStatusChecked": true,
        "addressUrl": "https://www.drops.bot/address/0xBADA550000000000000000000000000000000001/EVM"
      }
    ],
    "errors": []
  }
}

```


---

# 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://docs.drops.bot/api-reference/endpoints/address-airdrops-full.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.