Event actions

Retrieve a list of all trading actions that have occurred on a specific event. Real money actions have user information anonymized.

Endpoint

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

Authentication

This endpoint supports optional HMAC authentication. Include the Key, Timestamp, and HMAC headers to access user-specific filters.

Request

integer

required

A unique integer value identifying this event.

boolean

default:"true"

When true, aggregates actions by order.

string

Filter by currency mode. One of play_money or real_money.

boolean

default:"false"

When true, returns only actions from users you follow.

boolean

default:"false"

When true, returns only your own actions.

string

Full-text search query. Maximum 100 characters.

Response

Returns a list of wager action objects.

Example

curl --request GET \
  --url "https://api.futuur.com/v2.0/events/42/actions/?currency_mode=play_money" \
  --header "Key: YOUR_PUBLIC_KEY" \
  --header "Timestamp: 1712534400" \
  --header "HMAC: YOUR_HMAC_SIGNATURE"

Sample response

[
  {
    "id": 1001,
    "user": "user_abc",
    "market": 101,
    "side": "bid",
    "shares": 10.0,
    "price": 0.52,
    "created_at": "2024-01-15T10:30:00Z"
  }
]

Events

Markets

Orders

Wagers

Account

Realtime (websockets)

Endpoint

Authentication

Request

Response

Example

​Endpoint

​Authentication

​Request

​Response

​Example

Endpoint

Authentication

Request

Response

Example