Event actions - Futuur API

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

integer

required

The unique identifier of the event.

aggregate_by_orders

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.

currency_mode

string

Filter actions by currency mode. Accepted values: play_money, real_money. Leave empty to return actions for both modes.

following

boolean

default:"false"

When true, returns only actions from users you follow.

my_bets

boolean

default:"false"

When true, returns only your own betting actions.

string

Full-text search query to filter actions. Maximum 100 characters.

Response

results

object[]

required

Array of wager action objects.

Show properties

integer

Unique identifier for the action.

action_type

string

Type of action performed (e.g., buy, sell).

market

integer

ID of the market on which the action was taken.

outcome

integer

ID of the outcome targeted by this action.

number

Number of shares involved in the action.

amount

number

Currency amount of the action.

price

number

Price per share at the time of the action (0–1).

currency_mode

string

Currency mode of the action: play_money or real_money.

user

object

Information about the user who performed the action. For real money actions, identifying fields are anonymized.

Show properties

integer

User ID. May be anonymized for real money actions.

username

string

Username. Anonymized for real money actions.

created_at

string

ISO 8601 timestamp of when the action occurred.

Example

cURL

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"

Sample response

{
  "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"
    }
  ]
}

​Endpoint

​Authentication

​Parameters

​Response

​Example

Endpoint

Authentication

Parameters

Response

Example