---
title: "Prop history"
method: POST
path: "/v1/get_prop_history"
tags: ["Multi-table"]
---

# Prop history

`POST /v1/get_prop_history`

## Request

- Base URL: `https://mcp.dunkapi.com`
- URL: `https://mcp.dunkapi.com/v1/get_prop_history`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Use to see how a player did against his prop line over time: for one market (points, rebounds, assists, threes, points + rebounds + assists, blocks or steals), one row per game with the closing line (the median across books, or one book's), the opening line (the same as the close wherever only one capture was taken), the prices, what the player actually recorded from our box scores and the result against the line, plus the over rate. Costs 10 credits for up to 200 games. Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

## Request body

- object
  - `player_id` string, required: Player id (e.g. 3945274) from search_players.
  - `market` 'player_points' | 'player_rebounds' | 'player_assists' | 'player_threes' | 'player_points_rebounds_assists' | 'player_blocks' | 'player_steals', required: The market: player_points (points), player_rebounds (rebounds), player_assists (assists), player_threes (three-pointers made), player_points_rebounds_assists (points + rebounds + assists), player_blocks (blocks), player_steals (steals)
  - `from_date` string: First date, YYYY-MM-DD (the game's date).
  - `to_date` string: Last date, YYYY-MM-DD (the game's date).
  - `bookmaker` string: One book's closing line instead of the median across books, e.g. draftkings.
  - `limit` integer: Games to return, oldest first (default 50, max 200). next_from_date says where to continue.
  - `league` 'nba' | 'wnba' | 'ncaam': League. Defaults to nba. One of: nba, wnba, ncaam.

## Response `200`

The result, wrapped in data.

- object
  - `data` object, required
    - `player_id` union, required
      - string
      - number
    - `player_name` string, nullable, required
    - `market` string, required
    - `stat` string, required
    - `bookmaker` string, nullable, required
    - `games` object[], required
      - `game_id` string, required
      - `game_date` string, nullable, required
      - `line` number, nullable, required
      - `open_line` number, nullable, required
      - `over_odds` number, nullable, required
      - `under_odds` number, nullable, required
      - `books` number, required
      - `actual` number, nullable, required
      - `result` 'over' | 'under' | 'push', nullable, required
      - `margin` number, nullable, required
    - `count` number, required
    - `summary` object, required
      - `games` number, required
      - `graded` number, required
      - `overs` number, required
      - `unders` number, required
      - `pushes` number, required
      - `over_rate` number, nullable, required
      - `avg_line` number, nullable, required
      - `avg_actual` number, nullable, required
    - `truncated` boolean
    - `next_from_date` string, nullable
    - `note` string
    - `estimate_only` boolean
    - `tool` string
    - `credits` number

## Other responses

- `400`: Invalid arguments.
- `401`: Missing or invalid API key.
- `402`: Not enough credits.
- `429`: Rate limited.

---

[API](https://skmtc.dev/dunkapi/apis/dunkapi-api.md) · [All operations](https://skmtc.dev/dunkapi/apis/dunkapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dunkapi/apis/dunkapi-api/revisions/9bf7a0add0eb?raw)