Retrieve a list of wagers. You can filter by active status, event, currency mode, or by bets placed by users you follow. Authenticated requests return your own wagers by default. Public wagers can also be accessed without authentication.
Endpoint GET https://api.futuur.com/wagers/
Authentication Authentication is optional for this endpoint. Unauthenticated requests can access public wager data. To access your own private wagers or filter by followed users, include the Key, Timestamp, and HMAC headers.
Request When true, returns only active wagers with a status of purchased.
When true, returns only inactive wagers — those that are sold, won, lost, cancelled, or disabled.
Filter wagers by event ID.
Filter wagers by user ID.
When true, returns only wagers placed by users you follow.
Filter by currency mode: play_money, real_money, or an empty string to return all.
Number of results to return per page.
Pagination offset. Number of results to skip before returning results.
Response Returns a paginated list of wager objects.
Pagination metadata for the result set. Total number of wagers matching the query.
URL for the next page of results. null if there are no more pages.
URL for the previous page of results. null if on the first page.
Number of results returned per page.
Current pagination offset.
Array of WagerList objects. Wager status: purchased, sold, won, lost, cancelled, or disabled.
Human-readable status label.
User resource reference (read-only).
Event resource reference (read-only).
Market resource reference (read-only).
Position direction: long (in favor of the outcome) or short (against).
Human-readable position label.
Currency code for the wager (for example OOM, USDC).
Consolidated shares held in this wager.
Consolidated shares expressed in the event’s canonical currency.
Total amount associated with the wager.
Cost basis of the open position, adjusted for partial sales.
Amount from active purchases on this wager.
Purchases from the last outcome bought in this event.
Return on investment for the wager.
Earnings associated with the wager.
Projected payout if the wager wins.
Amount available if the position is sold now.
Last profit when the event resolved or the wager was sold. null if not applicable.
Last sale amount when the wager was sold. Always positive when set.
ISO 8601 datetime of the most recent purchase.
ISO 8601 datetime of the most recent wager update.
Serialized data about the most recent WagerAction on this wager.
Number of user-triggered actions (purchases, sales) on this wager.
Example curl --request GET \ --url "https://api.futuur.com/wagers/?active=true¤cy_mode=real_money&limit=2" \ --header "Key: pk_live_abc123def456" \ --header "Timestamp: 1712534400" \ --header "HMAC: 3a9f2c1b...sha512signature"
{ "pagination" : { "total" : 12 , "next" : "https://api.futuur.com/wagers/?active=true¤cy_mode=real_money&limit=2&offset=2" , "previous" : null , "page_size" : 2 , "offset" : 0 }, "results" : [ { "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 } ] }
