---
title: "Get Total Sales Count by Player"
method: POST
path: "/v1/cards/total-sales-by-player"
tags: ["Market Data"]
---

# Get Total Sales Count by Player

`POST /v1/cards/total-sales-by-player`

## Request

- Base URL: `https://api.cardhedger.com`
- URL: `https://api.cardhedger.com/v1/cards/total-sales-by-player`
- Auth: API key in header `X-API-Key`

Get total sales counts per player/character over a recent window.

Counts sales records from the last N days that mention each player or
character name. Returns only the counts — no individual sale records —
so it stays fast even for high-volume players.

**Parameters:**
- `players`: List of player/character names (max 25)
- `days`: Look-back window in days (default: 30, max: 365)

## Request body

- TotalSalesByPlayerRequest
  - `players` string[], required: List of player/character names to look up (max 25)
  - `days` integer: Number of days to look back (default: 30, max: 365)

## Response `200`

Successful Response

- TotalSalesByPlayerResponse
  - `results` PlayerSalesResult[], required
    - `player` string, required: Player/character name searched
    - `total_sales` integer, required: Total number of sales found
    - `search_time_ms` integer, required: Upstream search request time in ms
  - `days` integer, required: Number of days looked back

## 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.dev/cardhedger/apis/card-hedge-api/revisions/6de42f192a4d?raw)