# Sportscardinvestor — 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 data from sportscardinvestor.com.

**Category:** Finance & Markets | **Website:** [www.sportscardinvestor.com/cards](https://www.sportscardinvestor.com/cards) | **Docs:** [parse.bot/marketplace/67d8ea49-0b3a-4141-b9a7-a90d687d8e7e/sportscardinvestor-com-api](https://parse.bot/marketplace/67d8ea49-0b3a-4141-b9a7-a90d687d8e7e/sportscardinvestor-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-sportscardinvestor-com-api-67d8ea49/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_card

Get full card details including price trends and grade-level pricing statistics. Accepts a card_id (from search_cards or get_trending, format: {letter}_{numeric_id} e.g. b_37680 or a_37680) or a slug path (from search_cards slug field, e.g. 'michael-jordan-basketball/1995-skybox-premium-electrified-278'). Returns comprehensive card data with all available grading company price breakdowns. Makes 2 HTTP requests: one homepage warmup and one page fetch.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `card_id` | string | Yes | Card identifier. Accepts card_id from search_cards/get_trending (e.g. 'b_37680', 'a_37680'), a full slug path starting with '/cards/', or a slug without the '/cards/' prefix (e.g. 'michael-jordan-basketball/1995-skybox-premium-electrified-278'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sportscardinvestor-com-api-67d8ea49/get_card \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"card_id":"<string>"}'
```

### get_trending

Get trending sports cards ranked by price change percentage over a specified timeframe. Optionally filter by sport. Returns up to 30 cards sorted by highest price movement in the selected timeframe. The trend data comes from the site's popularity and price tracking system.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sport` | string | No | Filter by sport (e.g. 'baseball', 'basketball', 'football', 'hockey', 'soccer', 'pokemon'). Omitted returns trending cards across all sports. |
| `timeframe` | string | No | Timeframe for trend calculation. Determines sort order and the price_change_pct value returned. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sportscardinvestor-com-api-67d8ea49/get_trending \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sport":"<string>","timeframe":"<string>"}'
```

### search_cards

Search for sports cards by player name, set, or keyword. Optionally filter by sport and year. Returns paginated results with basic card identification data. Each result includes a card_id (format: {letter}_{numeric_id}, e.g. b_37680) usable as input to get_card, and a slug path for direct reference. Page size is fixed at 20 results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-indexed). Each page returns up to 20 results. |
| `query` | string | Yes | Search query - player name, card set, or keyword (e.g. 'michael jordan', 'topps chrome'). |
| `sport` | string | No | Sport filter appended to search text (e.g. 'basketball', 'football', 'baseball'). Omitted returns all sports. |
| `year` | string | No | Card year filter prepended to search text (e.g. '1995', '2024'). Omitted returns all years. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sportscardinvestor-com-api-67d8ea49/search_cards \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","sport":"<string>","year":"<string>"}'
```