Market Data

Get All Sales Trends (Daily/Weekly/Monthly)

Changed on

Return all indexed sales, including matched and unmatched sales, using the same calendar buckets and bucket fields as sales-stats-by-player, without a player or category filter. Each bucket includes transaction count, total_amount (USD), average_sale (USD), inclusive UTC start/end dates, and partial. Totals describe Card Hedge's indexed sales coverage; a transaction is one indexed sale record. Amounts are rounded to two decimals; indexed price precision can produce small differences from source totals.

interval is day, week, or month (default week); periods defaults to 12. Days use midnight-to-midnight UTC, ISO weeks run Monday–Sunday, and months follow calendar boundaries. Caps match player trends: day ≤ 90, week ≤ 52, month ≤ 24. Buckets run oldest to newest, with empty periods filled with zeros.

include_current defaults to false: the newest bucket ends yesterday UTC (T-1), last Sunday, or the last day of the previous month. Explicitly set true to include the in-progress period within the requested number of buckets.

Only completed buckets are cached, for 24 hours. Partial buckets bypass cache reads and writes. Late-arriving sales and corrections may take up to the cache TTL to appear after indexing. Category labels are not required.

post/v1/cards/sales-stats

Request

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

Request body

interval'day' | 'week' | 'month'

UTC calendar day, ISO week (Monday–Sunday), or calendar month.

periodsinteger

Number of buckets. Caps: day ≤ 90, week ≤ 52, month ≤ 24.

include_currentboolean

Default false returns completed periods ending yesterday, last week, or last month. True includes the current uncached partial period within the requested number of buckets.

Response

Successful Response

scope'all_sales'
currency'USD'
interval'day' | 'week' | 'month' required
periodsinteger required

Number of buckets returned.

Changes