List biggest gainers and losers
Cards
List biggest gainers and losers
Cards ranked by price movement over a window, gainers or losers.
GET
List biggest gainers and losers
Rows come back ordered by A different selection from
change_bp, biggest gainer first for direction=up and steepest drop
first for direction=down, paged by cursor exactly like List cards. Pass
expansion_id to rank inside one expansion instead of the whole catalog.
One row per card, and the printing depends on direction
A card can move differently on different printings. The gainers list names whichever printing rose most; the losers list, for the same card and the same window, names whichever printing fell most, and that can be a different printing entirely. A card whose holofoil rose while its reverse holofoil fell appears on both lists, each row naming the printing it is actually about. Read the printing off the row rather than assume the two lists agree on which piece of cardboard they mean.card_variant_id is what names it exactly: it matches an id in the card’s variants, from
Get a card or ?include=variants on List cards. printing is the
type axis alone, and one card can carry several printings that share a type, so matching on
that string can land on the wrong one.
What qualifies
A printing ranks only if at least three active listings sit behind its current price, and only if it was above a minimum price at the start of the window. A price a single seller set moves when that seller lists or sells, not when the market does, so a printing priced that thinly is absent from both lists rather than at the top of one. Readlisting_count on any printing from Get a card to see how many listings its
current price is computed from. A card can therefore be absent here while still carrying prices.
Telling a held price from a stale one
Prices are stored as a change log, so a printing that has not moved has no row on most days.start_cents for a window is carried forward from the last day it was actually observed, and
start_as_of is that day. When start_as_of sits well before the window’s start, change_bp is
measured against a carried value rather than a fresh sighting: a card untouched for two months can
still surface here, at a real percentage computed against an old price. Compare start_as_of to
the window to tell “held steady” from “not seen in a while.”
A different selection from include=change
?include=change on List cards and Get a card reports change data
for a card too, but for a different printing: the one the card’s displayed price is read from, not
necessarily the one that moved most. A card can lead this leaderboard on one printing’s percentage
while its include=change figure, drawn from another, reads something smaller, or even moves the
other way. See Change on the card object.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
The period to measure over.
Available options:
1d, 7d, 30d up for biggest gainers, down for biggest losers.
Available options:
up, down Narrow the list to one expansion. An id that matches nothing is an empty page, not a 404.
How many rows to return. Defaults to 50 and stops at 200; a larger value is clamped, not rejected.
Required range:
1 <= x <= 200The next_cursor from the previous page. Omit it for the first page. A cursor this endpoint did not issue is ignored, and you get the first page back.