Skip to main content
Retrieve full details for a specific wager, including share count, pricing, current value, 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 wager detail object.
​
id
integer
required
Unique wager ID.
​
user
integer
required
ID of the user who placed the wager.
​
market
integer
required
Market (outcome) ID the wager is placed on.
​
event
integer
required
Event ID associated with the wager.
​
currency
string
required
Currency used for the wager: USDC, USDT, USD, or OOM.
​
shares
number
required
Number of shares held.
​
amount
number
required
Total amount wagered in currency units.
​
avg_price
number
required
Average price per share at time of purchase, expressed as a probability between 0 and 1.
​
current_value
number
Current market value of the wager in currency units, based on the latest market price.
​
payout
number
Payout amount received if the wager was resolved as won. null for unresolved wagers.
​
status
string
required
Wager status: purchased, sold, won, lost, or disabled.
​
position
string
required
Position direction: l (long, betting for the outcome) or s (short, betting against).
​
currency_mode
string
required
Whether the wager uses play_money or real_money.
​
market_detail
object
Summary of the market this wager is placed on.
​
event_detail
object
Summary of the event this wager is associated with.
​
created_at
string
required
ISO 8601 datetime when the wager was created.
​
updated_at
string
required
ISO 8601 datetime when the wager was last updated.

​
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,
  "user": 5042,
  "market": 3801,
  "event": 901,
  "currency": "USDC",
  "shares": 100.0,
  "amount": 65.0,
  "avg_price": 0.65,
  "current_value": 71.50,
  "payout": null,
  "status": "purchased",
  "position": "l",
  "currency_mode": "real_money",
  "market_detail": {
    "id": 3801,
    "title": "Yes",
    "probability": 0.715
  },
  "event_detail": {
    "id": 901,
    "title": "Will the Federal Reserve cut rates before July 2026?",
    "closes_at": "2026-06-30T23:59:59Z"
  },
  "created_at": "2026-04-05T14:22:10Z",
  "updated_at": "2026-04-07T08:15:44Z"
}