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.
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 KeyYour public API key TimestampCurrent Unix timestamp HMACSHA-512 signature of the request payload
Parameters The unique identifier of the event.
Filter actions by currency mode. Accepted values: play_money, real_money. Leave empty to return actions for both modes.
When true, returns only actions from users you follow.
When true, returns only your own betting actions.
Full-text search query to filter actions. Maximum 100 characters.
Response Array of wager action objects. Unique identifier for the action.
Type of action performed (e.g., buy, sell).
ID of the market on which the action was taken.
ID of the outcome targeted by this action.
Number of shares involved in the action.
Currency amount of the action.
Price per share at the time of the action (0–1).
Currency mode of the action: play_money or real_money.
Information about the user who performed the action. For real money actions, identifying fields are anonymized. User ID. May be anonymized for real money actions.
Username. Anonymized for real money actions.
ISO 8601 timestamp of when the action occurred.
Example 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"
{ "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" } ] }
