StockX sold data: API reference
StockX is the marketplace for sneakers, streetwear and collectibles where every item is checked in hand before the sale completes. source=stockx returns real per sale StockX sold prices, at size level, through /v1/sold and /v1/comps, and live StockX listings through /v1/active.
This page is the technical reference. For coverage, examples and pricing see StockX on CompsAPI. Parameters, stats, the AI junk filter and errors shared by every source are in the common reference.
GET /v1/sold?source=stockx&q=jordan+1+chicago&stats=1
GET /v1/comps?source=stockx&q=jordan+1+retro+high+og+chicago+lost+and+found&days=365
Coverage
- Sold history back to 2019. A
startdate ordaysvalue reaches all of it. - Coverage is per product. It covers the products that sell, and it grows as new releases appear.
Target one product or one size
A keyword usually matches several StockX products: the adult shoe and its grade school, pre school and toddler versions are separate products at very different prices. By default source=stockx leaves the kids' versions out unless your keyword names one (... GS). stats.by_product always shows every matched product with its own median, so nothing is blended without you seeing it. For exact results pass product_id (from raw.product_id, or the product's slug) or style_id, and item_size for one size.
These work on /v1/sold, /v1/comps and /v1/active for source=stockx and source=goat. On any other source product_id, style_id and item_size return 400, and kids is ignored.
| Parameter | Meaning |
|---|---|
product_id | One or more product ids (comma separated, 10 at most) as carried in raw.product_id: a StockX uuid or a GOAT number. A product slug or product page URL works too. With product_id, q is optional and is not used for matching. |
style_id | The manufacturer style code (FV5029-006). Spaces and dashes are ignored. |
item_size (alias shoe_size) | One or more sizes as the marketplace writes them: 10, 10.5, 8W, 5Y, 6C, M, XL. US 10 and US W 8 are accepted. size stays the page size on /v1/sold. |
kids | Kids' versions of a shoe (GS, PS, TD, Infants, Toddler, Big Kid) are separate products. Default: left out when the keyword also matches a product that is not a kids' version and does not name one. kids=1 includes them, kids=only returns only them, kids=0 always leaves them out. |
GET /v1/sold?source=stockx&q=jordan+4+bred+reimagined&stats=1
GET /v1/sold?source=stockx&q=jordan+4+bred+reimagined&item_size=10
GET /v1/comps?source=stockx&style_id=FV5029-006
GET /v1/sold?source=stockx&q=jordan+4+bred+reimagined&kids=1
The answer reports what it did. stats.products is the number of products inside the headline figures. stats.by_product lists up to 12 matched products, most sales first, each with product_id, title, style_id, url, count, median, p25, p75, min, max, newest_sale, kids and in_stats. meta.scope carries the scope applied: product_id, style_id, item_size, kids (excluded, included or only), and when kids' versions were left out kids_rows_excluded, kids_products_excluded and a hint. On 21 November 2026 the first call above read a median of $215 over 1,561 sales of the adult shoe, and the last, with kids' versions in, $207 over 2,224.
What a StockX row carries
Every row is one sale of one size. authenticity.basis is marketplace_verified with verified: true on every row, because StockX inspects every item. Each row also carries a market object: the order book and price dynamics for that product and size as recorded with the sale.
"market": { "lowest_ask": 91, "highest_bid": 84, "num_asks": 162, "num_bids": 21,
"price_premium": 0.071, "volatility": 0.25885, "sell_through_days": 486.0,
"sales_72h": 1, "sales_annual": 430 }
market field | Meaning |
|---|---|
lowest_ask, highest_bid | The lowest price someone was asking and the highest someone was bidding. |
num_asks, num_bids | How many asks and bids stood behind those. |
price_premium | The price against retail, as a ratio. Negative means below retail. |
volatility | Recent price volatility for the product. |
sell_through_days | Typical days to sell. |
sales_72h, sales_annual | Sales in the last 72 hours and the last year. |
The market values are a snapshot recorded with the row. They are not the book at the instant of the sale and they are not the book now. For current asks, call /v1/active?source=stockx. It returns the order book per size in raw.sizes.
Fields in raw
raw field | Meaning |
|---|---|
order_type | STANDARD or EXPRESS: how the sale was fulfilled. null on some sales. |
size | The size that sold. |
variant_id, product_id, style_id | StockX's size and product ids and the manufacturer style code. |
brand | Brand. |
sales_this_period, sales_last_period | Sale volume in the current and previous period. |
The market values are also present in raw under the same names.
Condition labels
StockX rows read new. stats.by_condition shows the labels present for your search.
A sold row
Trimmed for length: null fields and the common fields from the shared reference are left out.
{
"source": "stockx",
"title": "Jordan 1 Retro High OG Chicago Lost and Found",
"price": 235.0,
"last_sold": "2026-11-17T19:17:47Z",
"condition": "new",
"format": "FIXED_PRICE",
"url": "https://stockx.com/air-jordan-1-retro-high-og-chicago-reimagined-lost-and-found",
"authenticity": {
"basis": "marketplace_verified",
"verified": true,
"grader": "StockX",
"grade": null,
"cert_number": null
},
"market": {
"lowest_ask": 170,
"highest_bid": 304,
"num_asks": 1056,
"num_bids": 433,
"price_premium": 0.306,
"volatility": 0,
"sell_through_days": 60.9,
"sales_72h": 52,
"sales_annual": 5156
},
"raw": {
"size": "8.5",
"variant_id": "b8008a93-32c0-496e-a84c-a66e26170f3e",
"product_id": "9a4d44f9-4b16-4abc-ba58-c0db340ee791",
"style_id": "DZ5485-612",
"brand": "Jordan",
"price_premium": 0.306,
"volatility": 0,
"lowest_ask": 170,
"highest_bid": 304,
"num_asks": 1056,
"num_bids": 433,
"sell_through_days": 60.9,
"sales_72h": 52,
"sales_annual": 5156,
"sales_this_period": 52,
"sales_last_period": 34
}
}
Live listings
GET /v1/active?source=stockx&q= returns what is for sale on StockX right now for your search, read at the moment you call. One row per product, priced at the lowest ask. raw carries the top of the book: lowest ask, highest bid, number of asks and bids, last sale, 72-hour sales, price premium and volatility, plus the style id.
- Sort: best_match, newly_listed, price_asc, price_desc.
source=allincludes this marketplace;live_status.stockxtells you whether its search answered.total_activecounts the listings this search returned, not every live listing on the site.
Live listings by size
raw.sizes holds one block per size, on the top 5 products of a keyword answer and on every product named by product_id or style_id: lowest_ask, highest_bid, spread, num_asks, num_bids, last_sale, last_sale_date, sales_72h, sales_90d, avg_price_90d, sales_12m, avg_price_12m, express_lowest_ask, the standard, express_standard and express_expedited asks, variant_id, size_type, size_eu and size_uk. raw.gender says who the product is cut for.
With item_size, the row is narrowed to that size: price is that size's lowest ask, quantity_available its ask count, raw.size_market its block, and raw.ask_scope reads lowest ask in size <size>. Products with no ask in that size are left out.
GET /v1/active?source=stockx&product_id=air-jordan-4-retro-bred-reimagined
GET /v1/active?source=stockx&q=jordan+4+bred+reimagined&item_size=10
A live row from 17 November 2026 (search jordan 1 retro high og):
{
"item_id": "stockx-019c8c79-5b21-75a2-adb2-591768ff9b7c",
"title": "Jordan 1 Retro High OG Royal (2026)",
"url": "https://stockx.com/air-jordan-1-retro-high-og-royal-2026",
"price": 126.0,
"price_max": null,
"currency": "USD",
"shipping": null,
"shipping_text": null,
"format": "BIN",
"bids": null,
"ends_at": null,
"buy_it_now_available": true,
"best_offer_enabled": false,
"quantity_available": 638,
"condition": "new",
"seller": null,
"seller_feedback": null,
"seller_positive_pct": null,
"location": null,
"source": "stockx",
"authenticity": {
"basis": "marketplace_verified",
"verified": true,
"grader": "StockX",
"grade": null,
"cert_number": null
},
"raw": {
"product_id": "019c8c79-5b21-75a2-adb2-591768ff9b7c",
"style_id": "IQ5495-005",
"brand": "Jordan",
"category": "sneakers",
"lowest_ask": 126.0,
"highest_bid": 132.0,
"num_asks": 638,
"num_bids": 488,
"last_sale": 131,
"last_sale_date": "2026-11-17T20:41:22.075Z",
"price_premium": -0.292,
"volatility": 0.049173,
"sales_72h": 68,
"sales_annual": 2375,
"ask_scope": "lowest ask across all sizes"
}
}
The shared parameters and fields are under live listings.
Limits
- Use StockX's wording in
q. StockX titles often leave out the brand ("Jordan 1 Retro High OG", without "Nike" or "Air"). Every word inqmust be in the title, so a keyword that returns nothing usually has one word StockX does not use. - No listing date or list price. StockX matches a bid to an ask, so there is no
signalsobject.market.price_premiumis the closest equivalent: the sale against retail. - Stats are across sizes unless you pass
item_size.statscovers every size that matched. Passitem_size=10for one size. - Kids' versions are left out by default. See target one product or one size.
kids=1returns them. us_saleis an eBay field and isnullhere.