# Airdrops — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Discover and track crypto airdrops in real-time by browsing latest opportunities, searching by category, and viewing detailed project information including participation requirements and token details. Monitor live cryptocurrency prices and stay updated on hot and potential airdrops all in one place.

**Category:** Web3 & Onchain | **Website:** [airdrops.io/](https://airdrops.io/) | **Docs:** [parse.bot/marketplace/4729ee05-5310-436d-b47a-dc64ec8b7565/airdrops-io-api](https://parse.bot/marketplace/4729ee05-5310-436d-b47a-dc64ec8b7565/airdrops-io-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/airdrops/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get airdrop details

Retrieve full details for a specific airdrop by its URL slug. Returns project info including participation steps, requirements, token info, status, social links, and external links. The slug parameter corresponds to the path segment in the airdrop's URL on airdrops.io.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Airdrop URL slug as it appears in the airdrops.io URL path. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/airdrops/get-airdrop-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get airdrop participation requirements

Retrieve eligibility requirements and participation steps for an airdrop by slug. Returns structured arrays of requirement strings and step descriptions from the airdrop's detail page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Airdrop URL slug as it appears in the airdrops.io URL path. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/airdrops/get-airdrop-participation-requirements \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get airdrop token info

Retrieve token-specific information for an airdrop by slug. Returns token details such as ticker, total supply, and blockchain when available. Many airdrops return an empty object when token info is not yet published.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Airdrop URL slug as it appears in the airdrops.io URL path. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/airdrops/get-airdrop-token-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get airdrops by category

Retrieve airdrops filtered by category. Returns a paginated list of airdrop summaries for the given category. Categories map to site sections: 'latest', 'hot', 'speculative', 'potential', 'nft', 'telegram'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category to filter by. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/airdrops/get-airdrops-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>"}'
```

### Get crypto prices

Retrieve live crypto ticker prices displayed on the site. Returns price objects for major cryptocurrencies (BTC, ETH, SOL, HYPE, XMR) with USD price, price direction, and percentage change.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/airdrops/get-crypto-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get hot airdrops

Retrieve hot/popular airdrops sorted by community vote score descending. Returns a paginated list of airdrop summaries ranked by hot_vote_score. Each page contains up to 18 items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/airdrops/get-hot-airdrops \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Get latest airdrops

Retrieve the latest airdrops sorted by publish date or rating. Returns a paginated list of airdrop summaries. Each page contains up to 18 items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/airdrops/get-latest-airdrops \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","sort":"<string>"}'
```

### Get potential airdrops

Retrieve potential retroactive airdrops (speculative). Returns a paginated list of airdrop summaries for projects that may conduct future airdrops. Each page contains up to 18 items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/airdrops/get-potential-airdrops \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Get updated airdrops

Retrieve recently updated airdrops from the homepage. Returns airdrop summaries that have been recently modified, displayed in the site's 'Updated Airdrops' section.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/airdrops/get-updated-airdrops \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search airdrops

Search for airdrops by keyword. Returns matching airdrop summaries from the site's search. Results include both active and expired airdrops that match the query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to match against airdrop names and content. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/airdrops/search-airdrops \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.