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

> Retrieve the bet activity feed for a specific event. User information is anonymized for real money actions.

List all betting actions (wager activity) associated with an event. For real money events, user-identifying information is anonymized in the response. You can filter the feed to show only your own bets or bets from users you follow.

## Endpoint

```
GET https://api.futuur.com/events/{id}/actions/
```

## 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="aggregate_by_orders" type="boolean" default="true">
  When `true`, multiple wager actions resulting from the same originating order are collapsed into a single action entry. Set to `false` to receive every underlying action separately.
</ParamField>

<ParamField query="currency_mode" type="string">
  Filter actions by currency mode. Accepted values: `play_money`, `real_money`. Leave empty to return actions for both modes.
</ParamField>

<ParamField query="following" type="boolean" default="false">
  When `true`, returns only actions from users you follow.
</ParamField>

<ParamField query="my_bets" type="boolean" default="false">
  When `true`, returns only your own betting actions.
</ParamField>

<ParamField query="search" type="string">
  Full-text search query to filter actions. Maximum 100 characters.
</ParamField>

## Response

<ResponseField name="results" type="object[]" required>
  Array of wager action objects.

  <Expandable title="properties">
    <ResponseField name="id" type="integer">
      Unique identifier for the action.
    </ResponseField>

    <ResponseField name="action_type" type="string">
      Type of action performed (e.g., `buy`, `sell`).
    </ResponseField>

    <ResponseField name="market" type="integer">
      ID of the market on which the action was taken.
    </ResponseField>

    <ResponseField name="outcome" type="integer">
      ID of the outcome targeted by this action.
    </ResponseField>

    <ResponseField name="shares" type="number">
      Number of shares involved in the action.
    </ResponseField>

    <ResponseField name="amount" type="number">
      Currency amount of the action.
    </ResponseField>

    <ResponseField name="price" type="number">
      Price per share at the time of the action (0–1).
    </ResponseField>

    <ResponseField name="currency_mode" type="string">
      Currency mode of the action: `play_money` or `real_money`.
    </ResponseField>

    <ResponseField name="user" type="object">
      Information about the user who performed the action. For real money actions, identifying fields are anonymized.

      <Expandable title="properties">
        <ResponseField name="id" type="integer">
          User ID. May be anonymized for real money actions.
        </ResponseField>

        <ResponseField name="username" type="string">
          Username. Anonymized for real money actions.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of when the action occurred.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

```bash cURL theme={null}
curl --request GET \
  --url "https://api.futuur.com/events/1023/actions/?currency_mode=play_money&my_bets=false" \
  --header "Key: YOUR_PUBLIC_KEY" \
  --header "Timestamp: 1712500000" \
  --header "HMAC: YOUR_HMAC_SIGNATURE"
```

```json Sample response theme={null}
{
  "results": [
    {
      "id": 8801,
      "action_type": "buy",
      "market": 501,
      "outcome": 1,
      "shares": 50.0,
      "amount": 31.0,
      "price": 0.62,
      "currency_mode": "play_money",
      "user": {
        "id": 204,
        "username": "trader_jane"
      },
      "created_at": "2026-03-15T14:22:10Z"
    },
    {
      "id": 8802,
      "action_type": "sell",
      "market": 501,
      "outcome": 2,
      "shares": 20.0,
      "amount": 7.6,
      "price": 0.38,
      "currency_mode": "real_money",
      "user": {
        "id": null,
        "username": "anonymous"
      },
      "created_at": "2026-03-15T14:30:45Z"
    }
  ]
}
```