# Airdrops — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-airdrops-io-api-4729ee05/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-airdrops-io-api-4729ee05/get_airdrop_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-airdrops-io-api-4729ee05/get_airdrop_participation_requirements \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-airdrops-io-api-4729ee05/get_airdrop_token_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-airdrops-io-api-4729ee05/get_airdrops_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-airdrops-io-api-4729ee05/get_crypto_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-airdrops-io-api-4729ee05/get_hot_airdrops \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-airdrops-io-api-4729ee05/get_latest_airdrops \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-airdrops-io-api-4729ee05/get_potential_airdrops \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-airdrops-io-api-4729ee05/get_updated_airdrops \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-airdrops-io-api-4729ee05/search_airdrops \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```