StockX Sales API Documentation List the newest sales of a StockX product, or of one size with the size parameter. Each row has the sale time in ISO format, the size, the price with currency and the order type (standard or express). StockX shows guests only the 50 newest sales and gives no way to page further, so this route has no page parameter and the response says partial: true. A size can have no recent sale: the answer is then an empty list, which is a successful and billable response. A product or size that does not exist returns an error and is not billed. Prices are in the currency of the market and are not a conversion of USD prices. Costs 1 credit per successful request; a failed request is never billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
3 optional filters available.
string
Required
A stockx.com product url, a product slug or a product UUID.
example
string
Optional
Size label as the product shows it, for example 10.5 or XL. Leave out for all sizes. An unknown size returns 422 with the valid sizes.
example
string
Optional
Market country: US, DE or GB. Defaults to US. Sets the currency: US gives USD, DE gives EUR, GB gives GBP.
US
string
Optional
USD, EUR or GBP. Must match the country. Send it alone to pick its country.
USD
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"size": null,
"limit": 50,
"sales": [
{
"size": "8",
"price": {
"amount": 159,
"currency": "USD"
},
"sold_at": "2026-11-04T08:58:31.389Z",
"order_type": "standard"
},
{
"size": "13",
"price": {
"amount": 174,
"currency": "USD"
},
"sold_at": "2026-11-04T07:17:06.794Z",
"order_type": "express"
},
{
"size": "10.5",
"price": {
"amount": 159,
"currency": "USD"
},
"sold_at": "2026-11-04T07:16:21.016Z",
"order_type": "standard"
},
{
"size": "10",
"price": {
"amount": 164,
"currency": "USD"
},
"sold_at": "2026-11-04T07:11:52.007Z",
"order_type": "express"
}
],
"total": 8,
"country": "US",
"partial": true,
"product": {
"id": "9acafeb5-bc4a-4d66-bc3a-4899d2e64775",
"url": "https://stockx.com/air-jordan-4-retro-toro-bravo-2026",
"slug": "air-jordan-4-retro-toro-bravo-2026",
"title": "Jordan 4 Retro Toro Bravo (2026)"
},
"currency": "USD"
},
"meta": {
"billable": true,
"endpoint_family": "sales"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or invalid. StockX is not called and the request is not billable.
{
"errors": {
"country": [
"The country must be US, DE or GB."
]
},
"message": "The request validation failed"
}Product Not Found
StockX does not know this product. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "sales"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested StockX product was not found."
},
"success": false
}Upstream Unavailable
StockX did not answer after several tries. Retry later. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "sales"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The StockX API is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.