Price History
The price history object
The price history object contains a list of historical price points for a specific card.
data <array of maps>
A list of price history entries, each representing a single day.
- date
<string>: The date for the price record (YYYY-MM-DD). - prices
<array of maps>: A list of prices for various variants and conditions on that date.- variant
<string>: The variant of the card (e.g., "normal", "reverseHolofoil"). - condition
<string>: The condition of the card (e.g., "NM", "LP", "MP", "DM"). - is_perfect
<boolean>: Indicates if the card is in perfect condition (e.g., PSA 10). - is_signed
<boolean>: Indicates if the card is signed. - is_error
<boolean>: Indicates if the card is an error card. - type
<string>: The type of price (e.g., "raw", "graded"). - low
<number>: The lowest price recorded for this variant and condition on this date. - market
<number>: The market price recorded for this variant and condition on this date. - currency
<string>: The currency of the prices (e.g., "USD").
- variant
page <integer>
The current page of results.
page_size <integer>
The number of results per page.
count <integer>
The number of items in the current response.
total_count <integer>
The total number of items available.
Here is an example JSON representation of the price history object:
{
"data": [
{
"date": "2026-03-24",
"prices": [
{
"variant": "normal",
"condition": "NM",
"is_perfect": false,
"is_signed": false,
"is_error": false,
"type": "raw",
"low": 0.01,
"market": 0.08,
"currency": "USD"
},
{
"variant": "normal",
"condition": "LP",
"is_perfect": false,
"is_signed": false,
"is_error": false,
"type": "raw",
"low": 0.01,
"market": 0.03,
"currency": "USD"
},
{
"variant": "normal",
"condition": "MP",
"is_perfect": false,
"is_signed": false,
"is_error": false,
"type": "raw",
"low": 0.05,
"market": 0.05,
"currency": "USD"
},
{
"variant": "normal",
"condition": "DM",
"is_perfect": false,
"is_signed": false,
"is_error": false,
"type": "raw",
"market": 0.01,
"currency": "USD"
},
{
"variant": "reverseHolofoil",
"condition": "NM",
"is_perfect": false,
"is_signed": false,
"is_error": false,
"type": "raw",
"low": 0.05,
"market": 0.18,
"currency": "USD"
},
{
"variant": "reverseHolofoil",
"condition": "LP",
"is_perfect": false,
"is_signed": false,
"is_error": false,
"type": "raw",
"low": 0.12,
"market": 0.16,
"currency": "USD"
},
{
"variant": "reverseHolofoil",
"condition": "MP",
"is_perfect": false,
"is_signed": false,
"is_error": false,
"type": "raw",
"low": 0.24,
"market": 0.06,
"currency": "USD"
}
]
},
{
"date": "2026-03-23",
"prices": [
{
"variant": "normal",
"condition": "NM",
"is_perfect": false,
"is_signed": false,
"is_error": false,
"type": "raw",
"low": 0.01,
"market": 0.08,
"currency": "USD"
},
{
"variant": "normal",
"condition": "LP",
"is_perfect": false,
"is_signed": false,
"is_error": false,
"type": "raw",
"low": 0.01,
"market": 0.03,
"currency": "USD"
},
{
"variant": "normal",
"condition": "MP",
"is_perfect": false,
"is_signed": false,
"is_error": false,
"type": "raw",
"low": 0.05,
"market": 0.05,
"currency": "USD"
},
{
"variant": "normal",
"condition": "DM",
"is_perfect": false,
"is_signed": false,
"is_error": false,
"type": "raw",
"market": 0.01,
"currency": "USD"
},
{
"variant": "reverseHolofoil",
"condition": "NM",
"is_perfect": false,
"is_signed": false,
"is_error": false,
"type": "raw",
"low": 0.05,
"market": 0.19,
"currency": "USD"
},
{
"variant": "reverseHolofoil",
"condition": "LP",
"is_perfect": false,
"is_signed": false,
"is_error": false,
"type": "raw",
"low": 0.12,
"market": 0.16,
"currency": "USD"
},
{
"variant": "reverseHolofoil",
"condition": "MP",
"is_perfect": false,
"is_signed": false,
"is_error": false,
"type": "raw",
"low": 0.24,
"market": 0.06,
"currency": "USD"
}
]
}
],
"page": 1,
"page_size": 30,
"count": 2,
"total_count": 2
}
curl --request GET \
--url https://api.scrydex.com/riftbound/v1/cards/RB01-1/price_history \
--header 'X-Api-Key: <api_key_here>' \
--header 'X-Team-ID: <team_id_here>'
Get price history
This endpoint retrieves a list of historical price points for a specific card by its unique identifier.
URL
GET https://api.scrydex.com/riftbound/v1/cards/<id>/price_history
URL Parameters
- id
<string>
The unique identifier of the card to retrieve price history for. This is a required parameter.
Query Parameters
days
<integer>
The number of days back from the current day to fetch price history for.start_date
<string>
The start date for the price history range (format:YYYY-MM-DD).end_date
<string>
The end date for the price history range (format:YYYY-MM-DD).variant
<string>
Filter the results by variant.condition
<string>
Filter the results by condition (e.g., "NM", "LP").company
<string>
Filter the results by grading company.grade
<string>
Filter the results by grade.is_perfect
<boolean>
Filter by perfect condition.is_error
<boolean>
Filter by error card.is_signed
<boolean>
Filter by signed card.page
<integer>
The current page of results.page_size
<integer>
The number of results per page.
curl --request GET \
--url https://api.scrydex.com/riftbound/v1/cards/xy1-1/price_history \
--header 'X-Api-Key: <api_key_here>'
--header 'X-Team-ID: <team_id_here>'