# StockX Market Price & Sales History Finder (`xyrelith-data/stockx-market-price-and-sales-history-finder`) Actor

Get StockX lowest ask, highest bid, last sale, and recent sales history for sneakers, streetwear, watches, and collectibles, by search, brand, category, or product slug.

- **URL**: https://apify.com/xyrelith-data/stockx-market-price-and-sales-history-finder.md
- **Developed by:** [Xyrelith Data](https://apify.com/xyrelith-data) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## StockX Market Price & Sales History Finder

Collect live resale market data from **StockX** for sneakers, apparel, watches, handbags, electronics, collectibles, and trading cards. Search by keyword, browse a brand or category, paste StockX URLs, fetch exact products, or pull individual sales history — with per-size order books and prices in 28 currencies across 24 markets.

### What this actor does

- **Six modes:** keyword `search`, `byBrand`, `byCategory`, exact `byProduct` slugs or URLs, `byUrl` for pasted links, and `salesHistory` for individual transactions
- **Full market snapshot:** lowest ask, highest bid, ask tiers and counts, last sale, 72-hour velocity, 90-day and annual averages, volatility, price premium, and the 12-month low/high
- **Per-size order book:** every available size with its own ask, bid, spread, spread percentage, last sale, 72-hour sales, GTINs, and size conversions
- **Product identity:** style ID, colorway, retail price, release date, description, traits, gallery images, and 360° views
- **Honest limits:** StockX caps each query at 1,000 results, serves sales 50 at a time, and the actor tells you when a cap or filter affects the result
- **Empty fields are omitted** from every record — no `null` placeholders or sentinel values

No StockX account, cookies, or proxy setup is required.

### Output: per product

Used by `search`, `byBrand`, `byCategory`, `byProduct`, and `byUrl` product links.

- `slug`, `productUrl`, `sourceUrl`, `productId` — identity and the listing page the row came from
- `title`, `name`, `model`, `brand`, `brandSlug` — product naming
- `category`, `subcategory`, `categories[]`, `categoryPath[]`, `productCategory`, `primaryCategory` — category path
- `gender`, `condition`, `listingType` — audience and listing attributes
- `styleId`, `colorway`, `retailPrice`, `releaseDate` — manufacturer and release data when StockX publishes it
- `description` — plain-text description with markup removed
- `traits[]` — visible product traits as `{name, value, format}` objects
- `imageUrl`, `smallImageUrl`, `thumbUrl`, `gallery[]`, `gallery360[]`, `verticalImages[]` — image links
- `lowestAsk`, `highestBid` — current best prices
- `lowestAskUpdatedAt`, `highestBidUpdatedAt` — when each side last changed
- `numberOfAsks`, `numberOfBids`, `askServiceLevels` — order-book depth and Standard / Express / Next-Day ask tiers
- `lastSale`, `lastSaleChangePercentage`, `lastSaleChangeValue` — most recent transaction and its change
- `salesLast72Hours` — units traded in the last 72 hours
- `deadstockSold` — annual sales count (kept for compatibility with older integrations)
- `annualLow`, `annualHigh`, `annualAveragePrice`, `annualSalesCount` — 12-month range and stats
- `volatility`, `pricePremium`, `averageDeadstockPrice` — market character
- `last90DaysAveragePrice`, `last90DaysSalesCount` — 90-day stats
- `currency`, `region` — pricing currency and market used for this run
- `variants[]` — per-size order book rows (below)
- `recentSales[]` — recent individual sales when you enable sales enrichment
- `sponsored` — present and `true` when StockX marks a listing as sponsored
- `recordType: "product"`, `siteName: "StockX"`, `scrapedAt`

#### Variant object (`variants[]`)

- `variantId`, `sku`, `size`, `sizeType`, `sizeConversions[]`, `gtins[]`
- `lowestAsk`, `highestBid`, `numberOfAsks`, `numberOfBids`
- `lastSale`, `salesLast72Hours`, `last90DaysAveragePrice`, `last90DaysSalesCount`
- `spread`, `spreadPct` — only when both an ask and a bid exist
- `currency`, `region`

### Output: per sale (`salesHistory` mode and `recentSales[]`)

- `amount`, `currency` — sale price and currency
- `createdAt` — transaction timestamp
- `orderType` — `EXPRESS` or `STANDARD`
- `shoeSize`, `sizeType`, `sizeConversions[]`, `variantId` — the size that sold
- `productSlug`, `productUrl`, `productTitle` — the product the sale belongs to
- `saleKey` — deterministic key built from product, timestamp, price, and size
- `region` — market used for this run
- `recordType: "sale"`, `siteName: "StockX"`, `scrapedAt`

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | string | `search` | `search`, `byBrand`, `byCategory`, `byProduct`, `byUrl`, or `salesHistory` |
| `searchQueries` | array | `["jordan"]` | One or more keywords (mode=`search`) |
| `brand` | string | – | Brand alias for mode=`byBrand`, e.g. `jordan`, `nike`, `new-balance`; also filters other modes when set |
| `category` | string | – | StockX category for mode=`byCategory`; also filters other modes when set |
| `gender` | string | – | `men`, `women`, or `kids` |
| `color` | string | – | Common color filter |
| `sortBy` | string | `featured` | Ten StockX sort orders, including `lowest_ask`, `most-active`, and `release_date` |
| `productSlugs` | array | – | Product slugs or StockX product URLs (mode=`byProduct` / `salesHistory`) |
| `startUrls` | array | – | StockX search, category, brand, browse, or product URLs (mode=`byUrl`) |
| `currency` | string | `USD` | One of 28 supported currencies |
| `country` | string | `US` | One of 24 supported markets |
| `minPrice` | integer | – | Drop products whose lowest ask is below this value |
| `maxPrice` | integer | – | Drop products whose lowest ask is above this value |
| `minSalesLast72Hours` | integer | – | Keep products with at least this many recent sales |
| `includeProductDetails` | boolean | `true` | Fetch the full product record while browsing; off gives a compact listing row |
| `includeVariants` | boolean | `true` | Add the per-size order book to full product records |
| `includeSalesHistory` | boolean | `false` | Add `recentSales[]` to each product record |
| `salesLimit` | integer | `50` | Maximum individual sales per product (1–500) |
| `salesCondition` | string | `all` | `all`, `new-and-verified`, `new-other`, or `used` |
| `maxItems` | integer | `25` | Hard cap on emitted records (1–1,000) |
| `maxPages` | integer | `5` | Listing pages per query (1–25, 40 products per page) |

#### Example: search with sizes and full market stats

```json
{
  "mode": "search",
  "searchQueries": ["jordan 4 retro"],
  "currency": "USD",
  "country": "US",
  "sortBy": "most-active",
  "maxItems": 25,
  "maxPages": 2,
  "includeProductDetails": true,
  "includeVariants": true
}
```

#### Example: a brand within a price band

```json
{
  "mode": "byBrand",
  "brand": "new-balance",
  "gender": "men",
  "minPrice": 120,
  "maxPrice": 400,
  "maxItems": 50
}
```

#### Example: paste StockX links

```json
{
  "mode": "byUrl",
  "startUrls": [
    "https://stockx.com/category/watches",
    "https://stockx.com/brands/casio",
    "https://stockx.com/browse/women",
    "https://stockx.com/air-jordan-5-retro-wolf-grey-2026"
  ],
  "currency": "EUR",
  "country": "DE",
  "maxItems": 40
}
```

#### Example: individual sales history

```json
{
  "mode": "salesHistory",
  "productSlugs": ["air-jordan-5-retro-wolf-grey-2026"],
  "salesCondition": "all",
  "salesLimit": 200,
  "maxItems": 200,
  "currency": "GBP",
  "country": "GB"
}
```

### Use cases

- **Resale price monitoring** — schedule daily runs and track lowest ask, highest bid, and last sale per product
- **Sneaker and streetwear research** — compare colorways, release dates, retail prices, and 12-month ranges
- **Watch and collectible dealers** — read per-size or per-variant order books, spreads, and ask depth
- **Sales-ledger analysis** — pull individual transactions to study realized prices, size premiums, and volume
- **Cross-market pricing** — request the same product in different currencies and markets to compare localized pricing
- **Catalog enrichment** — collect style IDs, GTINs, colorways, traits, and image galleries for a product database

### FAQ

**Do I need a StockX account, cookies, or a proxy?**
No. The actor reads StockX's public product and market data directly. You do not need to log in, supply cookies, or configure a proxy.

**How fresh is the data?**
Each run requests current listings and market statistics, so prices, asks, bids, and recent sales reflect what StockX serves at run time.

**Why is `lowestAsk` or `highestBid` missing for some products?**
Those fields are omitted when no active seller or buyer exists for the product or size. Missing means "nothing live right now", not zero.

**How many results can one query return?**
StockX caps a single query at 1,000 products across 25 pages of 40. When the cap is reached, the run status suggests splitting by brand, category, or gender for wider coverage.

**How deep is the sales history?**
StockX serves 50 individual sales per request with a cursor for older pages. `salesLimit` controls how many sales the actor collects per product, up to 500.

**Why did a sale-condition filter return all conditions?**
StockX intermittently rejects condition-filtered sales requests. When that happens the actor retries, falls back to all conditions, and says so in the run status instead of returning nothing.

**What does "Price: high to low" mean?**
StockX does not serve a true descending price sort, so the actor collects the requested pages in ascending order and reverses those rows before emitting them. Increase `maxPages` to widen the range considered.

**Why are `chainId` and `deadstockRangeLow` / `deadstockRangeHigh` not in the output?**
StockX no longer exposes a transaction ID or a separate deadstock range. Existing output fields are preserved, but these are omitted rather than filled with placeholders; `annualLow` and `annualHigh` carry the 12-month range.

**Is this affiliated with StockX?**
No. This is an independent, third-party actor that reads publicly available StockX data. It is not operated by or affiliated with StockX.

# Actor input Schema

## `mode` (type: `string`):

What to collect from StockX.

## `searchQueries` (type: `array`):

One or more keywords for mode=search, e.g. 'jordan 4 retro', 'yeezy 350', 'rolex submariner'.

## `brand` (type: `string`):

Brand alias for mode=byBrand, e.g. 'jordan', 'nike', 'new-balance', 'casio'. When set in other modes it narrows the results to that brand.

## `category` (type: `string`):

StockX category for mode=byCategory. When set in other modes it narrows the results to that category.

## `gender` (type: `string`):

Optional audience filter for search and browse modes.

## `color` (type: `string`):

Optional color filter for search and browse modes.

## `sortBy` (type: `string`):

Order of search and browse results.

## `productSlugs` (type: `array`):

Products for mode=byProduct or mode=salesHistory. Paste a StockX product URL or the slug after stockx.com/, e.g. 'air-jordan-4-retro-white-cement-2025'.

## `startUrls` (type: `array`):

Search, category, brand, browse, or product URLs for mode=byUrl. Paste one URL per line.

## `currency` (type: `string`):

Currency for all prices.

## `country` (type: `string`):

Market that determines the order book and localized prices.

## `minPrice` (type: `integer`):

Drop products whose lowest ask is below this value. Applies to fetched rows in the selected currency.

## `maxPrice` (type: `integer`):

Drop products whose lowest ask is above this value. Applies to fetched rows in the selected currency.

## `minSalesLast72Hours` (type: `integer`):

Keep products that sold at least this many units in the last 72 hours. Products without a count are kept.

## `includeProductDetails` (type: `boolean`):

When browsing or searching, fetch each product's full record: style ID, colorway, retail price, release date, traits, gallery, and market statistics. Off gives a fast, compact listing row.

## `includeVariants` (type: `boolean`):

Add the per-size order book (asks, bids, spread, last sale, GTINs) to full product records.

## `includeSalesHistory` (type: `boolean`):

Add recent individual sales to each product record. Use mode=salesHistory to emit sales as separate rows.

## `salesLimit` (type: `integer`):

Maximum individual sales to collect per product (1-500).

## `salesCondition` (type: `string`):

Condition filter for sales history. If StockX does not serve filtered sales for a product, all conditions are returned and the run says so.

## `maxItems` (type: `integer`):

Hard cap on emitted records. StockX itself caps each query at 1,000 results.

## `maxPages` (type: `integer`):

Maximum listing pages per query. Each page holds up to 40 products; StockX stops at 25 pages.

## Actor input object example

```json
{
  "mode": "search",
  "searchQueries": [
    "jordan"
  ],
  "sortBy": "featured",
  "productSlugs": [],
  "startUrls": [],
  "currency": "USD",
  "country": "US",
  "includeProductDetails": false,
  "includeVariants": false,
  "includeSalesHistory": false,
  "salesLimit": 50,
  "salesCondition": "all",
  "maxItems": 1,
  "maxPages": 1
}
```

# Actor output Schema

## `products` (type: `string`):

Dataset containing StockX product records (recordType=product) and individual sales (recordType=sale).

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "searchQueries": [
        "jordan"
    ],
    "sortBy": "featured",
    "productSlugs": [],
    "startUrls": [],
    "currency": "USD",
    "country": "US",
    "includeProductDetails": false,
    "includeVariants": false,
    "includeSalesHistory": false,
    "salesLimit": 50,
    "salesCondition": "all",
    "maxItems": 1,
    "maxPages": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("xyrelith-data/stockx-market-price-and-sales-history-finder").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "searchQueries": ["jordan"],
    "sortBy": "featured",
    "productSlugs": [],
    "startUrls": [],
    "currency": "USD",
    "country": "US",
    "includeProductDetails": False,
    "includeVariants": False,
    "includeSalesHistory": False,
    "salesLimit": 50,
    "salesCondition": "all",
    "maxItems": 1,
    "maxPages": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("xyrelith-data/stockx-market-price-and-sales-history-finder").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "searchQueries": [
    "jordan"
  ],
  "sortBy": "featured",
  "productSlugs": [],
  "startUrls": [],
  "currency": "USD",
  "country": "US",
  "includeProductDetails": false,
  "includeVariants": false,
  "includeSalesHistory": false,
  "salesLimit": 50,
  "salesCondition": "all",
  "maxItems": 1,
  "maxPages": 1
}' |
apify call xyrelith-data/stockx-market-price-and-sales-history-finder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,xyrelith-data/stockx-market-price-and-sales-history-finder"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Yhm8OsBrdtdtfG6wk/builds/1bTRUB5lLuyXcDFn7/openapi.json