# StockX Sales API Documentation

<p><strong>StockX Sales API Documentation</strong> 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.</p>

- **Documentation:** [https://scrappa.co/docs/stockx-api/stockx_sales](https://scrappa.co/docs/stockx-api/stockx_sales)
- **API group:** StockX API
- **Endpoint:** `GET https://scrappa.co/api/stockx/sales`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `product` | string | Yes | A stockx.com product url, a product slug or a product UUID. |
| `size` | string | No | 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. |
| `country` | string | No | Market country: US, DE or GB. Defaults to US. Sets the currency: US gives USD, DE gives EUR, GB gives GBP. |
| `currency` | string | No | USD, EUR or GBP. Must match the country. Send it alone to pick its country. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. StockX is not called and the request is not billable. |
| 404 | Product Not Found | StockX does not know this product. This response is not billable. |
| 503 | Upstream Unavailable | StockX did not answer after several tries. Retry later. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)