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

> Search NFT collections and discover detailed stats, browse individual items, and track collection activity all in one place. Get real-time insights into collection performance and find the NFTs you're looking for on OpenSea.

**Category:** Web3 & Onchain | **Website:** [opensea.io/collection/shacko-36440571/overview](https://opensea.io/collection/shacko-36440571/overview) | **Docs:** [parse.bot/marketplace/b82fc1e3-f209-4171-a4c8-8dbdd4c65816/opensea-io-api](https://parse.bot/marketplace/b82fc1e3-f209-4171-a4c8-8dbdd4c65816/opensea-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-opensea-io-api-b82fc1e3/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_collection

Get detailed collection metadata, stats, floor price, volume, and owner info by collection slug. Returns a single collection with full statistics including daily/weekly/monthly volume, supply counts, and social links. Returns stale_input when the slug does not match any collection.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Collection slug (e.g. boredapeyachtclub) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-opensea-io-api-b82fc1e3/get_collection \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_collection_activity

Get recent activity events (sales, transfers, listings, offers) for a collection. Returns events sorted by most recent first with pricing, buyer/seller info, and item details. Returns a next_cursor for pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Events per page (max 50) |
| `slug` | string | Yes | Collection slug (e.g. boredapeyachtclub) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-opensea-io-api-b82fc1e3/get_collection_activity \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","slug":"<string>"}'
```

### get_collection_items

List NFT items in a collection with pricing, rarity, and owner info. Supports sorting by price, rarity, or date fields. Returns a next_cursor for pagination and up to 50 items per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Items per page (max 50) |
| `slug` | string | Yes | Collection slug (e.g. boredapeyachtclub) |
| `sort_by` | string | No | Sort field |
| `sort_direction` | string | No | Sort direction |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-opensea-io-api-b82fc1e3/get_collection_items \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","slug":"<string>","sort_by":"<string>","sort_direction":"<string>"}'
```

### search

Full-text search across OpenSea collections and currencies. Returns matching results with basic metadata including name, slug, chain, floor price for collections and USD price for currencies. Paginates via limit parameter only (no cursor).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `chains` | string | No | Comma-separated chain filters (e.g. ETHEREUM,BASE,POLYGON) |
| `limit` | integer | No | Max results to return (max 50) |
| `query` | string | Yes | Search keyword |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-opensea-io-api-b82fc1e3/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chains":"<string>","limit":"<integer>","query":"<string>"}'
```