# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/opensea/`
**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 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/credits/opensea/get-collection \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/opensea/get-collection-activity \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/opensea/get-collection-items \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/opensea/search \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"chains":"<string>","limit":"<integer>","query":"<string>"}'
```

## Next steps

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