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.

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

​
active
boolean
When true, returns only active wagers with a status of purchased.
​
past_bets
boolean
When true, returns only inactive wagers — those that are sold, won, lost, or disabled.
​
event
integer
Filter wagers by event ID.
​
user
integer
Filter wagers by user ID.
​
following
boolean
When true, returns only wagers placed by users you follow.
​
currency_mode
string
Filter by currency mode: play_money, real_money, or an empty string to return all.
​
limit
integer
Number of results to return per page.
​
offset
integer
Pagination offset. Number of results to skip before returning results.

​
Response

Returns a paginated list of wager objects.
​
count
integer
required
Total number of wagers matching the query.
​
next
string
URL for the next page of results. null if there are no more pages.
​
previous
string
URL for the previous page of results. null if on the first page.
​
results
object[]
required
Array of wager objects.

​
Example

curl --request GET \
  --url "https://api.futuur.com/wagers/?active=true&currency_mode=real_money&limit=2" \
  --header "Key: pk_live_abc123def456" \
  --header "Timestamp: 1712534400" \
  --header "HMAC: 3a9f2c1b...sha512signature"
Sample response
{
  "count": 12,
  "next": "https://api.futuur.com/wagers/?active=true&currency_mode=real_money&limit=2&offset=2",
  "previous": null,
  "results": [
    {
      "id": 88201,
      "user": 5042,
      "market": 3801,
      "event": 901,
      "currency": "USDC",
      "shares": 100.0,
      "amount": 65.0,
      "avg_price": 0.65,
      "current_value": 71.50,
      "status": "purchased",
      "position": "l",
      "created_at": "2026-04-05T14:22:10Z"
    },
    {
      "id": 88195,
      "user": 5042,
      "market": 4112,
      "event": 920,
      "currency": "USDC",
      "shares": 50.0,
      "amount": 21.0,
      "avg_price": 0.42,
      "current_value": 19.00,
      "status": "purchased",
      "position": "l",
      "created_at": "2026-04-04T09:05:33Z"
    }
  ]
}