MKM API

API Documentation >> API 2.0 Main >> Marketplace Information >> Price Guide

Attention: This request is restricted to Widget apps, 3rd party apps, and Dedicated apps of powersellers and professionals

The file is updated once every day. Security mechanisms will be implemented to return a 429 if requested more frequently.

Deprecation Notice

This endpoint was deprecated on 05.06.2024 as this feature was made generally available via the website

Price Guide

Allowed HTTP Methods

GET - Returns a gzipped CSV file with relevant price guides for all MtG cards.

Resource Information

Authentication - Required, but restricted to selected users
Response Format - XML or JSON
Response Object - see below
API Version - 2.0
Resource URI - https://api.cardmarket.com/ws/v2.0/priceguide

Attention: This request is restricted to Widget apps, 3rd party apps, and Dedicated apps of powersellers and professionals

3rd Party app users please note: When calculating the signature, only provide the credentials for your app, leaving the user credentials empty strings.

Parameters

idGame (query parameter)
- Specifies the Game the pricelist is for
- Type: integer
- Optional (default is 1 for Magic the Gathering)

Response Object

Price Guide Entity

{
    priceguidefile:             // The base64 encoded string
    mime:                       // The MIME type of the file
    links:                      // HATEOAS links
}

The response object and the relevant priceguidefile contains a string which is Base64 encoded. Decoding it returns a binary string that has to be written to an empty file. This file is gzipped and finally needs to be unpacked to retrieve the CSV file having the following columns:

idProduct - The product ID
Avg. Sell Price - The average sell price as shown in the chart at the website for non-foils
Low Price - The lowest price at the market for non-foils
Trend Price - The trend price as shown at the website (and in the chart) for non-foils
German Pro Low - The lowest sell price from German professional sellers
Suggested Price - A suggested sell price for professional users, determined by an internal algorithm; this algorithm will not be made public
Foil Sell - The average sell price as shown in the chart at the website for foils
Foil Low - The lowest price at the market as shown at the website (for condition EX+) for foils
Foil Trend - The trend price as shown at the website (and in the chart) for foils
Low Price Ex+ - The lowest price at the market for non-foils with condition EX or better
AVG1 - The average sale price over the last day
AVG7 - The average sale price over the last 7 days
AVG30 - The average sale price over the last 30 days
Foil AVG1 - The average sale price over the last day for foils
Foil AVG7 - The average sale price over the last 7 days for foils
Foil AVG30 - The average sale price over the last 30 days for foils

Example Request

1. Downloading priceguide file for Magic (Default idGame=1)

GET https://api.cardmarket.com/ws/v2.0/priceguide

3. Downloading priceguide file for YGO

GET https://api.cardmarket.com/ws/v2.0/priceguide?idGame=3

Contents