Betfair Exchange Streaming API

Name: Betfair Exchange Streaming API
Brand: Betfair Exchange Streaming API
Availability: InStock

✓ Official Vendor SpecData EnrichmentData Transformationnone1 EndpointsREST

For Agents

Install Jentic One Beta

Connect the Betfair Exchange Streaming API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Betfair Exchange Streaming API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fbetfair.com%2Fbetfair" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fbetfair.com%2Fbetfair" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Betfair Exchange Streaming API.

Authenticate a streaming session against the Betfair Exchange using a session token and app key

Subscribe to live market change updates for selected market ids

Subscribe to order change updates scoped to a customer account

GET STARTED

Start building with Betfair Exchange Streaming API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Betfair Exchange Streaming API for, with concrete tasks.

★ Low-Latency Odds Feed

Power a trading dashboard with live Betfair Exchange prices by subscribing to market change messages over the streaming socket. The single /request endpoint accepts an authentication op followed by a marketSubscription op listing market ids of interest, and the server pushes snapshots and deltas back as CRLF-delimited JSON. Building a stable client with reconnect and resubscribe logic is typically 2 to 3 days of work.

POST /request with op=authentication and the session token, then POST /request with op=marketSubscription and the target market ids, and parse incoming change messages

Real-Time Order Monitoring

Monitor placed orders on the Betfair Exchange without polling the REST betting API by subscribing to order change messages. The orderSubscription op streams matched, unmatched, and cancelled state transitions for the authenticated account. A risk system can react in under a second with this feed where REST polling would lag by several seconds.

POST /request with op=authentication, then POST /request with op=orderSubscription and emit each order change message to a downstream risk topic

Connection Health Heartbeats

Keep a long-lived Betfair streaming connection alive and detect disconnects quickly by exchanging heartbeat messages. The heartbeat op is sent at a configurable interval and the server replies with the current connection clock, allowing the client to trigger a reconnect if responses lapse. Heartbeat handling is a small but essential part of any production integration.

POST /request with op=heartbeat every 5 seconds and trigger a full reconnect if no heartbeat response arrives within 10 seconds

AI Agent for Live Markets

An AI agent uses Jentic to discover the streaming subscription operation and start a market feed without learning the protocol details by hand. The agent calls /request with the appropriate op envelope to authenticate and subscribe, and Jentic stores the Betfair app key and session token securely. Through Jentic, an agent can be streaming market data within an hour of starting integration work.

Search Jentic for 'subscribe to betfair markets' and execute the returned /request operation with op=marketSubscription to start a feed for the target event

Key Endpoints

1 endpoints — the betfair exchange streaming api provides a long-lived ssl socket connection delivering crlf-delimited json messages for live market and order updates from the betfair exchange.

METHOD

PATH

DESCRIPTION

POST

/request

Single dispatch endpoint for authentication, marketSubscription, orderSubscription, and heartbeat operations discriminated by the op field

POST

/request

Single dispatch endpoint for authentication, marketSubscription, orderSubscription, and heartbeat operations discriminated by the op field

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the Betfair Exchange Streaming API by hand means opening the streaming connection, injecting your app key and session token into the in-protocol authentication message, and framing every subscription request yourself. Through Jentic you install once, import the Betfair Exchange Streaming API from the API Directory, store the credentials once, and your agent calls it.

Permission scoping

Betfair Streaming exposes a single /request endpoint whose action is chosen in the message envelope rather than as a resource in the URL path, so scope the agent to the operations it needs, such as subscribing to market updates. You choose that operation set, and order subscription is not included unless you add it.

Credential isolation

Your Betfair app key and session token are stored once, encrypted, by your own Jentic One instance and injected into the in-protocol authentication message at execution time. They never enter the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'subscribe to Betfair markets', and Jentic returns the /request operation with its message envelope schema so the agent calls the right operation without learning the streaming protocol from the sample code.

FAQs

Specific to using Betfair Exchange Streaming API through Jentic.

What authentication does the Betfair Exchange Streaming API use?

The streaming API authenticates via an in-protocol authentication message that carries a Betfair session token and an application key. The OpenAPI spec does not declare a securityScheme because credentials are sent in the body of the first /request message rather than as HTTP headers. When called via Jentic, both values are stored encrypted in your Jentic One instance and injected into the auth message at execution time.

How many endpoints does the Betfair Streaming API have?

The streaming API exposes a single HTTP-style endpoint, POST /request, which carries every protocol operation. Different operations such as authentication, marketSubscription, orderSubscription, and heartbeat are selected via the op discriminator in the request body.

Can I receive live order updates without polling?

Yes. Send /request with op=orderSubscription after authentication and the server will push order change messages for matched, unmatched, and cancelled state transitions over the open socket. This is significantly faster than polling the REST listCurrentOrders operation on the betting API.

How do I start a Betfair market stream through Jentic?

Run pip install jentic and search for 'subscribe to betfair market'. Jentic returns the /request operation, the agent loads the message schema, and executes first with op=authentication and then with op=marketSubscription specifying market ids. Subsequent change messages arrive on the same connection.

What rate limits apply to the streaming API?

The streaming socket itself does not impose a per-message rate limit, but Betfair caps the number of concurrent streaming connections per app key and the breadth of market subscriptions. Consult the Betfair developer programme for the limits applicable to your app key tier before scaling fan-out.

Can I connect to the streaming API over plain HTTP?

No. While the spec lists a stream-api.betfair.com URL on port 443, production traffic must run over the SSL socket connection - the protocol is CRLF-delimited JSON over TLS, not an HTTP REST exchange. Treat the OpenAPI spec as a model of the message envelopes rather than as a conventional REST contract.

Can I limit what my agent is allowed to do with the Betfair Exchange Streaming API?

Yes. Because Jentic One is self-hosted, you run it and your own rules decide which operations and credentials your agent may use. The Betfair Exchange Streaming API dispatches every action through a single /request endpoint where the op field selects the operation, so you scope the agent to only the operations it needs, such as authentication and marketSubscription for reading live market updates. If you do not grant it, orderSubscription is left out, so an agent set up to read market prices cannot subscribe to your account's order changes or send arbitrary requests.