Skip to main content

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.

A wager represents a position you hold in a market. When an order fills (fully or partially), the resulting shares you own become a wager. You can think of a wager as a record of your stake in a particular outcome. Wagers are read-only — they are created automatically when orders execute, not by direct API calls.

​
How wagers relate to orders and events

  • One order can produce one or more wagers as it fills over time.
  • A wager is always linked to a specific market (outcome) within an event.
  • Multiple wagers on the same market are aggregated into your net position.

​
Wager statuses

StatusDescription
purchasedActive position — the event is still open or closed but unresolved
soldYou sold this position before the event resolved
wonThe event resolved and this outcome was correct — payout received
lostThe event resolved and this outcome was incorrect — stake forfeited
disabledThe wager has been administratively disabled
A purchased wager means your position is active. It will transition to won, lost, or sold once the event resolves or you sell your shares.

​
Fetching your wagers

Use GET /wagers/ to list wagers. You can also fetch wagers for a specific event via GET /events/{id}/wagers/.

​
Filtering wagers

The /wagers/ endpoint supports several filters:
FilterDescription
activeReturns only wagers with purchased status
past_betsReturns settled wagers (won, lost, sold)
eventFilter by event ID
followingWagers on events you follow
userFilter by user ID (for public wager history)
# Get your active positions
GET /wagers/?active=true

# Get settled wagers for a specific event
GET /wagers/?past_bets=true&event=123

​
Wager resolution

When an event resolves, the API automatically settles all wagers associated with it:
  • Wagers on the winning market transition to won. Any payout is credited to your account.
  • Wagers on losing markets transition to lost. The staked amount is not returned.
  • If you sold your position before resolution (via an ask order), the wager transitions to sold regardless of the outcome.
Use GET /events/{id}/wagers/ to retrieve wager history for a specific event across all users, useful for displaying market participation data in your application.