# PriceCharting — 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 collectible pricing data from PriceCharting.com. Search for Pokémon cards, US coins, and other collectibles to retrieve current prices across multiple grades (ungraded, PSA 9, PSA 10, MS62, MS66, and more), browse full set listings, view historical price trends, and explore recent sold listings.

**Category:** Marketplaces | **Website:** [pricecharting.com/](https://pricecharting.com/) | **Docs:** [parse.bot/marketplace/dbe920d4-a96a-4ef2-a2ce-70111d203a1a/pricecharting-com-api](https://parse.bot/marketplace/dbe920d4-a96a-4ef2-a2ce-70111d203a1a/pricecharting-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-pricecharting-com-api-dbe920d4/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_big_movers

Retrieve items with the largest price changes across all categories (games, cards, coins). Returns a list sorted by absolute price change with name, url, console/category, current price, and dollar change amount.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pricecharting-com-api-dbe920d4/get_big_movers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_card_detail

Retrieve full pricing and metadata for a single Pokemon card. Returns prices for multiple grades (ungraded through PSA 10, BGS 10, CGC 10) and card metadata including release date, publisher, and card number. Requires set_slug and card_slug from search results or set browsing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `card_slug` | string | Yes | Card identifier slug from search results or set browsing (e.g. 'charizard-4') |
| `set_slug` | string | Yes | Set identifier slug from search results or set browsing (e.g. 'pokemon-base-set') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pricecharting-com-api-dbe920d4/get_card_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"card_slug":"<string>","set_slug":"<string>"}'
```

### get_card_price_history

Retrieve price history chart data for a card. Returns time series data with timestamps (milliseconds since epoch) and prices in dollars, grouped by condition. Keys include used, cib, new, graded, boxonly, manualonly.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `card_slug` | string | Yes | Card identifier slug (e.g. 'charizard-4') |
| `set_slug` | string | Yes | Set identifier slug (e.g. 'pokemon-base-set') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pricecharting-com-api-dbe920d4/get_card_price_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"card_slug":"<string>","set_slug":"<string>"}'
```

### get_card_sold_listings

Retrieve historical sold listings for a specific card, organized by condition/grade. Returns recent eBay sold prices grouped by categories such as used, cib, new, graded, box-only, manual-only, and individual grade levels.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `card_slug` | string | Yes | Card identifier slug (e.g. 'charizard-4') |
| `set_slug` | string | Yes | Set identifier slug (e.g. 'pokemon-base-set') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pricecharting-com-api-dbe920d4/get_card_sold_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"card_slug":"<string>","set_slug":"<string>"}'
```

### get_coin_detail

Retrieve full pricing and metadata for a specific US coin. Returns prices for multiple grades (ungraded, VF, AU, MS62, MS64, MS66) and coin metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `coin_slug` | string | Yes | Coin slug (e.g. '1921', '1878-cc', '1921-s') |
| `set_slug` | string | Yes | Coin set slug (e.g. 'coins-morgan-dollar') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pricecharting-com-api-dbe920d4/get_coin_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"coin_slug":"<string>","set_slug":"<string>"}'
```

### get_coin_set

Browse all coins in a specific coin set with their prices (ungraded, MS62, MS66). Returns the full set roster.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `set_slug` | string | Yes | Coin set slug (e.g. 'coins-morgan-dollar', 'coins-lincoln-wheat-penny') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pricecharting-com-api-dbe920d4/get_coin_set \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"set_slug":"<string>"}'
```

### get_pokemon_card_set

Browse all cards in a specific Pokemon set with their prices for ungraded, grade 9, and PSA 10 conditions. Returns the full set roster in one page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `set_slug` | string | Yes | Set identifier slug (e.g. 'pokemon-base-set', 'pokemon-scarlet-&-violet-151') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pricecharting-com-api-dbe920d4/get_pokemon_card_set \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"set_slug":"<string>"}'
```

### get_pokemon_card_sets_batch

Batch-fetch multiple Pokemon card sets in a single call. Accepts a JSON array of up to 40 set slugs and returns one result object per slug in request order. Each result contains success=true with set_name and the full cards array (same shape as get_pokemon_card_set), or success=false with an error string if that slug failed. A 0.5-second delay is applied between upstream requests to avoid rate-limiting, so latency scales linearly with the number of slugs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `set_slugs` | array | Yes | JSON array of set slug strings (max 40). Each slug identifies a Pokemon card set (e.g. 'pokemon-base-set'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pricecharting-com-api-dbe920d4/get_pokemon_card_sets_batch \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"set_slugs":"<array>"}'
```

### get_trending_cards

Retrieve currently trending/popular Pokemon card sets and new releases. Returns sets grouped by section (most_popular, new_releases) with name, slug, url, and section label.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pricecharting-com-api-dbe920d4/get_trending_cards \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_coin_sets

List all available US coin sets (e.g. Morgan Silver Dollar, Lincoln Wheat Penny, Mercury Dime) with their slugs and URLs.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pricecharting-com-api-dbe920d4/list_coin_sets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_pokemon_card_sets

List all available Pokemon TCG sets with their slugs and URLs. Returns the complete catalog of sets from PriceCharting's Pokemon cards category.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pricecharting-com-api-dbe920d4/list_pokemon_card_sets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_coins

Search for US coins by year, mint, and/or type. Only returns coin results (filters out non-coin items). Returns matching coins with their prices.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query (e.g. '1921 morgan dollar', 'mercury dime 1942') |

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

### search_pokemon_cards

Full-text search for Pokemon cards by name. Returns a list of matching cards with current prices for ungraded, grade 9, and PSA 10 conditions. The search covers all Pokemon TCG sets. If exactly one result matches, the site may redirect to the card detail page — in that case, a single-item array is returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword for card name, set, or number (e.g. 'charizard', 'pikachu base set') |

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