> ## 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.

# Event wagers

> List all wagers placed on a specific event, with optional filters for active status and currency mode.

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/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

<ParamField path="id" type="integer" required>
  The unique identifier of the event.
</ParamField>

<ParamField query="active" type="boolean">
  When `true`, returns only wagers that are currently active (open positions). When `false`, returns only inactive wagers.
</ParamField>

<ParamField query="currency_mode" type="string" default="play_money">
  Filter wagers by currency mode. Accepted values: `play_money`, `real_money`.
</ParamField>

<ParamField query="past_bets" type="boolean">
  When `true`, includes wagers that have already been settled or closed.
</ParamField>

## Response

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

<Expandable title="Wager properties">
  <ResponseField name="id" type="integer" required>
    Unique wager ID.
  </ResponseField>

  <ResponseField name="status" type="string" required>
    Wager status: `purchased`, `sold`, `won`, `lost`, `cancelled`, or `disabled`.
  </ResponseField>

  <ResponseField name="status_display" type="string" required>
    Human-readable status label.
  </ResponseField>

  <ResponseField name="market" type="string" required>
    Market resource reference (read-only).
  </ResponseField>

  <ResponseField name="position" type="string" required>
    Position direction: `long` or `short`.
  </ResponseField>

  <ResponseField name="position_display" type="string" required>
    Human-readable position label.
  </ResponseField>

  <ResponseField name="currency" type="string">
    Currency code for the wager.
  </ResponseField>

  <ResponseField name="shares" type="number" required>
    Consolidated shares held in this wager.
  </ResponseField>

  <ResponseField name="total_amount" type="string" required>
    Total amount associated with the wager.
  </ResponseField>

  <ResponseField name="purchases_amount" type="number">
    Cost basis of the open position.
  </ResponseField>

  <ResponseField name="roi" type="string" required>
    Return on investment for the wager.
  </ResponseField>

  <ResponseField name="last_purchase" type="string" required>
    ISO 8601 datetime of the most recent purchase.
  </ResponseField>

  <ResponseField name="last_update" type="string" required>
    ISO 8601 datetime of the most recent wager update.
  </ResponseField>
</Expandable>

## Example

```bash cURL theme={null}
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"
```

```json Sample response theme={null}
[
  {
    "id": 4401,
    "status": "purchased",
    "status_display": "Purchased",
    "user": "https://api.futuur.com/users/120/",
    "event": "https://api.futuur.com/events/1023/",
    "market": "https://api.futuur.com/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
  }
]
```