Market Data

Get Top Movers (Weekly Price Gainers)

Get the cards with the largest price gains over the past week.

Gains of 500% or more are filtered out as likely data errors, so results reflect realistic market movement. Results are cached for 1 hour.

Example curl:

# All categories
curl -H "X-API-Key: your-api-key-here" \
     "https://api.cardhedger.com/v1/cards/top-movers?count=20"

# Baseball only
curl -H "X-API-Key: your-api-key-here" \
     "https://api.cardhedger.com/v1/cards/top-movers?count=20&category=Baseball"

Returns cards with realistic price increases (< 500% gain), limited to requested count.

get/v1/cards/top-movers

Request

Base URL
https://api.cardhedger.com
Auth
API key in header X-API-Key

Query parameters

countinteger

Number of cards to return

categorystring nullable

Optional category filter (e.g., 'Baseball', 'Basketball', 'Pokemon')

Response

Successful Response

total_countinteger required

Total number of cards returned

filtered_countinteger required

Number of cards after filtering

gain_thresholdnumber required

Minimum gain percentage used for filtering (default: 500%)

Example response

{
  "cards": [
    {
      "30 Day Sales": 45,
      "7 Day Sales": 12,
      "card_id": "1587446850514x224832321163624450",
      "category": "Baseball",
      "category_group": "Sports Cards",
      "description": "Shohei Ohtani 2018 Topps Chrome Baseball",
      "gain": 650.5,
      "image": "//s3.amazonaws.com/appforest_uf/example.jpg",
      "number": "150",
      "player": "Shohei Ohtani",
      "prices": [
        {
          "grade": "PSA 10",
          "price": "2500"
        },
        {
          "grade": "PSA 9",
          "price": "850"
        }
      ],
      "rookie": true,
      "set": "2018 Topps Chrome Baseball",
      "set_type": "Topps Chrome Baseball",
      "variant": "Refractor"
    }
  ],
  "filtered_count": 1,
  "gain_threshold": 500,
  "total_count": 50
}

Changes

No recorded changes to this operation across all 14 revisions of this API.