# 130 Point — 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 for sold trading cards across eBay, Goldin, Heritage Auctions, Pristine Auction, MySlabs, and Fanatics Collect to find historical prices, sale dates, and marketplace information all in one place. Get comprehensive sales data to research card values and track market trends across multiple platforms instantly.

**Category:** Marketplaces | **Website:** [130point.com/cards/](https://130point.com/cards/) | **Docs:** [parse.bot/marketplace/e3b4a6b9-14b1-42bf-ae20-efd1b5728bdc/130point-com-api](https://parse.bot/marketplace/e3b4a6b9-14b1-42bf-ae20-efd1b5728bdc/130point-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-130point-com-api-e3b4a6b9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_price_history

Get historical auction price statistics and individual sale records for a card query. Computes avg, high, low, median prices, number of sales, and price trend from up to 200 most recent sales. The trend compares the average price of recent sales vs older sales and reports 'up', 'down', or 'stable'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `grade` | string | No | Grade filter (e.g. 'PSA 9', '10', 'BGS 9.5'). Appended to search query to narrow results. |
| `query` | string | Yes | Search query for card name/description (e.g. '1986 Fleer Michael Jordan'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-130point-com-api-e3b4a6b9/get_price_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"grade":"<string>","query":"<string>"}'
```

### search_auction_results

Search auction house sale results for sports cards. Combines query with optional grade, grading company, and sport filters. Returns up to 200 results from the backend, paginated client-side at 25 per page. Grade and grading company are extracted from listing titles when present (e.g. 'PSA 9', 'BGS 9.5'). Results include sales from eBay, Goldin, Heritage Auctions, PWCC, Pristine Auction, and MySlabs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `grade` | string | No | Card grade to filter by (e.g. '9', '10', '8.5'). Appended to search query. |
| `grading_company` | string | No | Grading company to filter by (e.g. 'PSA', 'BGS', 'SGC', 'CGC'). Appended to search query. |
| `page` | integer | No | Page number for client-side pagination (25 results per page, max 8 pages from 200 backend results). |
| `query` | string | Yes | Search query for card name/description (e.g. '1986 Fleer Michael Jordan', 'Pokemon Charizard'). |
| `sport` | string | No | Sport to filter by (e.g. 'basketball', 'baseball', 'football'). Appended to search query. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-130point-com-api-e3b4a6b9/search_auction_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"grade":"<string>","grading_company":"<string>","page":"<integer>","query":"<string>","sport":"<string>"}'
```

### search_sold_items

Full-text search over sold trading card items across multiple marketplaces. Returns card sale records with price, date, sale type, and listing URL. Results are sorted by the chosen order and optionally filtered to a single marketplace. Paginates as a single page up to the requested limit.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of items to return (max 1000). |
| `marketplace` | string | No | Filter by marketplace. |
| `query` | string | Yes | Search query for card name/description (e.g., 'Michael Jordan', 'Pokemon Charizard PSA 10'). |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-130point-com-api-e3b4a6b9/search_sold_items \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","marketplace":"<string>","query":"<string>","sort":"<string>"}'
```
