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

> 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.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.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.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.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.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.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.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>"}'
```