StockX Portfolio Spread-Movers Index

Turn a list of StockX products into a ranked arbitrage-scan report: the live bid/ask spread for every size, and which sizes have the widest gap between what buyers will pay and what sellers are asking right now.

Why use this actor

• No account required — reads public StockX market data; no login or API key needed.
• Spread computed for every size — lowestAsk - highestBid and that gap as a percentage, calculated for you on every size of every product.
• Automatic ranking — one summary record lists the widest spreads across your whole list, sorted from biggest gap to smallest, so you don't have to sort a spreadsheet yourself.
• Optional trend mode — turn on useHistory and the actor remembers each size's spread between runs, so the ranking can show which spreads widened or narrowed the most since your last run, not just which are widest today.
• Stable JSON output — one row per size plus one ranking summary row, ready for a spreadsheet or database with no clean-up.
• Localized pricing — configure ship-to country and display currency per run.

How it works

1. You give the actor a list of StockX product URLs (or slugs).
2. For each product, it fetches the current market data for every size.
3. For every size that has both a live ask and a live bid, it calculates the spread (lowestAsk - highestBid) and the spread as a percentage of the asking price.
4. All sizes across all products are combined into one ranked list, from widest spread to narrowest.
5. If useHistory is on, each size's spread is compared to the last time you ran the actor, and the ranking shows the biggest movers instead of just the biggest gaps.
6. Results land in Apify's dataset, exportable as JSON, CSV, or Excel.

You don't need to manage any browsers, scrapers, or your own database to track spreads over time — the actor remembers for you when useHistory is on.

Input

{
    "productUrls": [
        { "url": "https://stockx.com/air-jordan-1-retro-low-og-banned" },
        { "url": "https://stockx.com/adidas-yeezy-boost-350-v2-zebra-kids" }
    ],
    "skus": [],
    "useHistory": false,
    "maxItems": 50,
    "country": "US",
    "currency": "USD",
    "maxConcurrency": 2,
    "maxRequestRetries": 6,
    "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
}

Field	Type	Default	Description
productUrls	URL[]	—	StockX product URLs (https://stockx.com/<slug>). Use this OR skus.
skus	string[]	[]	StockX slugs (the part after stockx.com/), e.g. "air-jordan-1-retro-low-og-banned". Only used if productUrls is empty.
useHistory	boolean	false	When ON, remembers each size's spread between runs and ranks by the biggest change since last time. First run (or any size seen for the first time) has no prior data yet, so those rows simply won't have a change value — never a made-up one. When OFF, ranks by the widest spread right now.
maxItems	integer	50	How many rows to include in the final ranked list (across all products/sizes combined).
country	string	"US"	Two-letter ISO country code for pricing locale.
currency	string	"USD"	ISO currency code (e.g. USD, EUR, GBP).
maxConcurrency	integer	2	Number of parallel workers.
maxRequestRetries	integer	6	Retry budget per request before skipping.
proxyConfiguration	object	RESIDENTIAL	Apify Proxy or custom proxy list. RESIDENTIAL group recommended.

Output

One row per size (recordType: "SIZE_SPREAD") — real output from a live run:

{
    "recordType": "SIZE_SPREAD",
    "sourceUrl": "https://stockx.com/air-jordan-1-retro-low-og-banned",
    "scrapedAt": "2026-08-06T09:51:27.041377Z",
    "productId": "6a224a43-164d-4f6f-b854-0466f8e79c60",
    "urlKey": "air-jordan-1-retro-low-og-banned",
    "title": "Jordan 1 Retro Low OG Banned",
    "variantId": "019b0523-93b3-7271-bf18-01d6503fe8f0",
    "variantIndex": 1,
    "size": null,
    "lowestAsk": 133,
    "highestBid": 27,
    "spread": 106,
    "spreadPercent": 79.7,
    "numberOfAsks": 3,
    "numberOfBids": 2,
    "historyStatus": "no_prior_snapshot"
}

With useHistory: true, a size that was also seen in a previous run additionally carries the prior numbers and the change — this is real output from a second run of the same product:

{
    "recordType": "SIZE_SPREAD",
    "urlKey": "air-jordan-1-retro-low-og-banned",
    "variantId": "019b0523-93b3-7271-bf18-01d6503fe8f0",
    "lowestAsk": 133,
    "highestBid": 27,
    "spread": 106,
    "spreadPercent": 79.7,
    "prevSpread": 106,
    "prevSpreadPercent": 79.7,
    "prevScrapedAt": "2026-08-06T09:52:56.776593Z",
    "spreadChange": 0,
    "spreadPercentChange": 0.0,
    "historyStatus": "compared_to_prior_run"
}

One ranking summary row (recordType: "MOVERS_RANKING") at the end of each run — real output, maxItems: 15 across 3 products / 60 sizes:

{
    "recordType": "MOVERS_RANKING",
    "scrapedAt": "2026-08-06T09:51:27.787090Z",
    "rankedBy": "spread",
    "useHistory": false,
    "totalCandidates": 60,
    "returned": 15,
    "movers": [
        {
            "rank": 1,
            "urlKey": "air-jordan-1-retro-low-og-sp-travis-scott-sail-tropical-pink",
            "title": "Jordan 1 Retro Low OG SP Travis Scott Sail Tropical Pink",
            "variantId": "019cfdb6-e638-730d-b804-2e04fd6dd7f6",
            "lowestAsk": 1600,
            "highestBid": 451,
            "spread": 1149,
            "spreadPercent": 71.81,
            "spreadChange": null,
            "spreadPercentChange": null,
            "historyStatus": "no_prior_snapshot"
        },
        {
            "rank": 2,
            "urlKey": "air-jordan-1-retro-low-og-sp-travis-scott-sail-tropical-pink",
            "spread": 266,
            "spreadPercent": 40.61
        },
        "... 13 more"
    ]
}

Field	Type	Description
recordType	string	"SIZE_SPREAD" for a per-size row, "MOVERS_RANKING" for the summary row, "ERROR" if a product could not be read.
urlKey	string	StockX slug for the product.
title	string	Product display title.
variantId	string	StockX's internal ID for this size.
size	string | null	Human-readable size label, when StockX includes it on the size record (often absent — identify sizes by variantId when it's null).
lowestAsk	number	Current lowest ask for this size.
highestBid	number	Current highest bid for this size.
spread	number	lowestAsk - highestBid — the bid/ask gap, in the run's currency.
spreadPercent	number	The spread as a percentage of the lowest ask.
numberOfAsks / numberOfBids	integer	How many asks / bids stand on the book for this size.
prevSpread / prevSpreadPercent / prevScrapedAt	number / number / string	This size's spread the last time it was seen (only present when useHistory is on AND a prior run recorded this size).
spreadChange / spreadPercentChange	number	Change vs. the prior run (only present with useHistory and a prior snapshot).
historyStatus	string	"no_prior_snapshot" or "compared_to_prior_run" — tells you honestly whether the change fields are real or simply not yet available.
rankedBy	string	"spread" (widest current gap) or "spreadChange" (biggest mover since last run — only once history exists).
movers	array	The ranked list, widest/biggest-mover first, capped at maxItems.

A note on "movers"

Every StockX product page shows the current spread, but not how it changed. This actor is the only way in this suite to see that change over time: turn useHistory on, run it on a schedule (e.g. once a day in the Apify Console), and each run's ranking shows which sizes had the biggest swing since the last run — a genuine day-over-day mover signal, not a single-snapshot guess. Without useHistory, you still get a fully real, useful ranking of the widest gaps today — just not a trend.

Other StockX Scrapers

Actor	What it does
StockX Search Scraper	Search keywords or categories; get every result tile with live market data.
StockX Product Scraper	Full product detail — market snapshot, traits, stats — from a list of product URLs.
StockX Orderbook Scraper	Live per-size bid/ask orderbook with spread and 72-hour velocity for any product.
StockX Sales History Scraper	Multi-bucket sales statistics (annual, 90-day, 72-hour) plus per-size breakdowns.
StockX Release Calendar Scraper	Upcoming and recent drops with release dates and pre-release bid/ask signals.
StockX Portfolio Spread-Movers Index	Per-size spread and ranked spread-movers across a list of products — this actor.