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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/sportscardinvestor/`
**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 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/credits/sportscardinvestor/get-card \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/sportscardinvestor/get-trending \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/sportscardinvestor/search-cards \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","sport":"<string>","year":"<string>"}'
```

## Next steps

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