TCGplayer recent sales | Soldgraph Docs

GEThttps://api.soldgraph.com/v1/tcgplayer/sales

Send a numeric TCGplayer product ID as q, for example q=451396. Find IDs with product search. This endpoint reports individual completed transactions, with condition, variant, language, quantity and time. It does not search sales by keyword.

Parameter	Type	Default	Description
`q`	string	Required	Exact numeric TCGplayer product ID, such as 451396.
`country`	`us`	`us`	Only `us` is supported.
`marketplace`	`tcgplayer`	`tcgplayer`	Optional; must match the path.

curl -G https://api.soldgraph.com/v1/tcgplayer/sales \  -H "Authorization: Bearer $SOLDGRAPH_KEY" \  -d q=451396

Anonymous source access has returned at most five rows in our observations, even when requesting a larger limit. Treat the response as a recent sample, not a complete history or a five-sales guarantee. No stable transaction ID was exposed, so repeated polls can include the same sales. next_page is always null because usable sales pagination has not been established. An empty response means no recent rows were returned, not that the product never sold.

purchase_price is the item price; shipping_price is separate; total_price is their sum. Tax and other checkout charges are not represented. Do not compare these raw-card transactions directly with graded eBay sales without matching condition, variant and grading basis.

TCGplayer is the source of these transactions. This product uses TCGplayer data but is not endorsed or certified by TCGplayer. TCGplayer's API terms restrict automated collection and commercial redistribution; technical access does not grant rights to republish the data.

A cache miss returns 202 with a job to poll. Completed requests cost one credit; failures are free. Results are cached for 15 minutes.

#Example response

Illustrative sample captured October 1, 2026. The source can change or withdraw these rows.

Response

{  "request_id": "example-tcgplayer-sales",  "status": "complete",  "credits": 1,  "cached": false,  "result": {    "provider": "tcgplayer",    "country": "us",    "page": 1,    "next_cursor": null,    "collected_at": "2026-10-01T12:00:00+00:00",    "schema_version": 2,    "query": "451396",    "page_size": 5,    "count": 5,    "reported_total": 5,    "next_page": null,    "completeness": "recent_sample_only",    "data": [      {        "product_id": 451396,        "title": "Lugia VSTAR",        "condition": "Near Mint",        "variant": "Holofoil",        "language": "English",        "quantity": 1,        "purchase_price": {          "amount": 6.98,          "currency": "USD"        },        "shipping_price": {          "amount": 1,          "currency": "USD"        },        "total_price": {          "amount": 7.98,          "currency": "USD"        },        "sold_at": "2026-10-01T08:37:16.863000+00:00"      },      {        "product_id": 451396,        "title": "Lugia VSTAR",        "condition": "Near Mint",        "variant": "Holofoil",        "language": "English",        "quantity": 1,        "purchase_price": {          "amount": 5.25,          "currency": "USD"        },        "shipping_price": {          "amount": 1,          "currency": "USD"        },        "total_price": {          "amount": 6.25,          "currency": "USD"        },        "sold_at": "2026-10-01T05:40:09.050000+00:00"      },      {        "product_id": 451396,        "title": "Lugia VSTAR",        "condition": "Damaged",        "variant": "Holofoil",        "language": "English",        "quantity": 1,        "purchase_price": {          "amount": 3.32,          "currency": "USD"        },        "shipping_price": {          "amount": 1.49,          "currency": "USD"        },        "total_price": {          "amount": 4.81,          "currency": "USD"        },        "sold_at": "2026-10-01T00:48:37.747000+00:00"      },      {        "product_id": 451396,        "title": "Lugia VSTAR",        "condition": "Near Mint",        "variant": "Holofoil",        "language": "English",        "quantity": 1,        "purchase_price": {          "amount": 6.98,          "currency": "USD"        },        "shipping_price": {          "amount": 0,          "currency": "USD"        },        "total_price": {          "amount": 6.98,          "currency": "USD"        },        "sold_at": "2026-09-30T22:50:56.593000+00:00"      },      {        "product_id": 451396,        "title": "Lugia VSTAR",        "condition": "Near Mint",        "variant": "Holofoil",        "language": "English",        "quantity": 1,        "purchase_price": {          "amount": 6.8,          "currency": "USD"        },        "shipping_price": {          "amount": 0,          "currency": "USD"        },        "total_price": {          "amount": 6.8,          "currency": "USD"        },        "sold_at": "2026-09-30T22:13:35.927000+00:00"      }    ],    "field_notes": "Recent sample only, not complete history; purchase price excludes separately reported shipping.",    "product_id": 451396  }}

Field	Type	Description
`request_id`	string	ID of this request. Poll it at `/v1/jobs/{request_id}`.
`status`	string	`pending`, `complete` or `failed`. Always check it, even on HTTP 200.
`credits`	integer	Requests charged: 1 when complete, 0 while pending or when failed.
`cached`	boolean	True when the result came from the 15-minute cache.
`poll_url`	string	Only while pending. A path like `/v1/jobs/{id}`: join it to `https://api.soldgraph.com`, not to the `/v1` base URL.
`error.code`	string	Only when failed. See failed job codes.
`result`	object	Only when complete. One source page from the marketplace.
`result.provider`	string	Marketplace ID, like `ebay` or `poshmark`.
`result.country`	string	Always `us`.
`result.query`	string	The `q` you sent, with extra spaces removed.
`result.page`	integer	The page you asked for.
`result.count`	integer	Rows in `result.data` on this page.
`result.reported_total`	integer	Total matches the marketplace reports for the search. It may be rounded or capped.
`result.next_page`	integer \| null	Send this as `page` to get the next page. Null on the last page, and on page 100, the deepest page served.
`result.collected_at`	string	When we collected the page, as an ISO 8601 timestamp.
`result.schema_version`	integer	Version of this response shape. Currently `2`.
`result.completeness`	string	Always `provider_page_only`: one page, not a full sales history.
`result.field_notes`	string	Plain-text notes on how to read this page's fields.
`result.product_id`	integer	Exact TCGplayer product ID requested.
`result.page_size`	integer	Number of source rows in this response.
`result.reported_total`	integer	Source-reported result count for this response.
`result.next_cursor`	string \| null	Always null; sales pagination is not exposed.
`result.data[].product_id`	integer	TCGplayer product ID.
`result.data[].title`	string	Product title from the sale row.
`result.data[].condition`	string	Condition sold.
`result.data[].variant`	string	Printing or variant sold.
`result.data[].language`	string	Language sold.
`result.data[].quantity`	integer	Quantity in transaction.
`result.data[].purchase_price`	object	Paid item price excluding shipping.
`result.data[].shipping_price`	object	Shipping separately reported by source.
`result.data[].total_price`	object	Sum of purchase_price and shipping_price; excludes tax and other checkout charges.
`result.data[].sold_at`	string	Transaction timestamp from source in UTC.

Try it