Documentation Index
Fetch the complete documentation index at: https://docs.futuur.com/llms.txt
Use this file to discover all available pages before exploring further.
Retrieve all wagers associated with an event. Filter to active positions, past bets, or a specific currency mode to narrow the results.
Endpoint
GET https://api.futuur.com/events/{id}/wagers/
Authentication
HMAC authentication is required. Include the following headers with every request:
| Header | Description |
|---|
Key | Your public API key |
Timestamp | Current Unix timestamp |
HMAC | SHA-512 signature of the request payload |
Parameters
The unique identifier of the event.
When true, returns only wagers that are currently active (open positions). When false, returns only inactive wagers.
currency_mode
string
default:"play_money"
Filter wagers by currency mode. Accepted values: play_money, real_money.
When true, includes wagers that have already been settled or closed.
Response
Array of wager objects.
Unique identifier for the wager.
ID of the market on which the wager was placed.
ID of the outcome the wager is placed on.
Display name of the outcome.
Number of shares held in this wager.
Total currency amount spent to acquire this position.
Average price per share paid across all fills (0–1).
Current mark-to-market value of the position.
Currency mode of the wager: play_money or real_money.
Whether the wager is currently an open position.
Whether the wager has been settled after event resolution.
Amount paid out upon settlement. null if the wager has not been settled.
ISO 8601 timestamp of when the wager was first created.
ISO 8601 timestamp of the most recent update to this wager.
Example
curl --request GET \
--url "https://api.futuur.com/events/1023/wagers/?currency_mode=play_money&active=true" \
--header "Key: YOUR_PUBLIC_KEY" \
--header "Timestamp: 1712500000" \
--header "HMAC: YOUR_HMAC_SIGNATURE"
{
"results": [
{
"id": 4401,
"market": 501,
"outcome": 1,
"outcome_name": "Yes",
"shares": 50.0,
"amount_spent": 31.0,
"average_price": 0.62,
"current_value": 33.5,
"currency_mode": "play_money",
"active": true,
"settled": false,
"payout": null,
"created_at": "2026-03-15T14:22:10Z",
"updated_at": "2026-03-15T14:22:10Z"
}
]
}
