Webhooks
Prices
Price webhooks notify you whenever there is an update to the market pricing for Pokémon cards. This includes both raw and graded price updates.
Supported Events
pokemon.expansions.prices.raw_updated: Triggered when raw card prices are updated.pokemon.expansions.prices.graded_updated: Triggered when graded card prices are updated.
Payload Structure
The payload contains an expansion_ids array, which lists the IDs of the expansions that had price updates. You can then use the Search Cards endpoint with these expansion IDs to fetch the latest pricing data.
id <string>
Unique identifier for the webhook event.
name <string>
The name of the event (e.g., pokemon.expansions.prices.raw_updated).
data <object>
The event data containing expansion_ids.
Sample Payload
{
"id": "evt_pkmn_prices_123",
"name": "pokemon.expansions.prices.raw_updated",
"data": {
"expansion_ids": ["base1", "base2", "base3"]
}
}
# No curl example needed for receiving webhooks, but we include it for consistency.
# Use this to simulate a webhook if needed:
curl -X POST 'https://your-app.com/webhooks' \
-H 'Content-Type: application/json' \
-H 'X-Scrydex-Signature: t=123,v1=abc' \
-d '{"id":"evt_pkmn_prices_123","name":"pokemon.expansions.prices.raw_updated","data":{"expansion_ids":["base1"]}}'
Pop Reports
Population report webhooks notify you whenever there is an update to the population data for Pokémon cards.
Supported Events
pokemon.expansions.pop_reports.updated: Triggered when population report data is updated.
Payload Structure
The payload contains an expansion_ids array, which lists the IDs of the expansions that had population report updates.
id <string>
Unique identifier for the webhook event.
name <string>
The name of the event (e.g., pokemon.expansions.pop_reports.updated).
data <object>
The event data containing expansion_ids.
Sample Payload
{
"id": "evt_pkmn_pop_123",
"name": "pokemon.expansions.pop_reports.updated",
"data": {
"expansion_ids": ["base1"]
}
}
curl -X POST 'https://your-app.com/webhooks' \
-H 'Content-Type: application/json' \
-H 'X-Scrydex-Signature: t=123,v1=abc' \
-d '{"id":"evt_pkmn_pop_123","name":"pokemon.expansions.pop_reports.updated","data":{"expansion_ids":["base1"]}}'