Event wagers

Retrieve all wagers associated with an event. Filter to active positions, past bets, or a specific currency mode to narrow the results. This endpoint returns a non-paginated array of WagerList objects.

Endpoint

GET https://api.futuur.com/v2.0/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

integer

required

The unique identifier of the event.

boolean

When true, returns only wagers that are currently active (open positions). When false, returns only inactive wagers.

string

default:"play_money"

Filter wagers by currency mode. Accepted values: play_money, real_money.

boolean

When true, includes wagers that have already been settled or closed.

Response

Returns a JSON array of WagerList objects (no pagination wrapper). Each element includes:

Show Wager properties

integer

required

Unique wager ID.

string

required

Wager status: purchased, sold, won, lost, cancelled, or disabled.

string

required

Human-readable status label.

string

required

Market resource reference (read-only).

string

required

Position direction: long or short.

string

required

Human-readable position label.

string

Currency code for the wager.

number

required

Consolidated shares held in this wager.

string

required

Total amount associated with the wager.

number

Cost basis of the open position.

string

required

Return on investment for the wager.

string

required

ISO 8601 datetime of the most recent purchase.

string

required

ISO 8601 datetime of the most recent wager update.

Example

cURL

curl --request GET \
  --url "https://api.futuur.com/v2.0/events/1023/wagers/?currency_mode=play_money&active=true" \
  --header "Key: YOUR_PUBLIC_KEY" \
  --header "Timestamp: 1712500000" \
  --header "HMAC: YOUR_HMAC_SIGNATURE"

Sample response

[
  {
    "id": 4401,
    "status": "purchased",
    "status_display": "Purchased",
    "user": "https://api.futuur.com/v2.0/users/120/",
    "event": "https://api.futuur.com/v2.0/events/1023/",
    "market": "https://api.futuur.com/v2.0/markets/501/",
    "position": "long",
    "position_display": "Long",
    "currency": "OOM",
    "shares": 50.0,
    "shares_in_canonical": 50.0,
    "total_amount": "31.00",
    "purchases_amount": 31.0,
    "active_purchases_amount": "31.00",
    "roi": "8.06",
    "earnings": "2.50",
    "amount_on_win": "50.00",
    "amount_on_sell": "33.50",
    "last_profit": null,
    "last_purchase": "2026-03-15T14:22:10Z",
    "last_update": "2026-03-15T14:22:10Z",
    "actions_count": 1
  }
]

Events

Markets

Orders

Wagers

Account

Realtime (websockets)

Endpoint

Authentication

Parameters

Response

Example

​Endpoint

​Authentication

​Parameters

​Response

​Example

Endpoint

Authentication

Parameters

Response

Example