---
title: "Get Top Movers (Weekly Price Gainers)"
method: GET
path: "/v1/cards/top-movers"
tags: ["Market Data"]
---

# Get Top Movers (Weekly Price Gainers)

`GET /v1/cards/top-movers`

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:**
```bash
# 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.

## Query parameters

- `count` integer — Number of cards to return
- `category` string, nullable — Optional category filter (e.g., 'Baseball', 'Basketball', 'Pokemon')

## Response `200`

Successful Response

- TopMoversResponse — Response model for top movers endpoint.
  - `cards` TopMoverCard[], required — List of top moving cards
    - `description` string, required — Full card description
    - `player` string, required — Player or character name
    - `set` string, required — Card set name
    - `number` string, required — Card number in set
    - `variant` string, required — Card variant (e.g., 'Reverse Foil')
    - `card_id` string, required — Unique card identifier
    - `image` string, required — Card image URL
    - `category` string, required — Card category
    - `category_group` string, required — Category group
    - `set_type` string, required — Set type
    - `7 Day Sales` integer, required — Sales in last 7 days
    - `30 Day Sales` integer, required — Sales in last 30 days
    - `rookie` boolean, required — Whether the card is a rookie card
    - `gain` number, required — Percentage gain
    - `prices` CardPrice[], required — Price information at different grades
      - `grade` string, required — Card grade (e.g., 'Raw', 'PSA 10')
      - `price` string, required — Price in string format
  - `total_count` integer, required — Total number of cards returned
  - `filtered_count` integer, required — Number of cards after filtering
  - `gain_threshold` number, required — Minimum gain percentage used for filtering (default: 500%)

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/cardhedger/apis/card-hedge-api.md) · [All operations](https://skmtc.dev/cardhedger/apis/card-hedge-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cardhedger/card-hedge-api/revisions/f2d0e595be79/schema)