Get market data

Get Basic Market Data API allows you to obtain basic market data - the highest Bid and lowest Ask amount for a given listing.
Note: This API will be deprecated on March 25, 2024. Check out our enhanced market data API in the catalog section.

Request
Security:
path Parameters
listingId
required
string

Unique listing ID needed to fetch market data. Note: You must have a listing for that product to retrieve the marketdata.

query Parameters
country
required
string

ISO Alpha-2 code representing the country you need the market data for.

currencyCode
string
Default: "USD"

The currency code this product is being listed in.

Available values: "AUD", "CAD", "CHF", "EUR", "GBP", "HKD", "JPY", "KRW", "MXN", "NZD", "SGD", "USD"

Responses
200
400

Bad Request

401

Unauthorized

404

Not found

500

Internal Server Error

get/selling/listings/{listingId}/market-data
Request samples
curl -i -X GET \
  'https://api.stockx.com/v2/selling/listings/:listingId/market-data?country=string&currencyCode=USD' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'x-api-key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "listingId": "35d76ac8-a112-4d75-b44f-c8ef04a87c93",
  • "productId": "35d76ac8-a112-4d75-b44f-c8ef04a87c93",
  • "variantId": "35d76ac8-a112-4d75-b44f-c8ef04a87c93",
  • "currencyCode": "USD",
  • "lowestAskAmount": 100,
  • "highestBidAmount": 150
}