← Marketplace reference

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.

https://api.compsapi.com

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

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.

ParameterMeaning
product_idOne 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_idThe 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.
kidsKids' 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 fieldMeaning
lowest_ask, highest_bidThe lowest price someone was asking and the highest someone was bidding.
num_asks, num_bidsHow many asks and bids stood behind those.
price_premiumThe price against retail, as a ratio. Negative means below retail.
volatilityRecent price volatility for the product.
sell_through_daysTypical days to sell.
sales_72h, sales_annualSales 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 fieldMeaning
order_typeSTANDARD or EXPRESS: how the sale was fulfilled. null on some sales.
sizeThe size that sold.
variant_id, product_id, style_idStockX's size and product ids and the manufacturer style code.
brandBrand.
sales_this_period, sales_last_periodSale 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.

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