Overview

Futuur uses Pusher to deliver realtime data to clients over WebSocket connections. Use the global event channel for market-wide feeds, event-{event_id} for per-event BBO and order-book updates, and private channels for account-specific order and position updates. Terminology: event = a question; market = an outcome.

Examples below use https://api.futuur.com/v2.0. Private channel authorization calls POST https://api.futuur.com/v2.0/pusher/auth/. See Authentication for HMAC signing and Authorization for private channel setup.

Client setup

Include the Pusher JS client:

<script src="https://js.pusher.com/8.4.0/pusher.min.js"></script>

Initialize Pusher and subscribe to a channel:

<script>
    Pusher.logToConsole = true; // omit in production

    var pusher = new Pusher("9011f7eac38e825792d5", {
        cluster: "us2",
    });

    var channel = pusher.subscribe("event");
    channel.bind("best-prices-change", function (data) {
        console.log("Best prices changed:", data);
    });
</script>

Next steps

Authorization — authorize private user channels with HMAC
Channels and events — full channel and event catalog with payloads

Order book — REST endpoint for full depth beyond top-N
Reading the order book — interpret bid/ask depth
Authentication — HMAC signing for private channel auth

AuthorizationAuthorize private Pusher channels with HMAC-signed requests to the Futuur auth endpoint.

Events

Markets

Orders

Wagers

Account

Realtime (websockets)

Client setup

Next steps

​Client setup

​Next steps

​Related

Client setup

Next steps

Related