# Icodrops — 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.

> Access structured data on active, upcoming, and ended Initial Coin Offerings listed on icodrops.com. Retrieve project metadata including ticker, round type, raised amounts, investors, and ecosystems. Look up individual projects by slug or search across all listings by keyword.

**Category:** Web3 & Onchain | **Website:** [icodrops.com/](https://icodrops.com/) | **Docs:** [parse.bot/marketplace/256c5db0-9de9-4f01-b002-a71b507fef55/icodrops-com-api](https://parse.bot/marketplace/256c5db0-9de9-4f01-b002-a71b507fef55/icodrops-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-icodrops-com-api-256c5db0/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### Get active icos

Get a paginated list of active ICO projects with metadata including name, ticker, round type, raised amount, investors, and ecosystems. Active ICOs are currently running token sales or have ongoing fundraising events.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of projects per page. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-icodrops-com-api-256c5db0/get_active_icos \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### Get all project urls

Get a paginated list of project URLs in a specific ICO category. Useful for bulk discovery of project slugs across active, upcoming, or ended ICO categories.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category path. Accepted values: active-ico, upcoming-ico, ended-ico. |
| `limit` | integer | No | Number of URLs per page. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-icodrops-com-api-256c5db0/get_all_project_urls \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","limit":"<integer>","page":"<integer>"}'
```

### Get ended icos

Get a paginated list of ended ICO projects with metadata including name, ticker, round type, raised amount, investors, and ecosystems. Ended ICOs have completed their token sales.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of projects per page. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-icodrops-com-api-256c5db0/get_ended_icos \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### Get project details

Get full details for a specific project by its slug, including links, summary, description, and funding rounds. The slug is the path segment from the project's icodrops.com URL. Returns null for ticker or description when not available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Project slug as it appears in the icodrops.com URL path (e.g. 'zama', 'ethereum'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-icodrops-com-api-256c5db0/get_project_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get upcoming icos

Get a paginated list of upcoming ICO projects with metadata including name, ticker, round type, raised amount, investors, and ecosystems. Upcoming ICOs have announced token sales that have not yet started.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of projects per page. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-icodrops-com-api-256c5db0/get_upcoming_icos \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### Search projects

Search for projects by keyword. Returns matching projects and venture capital entities with name, URL, category, and raised amount. Searches across all ICO categories and VC entities.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'ethereum', 'privacy'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-icodrops-com-api-256c5db0/search_projects \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```