Skip to main content
Retrieve full details for a specific wager, including share count, cost basis, ROI, and resolution status. Public wagers are accessible without authentication.

​
Endpoint

GET https://api.futuur.com/wagers/{id}/

​
Authentication

Authentication is optional for this endpoint. Unauthenticated requests can retrieve public wager data. To access private wagers, include the Key, Timestamp, and HMAC headers.

​
Request

​
id
integer
required
The ID of the wager to retrieve.

​
Response

Returns a WagerDetail object. Fields match WagerList with the addition of actions.
​
id
integer
required
Unique wager ID.
​
status
string
required
Wager status: purchased, sold, won, lost, cancelled, or disabled.
​
status_display
string
required
Human-readable status label.
​
user
string
required
User resource reference (read-only).
​
event
string
required
Event resource reference (read-only).
​
market
string
required
Market resource reference (read-only).
​
position
string
required
Position direction: long (in favor of the outcome) or short (against).
​
position_display
string
required
Human-readable position label.
​
currency
string
Currency code for the wager (for example OOM, USDC).
​
shares
number
required
Consolidated shares held in this wager.
​
shares_in_canonical
number
required
Consolidated shares expressed in the event’s canonical currency.
​
total_amount
string
required
Total amount associated with the wager.
​
purchases_amount
number
Cost basis of the open position, adjusted for partial sales.
​
active_purchases_amount
string
required
Amount from active purchases on this wager.
​
active_purchases
Purchases from the last outcome bought in this event.
​
roi
string
required
Return on investment for the wager.
​
earnings
string
required
Earnings associated with the wager.
​
amount_on_win
string
required
Projected payout if the wager wins.
​
amount_on_sell
string
required
Amount available if the position is sold now.
​
last_profit
number
Last profit when the event resolved or the wager was sold. null if not applicable.
​
last_sell_amount
number
Last sale amount when the wager was sold. Always positive when set.
​
last_purchase
string
required
ISO 8601 datetime of the most recent purchase.
​
last_update
string
required
ISO 8601 datetime of the most recent wager update.
​
last_action
Serialized data about the most recent WagerAction on this wager.
​
actions_count
integer
Number of user-triggered actions (purchases, sales) on this wager.
​
actions
string
required
Serialized wager action history (read-only).

​
Example

curl --request GET \
  --url "https://api.futuur.com/wagers/88201/" \
  --header "Key: pk_live_abc123def456" \
  --header "Timestamp: 1712534400" \
  --header "HMAC: 3a9f2c1b...sha512signature"
Sample response
{
  "id": 88201,
  "status": "purchased",
  "status_display": "Purchased",
  "user": "https://api.futuur.com/users/5042/",
  "event": "https://api.futuur.com/events/901/",
  "market": "https://api.futuur.com/markets/3801/",
  "position": "long",
  "position_display": "Long",
  "currency": "USDC",
  "shares": 100.0,
  "shares_in_canonical": 100.0,
  "total_amount": "65.00",
  "purchases_amount": 65.0,
  "active_purchases_amount": "65.00",
  "roi": "10.00",
  "earnings": "6.50",
  "amount_on_win": "100.00",
  "amount_on_sell": "71.50",
  "last_profit": null,
  "last_sell_amount": null,
  "last_purchase": "2026-04-05T14:22:10Z",
  "last_update": "2026-04-07T08:15:44Z",
  "last_action": null,
  "actions_count": 1,
  "actions": "https://api.futuur.com/wagers/88201/actions/"
}