STAT-API

DFS contest_payout_shapes API

contest_payout_shapesdfs.contest_payout_shapes
One row per contest with a ladder: paid places, cash vs ticket totals, top prize, min-cash, and the ratios contest selection needs. Rake is not here — it needs entries at lock, from contest_snapshots.
Full field reference (11 columns) → Data DictionaryQuery in GraphQL →
GET/api/v1/dfs/contest_payout_shapes
Requires one of: contest_id — requests satisfying none of these return 400.
Parameters
contest_idquerybigintoptional
The shape of one contest.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return rows with id strictly greater than this value; page using the previous response's `next_from_id`. Omit on the first page.
Restores the documented defaults (trial keys only accept the unchanged defaults).
Request
curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/dfs/contest_payout_shapes?contest_id=37021368'
Responses
200contest_payout_shapes rows matching the declared filter set, wrapped in { contest_payout_shapes, limit, next_from_id }. next_from_id is the last row's id on a full page — pass it back via ?from_id= to walk the full result; null marks the terminal page.application/jsonshow example ▸
400No declared filter set was satisfied — response body matches MissingRequiredFiltersError; pick one combo from the accepted-sets hint and resend.application/json
Response Schema(11 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
contest_id
bigintFK to the contest. Also the row id.
e.g. 14086
cash_line
decimal—paid_places / max_entries.
e.g. 0.0085
cash_total
integer—Total cash prizes in cents (e.g. 10000000 = $100,000.00).
e.g. 0
min_cash
integer—Amount awarded on the last paying tier in cents (e.g. 1000 = $10.00).
e.g. 2500
min_cash_multiple
decimal—min_cash / entry_fee. 2.0 on a double-up.
e.g. 2.0000
paid_places
integer—max(max_position) — the number of paying positions.
e.g. 1
ticket_total
integer—Total ticket face value in cents.
e.g. 0
tier_count
integer—Number of tiers in the ladder.
e.g. 1
top_prize
integer—First place prize in cents (e.g. 2000000 = $20,000.00).
e.g. 2500
top_prize_share
decimal—top_prize / (cash_total + ticket_total).
e.g. 1.0000
GET/api/v1/dfs/contest_payout_shapes/{id}
Parameters
idpathbigintrequired
Primary key (id) of the contest_payout_shape row.
Restores the documented defaults (trial keys only accept the unchanged defaults).
Request
curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/dfs/contest_payout_shapes/37021368'
Responses
200Single contest_payout_shape row.application/jsonshow example ▸
404Row not found.
Response Schema(11 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
contest_id
bigintFK to the contest. Also the row id.
e.g. 14086
cash_line
decimal—paid_places / max_entries.
e.g. 0.0085
cash_total
integer—Total cash prizes in cents (e.g. 10000000 = $100,000.00).
e.g. 0
min_cash
integer—Amount awarded on the last paying tier in cents (e.g. 1000 = $10.00).
e.g. 2500
min_cash_multiple
decimal—min_cash / entry_fee. 2.0 on a double-up.
e.g. 2.0000
paid_places
integer—max(max_position) — the number of paying positions.
e.g. 1
ticket_total
integer—Total ticket face value in cents.
e.g. 0
tier_count
integer—Number of tiers in the ladder.
e.g. 1
top_prize
integer—First place prize in cents (e.g. 2000000 = $20,000.00).
e.g. 2500
top_prize_share
decimal—top_prize / (cash_total + ticket_total).
e.g. 1.0000