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

> Track NFT market trends and collection performance with access to global stats, collection rankings, sales history, and rarity data across multiple blockchains. Search collections, monitor top sales, and analyze blockchain performance metrics to stay informed on the NFT market.

**Category:** Web3 & Onchain | **Website:** [cryptoslam.io/](https://cryptoslam.io/) | **Docs:** [parse.bot/marketplace/484a8888-73b8-4891-b037-ac8f635036b1/cryptoslam-io-api](https://parse.bot/marketplace/484a8888-73b8-4891-b037-ac8f635036b1/cryptoslam-io-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/cryptoslam/`
**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 blockchain rankings

Returns rankings of all blockchains by NFT sales volume, including detailed volume, wash sale statistics, buyer/seller counts, and transaction counts for each blockchain.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `period` | string | No | Time period filter. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/cryptoslam/get-blockchain-rankings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"period":"<string>"}'
```

### Get blockchain stats

Returns NFT market statistics for a specific blockchain, including sales volume in USD, unique buyers, unique sellers, transaction count, and wash sale data. The chain is matched case-insensitively against the blockchain rankings list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `chain` | string | Yes | Blockchain name (case-insensitive match). Confirmed working values include: Ethereum, BNB, Polygon, Solana, Cardano, Avalanche, Bitcoin, Arbitrum, Flow, ImmutableX. |
| `period` | string | No | Time period filter. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/cryptoslam/get-blockchain-stats \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"chain":"<string>","period":"<string>"}'
```

### Get collection details

Returns detailed header statistics for a specific NFT collection by slug, including sales volume, transaction count, total owners, average hold time, buyers, and sellers. Each stat includes a time-series dataSeries array for charting.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `period` | string | No | Time period filter. |
| `slug` | string | Yes | Collection slug identifier (e.g. 'cryptopunks'). Obtainable from search_collections results (contractName field). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/cryptoslam/get-collection-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"period":"<string>","slug":"<string>"}'
```

### Get collection historical volume

Returns historical sales volume chart data for a specific NFT collection, grouped daily or monthly. Each record includes date, sales in USD, unique buyers, sellers, total transactions, and average price. Includes full history from collection inception.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `grouping` | string | No | Grouping type for the time series. |
| `slug` | string | Yes | Collection slug identifier (e.g. 'cryptopunks'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/cryptoslam/get-collection-historical-volume \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"grouping":"<string>","slug":"<string>"}'
```

### Get collection rankings

Returns ranked list of NFT collections sorted by sales volume. Each entry includes collection name, volume in USD, buyer/seller counts, transaction counts, and platform info. Supports pagination via offset and limit.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results to return. |
| `offset` | integer | No | Offset for pagination. |
| `period` | string | No | Time period filter. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/cryptoslam/get-collection-rankings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","period":"<string>"}'
```

### Get collection rarity

Returns rarity scores and rankings for individual NFTs within a collection, sorted by rarity rank ascending. Each token includes its rarity rank, odds score, owner address, last sale price, and mint/burn timestamps.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results to return. |
| `slug` | string | Yes | Collection slug identifier (e.g. 'cryptopunks'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/cryptoslam/get-collection-rarity \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","slug":"<string>"}'
```

### Get collection sales history

Returns historical sales transactions for a specific NFT collection, ordered by most recent. Each sale includes buyer/seller addresses, price in USD and native token, token info, rarity rank, and wash sale flag.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results to return. |
| `slug` | string | Yes | Collection slug identifier (e.g. 'cryptopunks'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/cryptoslam/get-collection-sales-history \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","slug":"<string>"}'
```

### Get collection top sales

Returns the top individual NFT sales within a specific collection, ranked by price. Each sale includes token details, price, buyer/seller addresses, rarity rank, and timestamp. Supports pagination via offset and limit.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results to return. |
| `offset` | integer | No | Offset for pagination. |
| `period` | string | No | Time period filter. |
| `slug` | string | Yes | Collection slug identifier (e.g. 'cryptopunks'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/cryptoslam/get-collection-top-sales \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","period":"<string>","slug":"<string>"}'
```

### Get global market stats

Returns global NFT market statistics including total sales volume, number of transactions, buyers, sellers, and market cap. The period parameter controls the time window for change-percentage calculations.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `period` | string | No | Time period filter for change percentages. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/cryptoslam/get-global-market-stats \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"period":"<string>"}'
```

### Get top nft sales

Returns a ranked list of the top individual NFT sales across all collections and blockchains. Each sale includes token details, price in USD and native token, marketplace info, and timestamp. Supports pagination via offset and limit.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results to return. |
| `offset` | integer | No | Offset for pagination. |
| `period` | string | No | Time period filter. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/cryptoslam/get-top-nft-sales \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","period":"<string>"}'
```

### Search collections

Searches for NFT collections by name keyword. Returns matching collections with their slugs (contractName field, used as the slug parameter in collection endpoints), display names, and icon URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to match against collection names. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/cryptoslam/search-collections \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

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