# 130 Point — 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.

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/130-point/`
**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 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.beta.paywithlocus.com/api/wrapped/credits/130-point/get-price-history \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/130-point/search-auction-results \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/130-point/search-sold-items \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","marketplace":"<string>","query":"<string>","sort":"<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.