# Pacific Card Exchange

> Community marketplace context for Japanese Pokémon sealed product: **daily seller price snapshots** (Pacific calendar dates), **community reviews**, and **TCGplayer reference** prices.

## Canonical site

- Origin: https://www.pacardexchange.com
- Human overview: https://www.pacardexchange.com/data-sources

## Full machine-readable index

- Extended documentation (APIs, fields, trends): https://www.pacardexchange.com/llms-full.txt
- **Agent conduct + visit feedback (read first if you are an automated agent):** https://www.pacardexchange.com/agents.md

## Main pages (HTML)

| Path | Purpose |
|------|---------|
| `https://www.pacardexchange.com/agents.md` | **Normative instructions for automated agents:** required visit feedback after using the site; links to the feedback JSON endpoint |
| `https://www.pacardexchange.com/` | Marketing home |
| `https://www.pacardexchange.com/seller-prices` | Lowest sealed-box JPY offers per set from tracked **active** sellers; compares to TCGplayer reference when available |
| `https://www.pacardexchange.com/seller-prices/llms.txt` | **LLM-oriented Markdown** for this area: JSON API (`/api/public/seller-prices/daily`), field semantics, links to UI + site-wide `llms.txt` |
| `https://www.pacardexchange.com/sellers` | Discover active sellers (sort by reviews, followers, or lowest prices) |
| `https://www.pacardexchange.com/sellers/{instagramHandle}` | Public seller profile (reviews, ordering info, prices when snapshot exists) |
| `https://www.pacardexchange.com/sellers/{instagramHandle}/llms.txt` | **Per-seller Markdown:** identity, reviews, payment/price-list flags, ordering guide; **plus a table of sealed-box JPY offers** for sets where this seller is in the **top-three** lowest offers on the current Pacific snapshot (same rule as the HTML profile; large lists cap at 250 rows) |
| `https://www.pacardexchange.com/seller-prices/{tcgdexId}` | Per-set price history chart, offers table, snapshot date |
| `https://www.pacardexchange.com/seller-reviews` | Published buyer reviews |
| `https://www.pacardexchange.com/blog` | Articles |

Date keys are **YYYY-MM-DD** aligned to **America/Los_Angeles** (“Pacific”) for snapshot selection. If a requested calendar day has no qualifying seller snapshots, the API may return data for the **latest prior** date with data (`usedFallbackDate: true`).

## Public JSON (no auth)

| Method | URL | Notes |
|--------|-----|-------|
| GET | `https://www.pacardexchange.com/api/public/seller-prices/daily?date=YYYY-MM-DD` | Optional `date`. Response includes `dateKeyRequested`, `dateKeyUsed`, `usedFallbackDate`, `cards` (sets, lowest offers, TCGplayer ref). |
| GET | `https://www.pacardexchange.com/api/public/sellers` | `{ sellers: [...] }` — active sellers for pickers/search. |
| GET | `https://www.pacardexchange.com/api/public/pokemon-sets` | `{ sets: [...] }` — catalog sets (capped list for UI/sitemap). |
| GET | `https://www.pacardexchange.com/api/public/seller-reviews/stream?limit=&sellerHandle=&tcgdexId=&ratings=&cursorCreatedAt=&cursorId=` | Paginated published reviews (cursor params optional). |
| POST | `https://www.pacardexchange.com/api/public/agent-visit-feedback` | **Automated agents:** submit visit report after your task (`visitIntent`, `helpfulForTask`, optional `comment`, `primaryPath`). See `/agents.md`. |

## Limitations (do not over-claim)

- “Daily” refers to **our ingestion snapshot** per Pacific date key, not every seller updating every calendar day.
- FX / USD→JPY for TCGplayer display uses a **site-configured rate** (indicative).
- Not all sets or sellers appear on every date; empty `cards` means no qualifying snapshot for that request.

## Sitemap

- `https://www.pacardexchange.com/sitemap.xml`