> For the complete documentation index, see [llms.txt](https://docs.drops.bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.drops.bot/api-reference/endpoints/address-airdrops-full.md). # 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 GET `/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": [] } } ```