# Tcgfish — 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.

> Track Pokemon TCG market trends and indices to monitor card value movements, then search for specific card prices to find the best deals on TCGFish.net. Get real-time market data including detailed index information to make informed decisions about buying and selling collectible cards.

**Category:** Finance & Markets | **Website:** [www.tcgfish.net/market/indices](https://www.tcgfish.net/market/indices) | **Docs:** [parse.bot/marketplace/896399d8-0de6-434c-a6a9-735130e49d57/tcgfish-net-api](https://parse.bot/marketplace/896399d8-0de6-434c-a6a9-735130e49d57/tcgfish-net-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/tcgfish/`
**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 index detail

Get detailed data for a specific market index including current level, momentum metrics (7d, 30d, 90d percentage changes), and historical daily data points covering the last 12 months. The historical_points array contains one entry per day with date and value fields.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | No | Index identifier. Accepts exactly one of: graded, sealed, top-100, top-250. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/tcgfish/get-index-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### List indices

List all Pokemon TCG market indices with their current level, 7-day and 30-day performance changes. Returns data for the Graded Index (PSA 10), Sealed Index, Top 100 Most Valuable, and Top 250 Index. Always returns all four indices in a single response with no pagination.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/tcgfish/list-indices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search cards

Search for Pokemon cards by name or keyword. Returns paginated results (24 per page) sorted by market value descending. Each card includes identifiers, metadata (set info), image URL, and current market prices for ungraded and PSA 10 conditions. Fields rarity, artist, edition, and foil_type are no longer populated in search results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. Each page returns up to 24 results. |
| `query` | string | Yes | Search query for Pokemon card name or keyword (e.g. charizard, pikachu, base set). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/tcgfish/search-cards \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<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.