CAcardhedger
Market Data

Get Player Index

Changed on

Latest cached player index: a market-cap-weighted average price (USD) of the player's top-10 cards, with 1d/7d/30d/90d/365d changes and the cards behind it.

Identify the player by player_id (recommended — from player-search) or by name (+ optional category). A name must match exactly one player, otherwise the response is 409 with candidates. Merged duplicate IDs resolve to their canonical player (resolution.resolved_via: "alias").

status is current (updated within PLAYER_INDEX_STALE_DAYS days, default 2), stale (older; still served — the API never triggers a recalculation), or withheld (at least PLAYER_INDEX_WITHHOLD_FOREIGN_PCT percent, default 25, of the index's weight comes from other players' cards; value is null and integrity.reason explains).

Example curl:

curl -X POST -H "X-API-Key: your-api-key-here"          -H "Content-Type: application/json"          -d '{"name":"Luka Doncic"}'          "https://api.cardhedger.com/v1/cards/player-index"
post/v1/cards/player-index

Request

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

Request body

player_idstring nullable

Card Hedge player ID (from player-search). Alias IDs resolve to their canonical player.

namestring nullable

Player name; resolves only when it matches exactly one player (else 409 with candidates).

categorystring nullable

With name only: one category (name or slug) to tell same-named players apart.

include_constituentsboolean

Include the cards behind the index

Response

Successful Response

Changes