Data · Exchange data
Exchange data API: markets, back/lay prices and settlement
Exchange data is the file for a two-sided market: back prices, lay prices, whether the market is open, suspended or settled, and the result that closes it. An empty lay is not a price of zero, and liability on a lay is not the stake.
Markets, back and lay prices, and settlement
Betfair's own Exchange API is a separate product owned by Betfair. This page does not describe it.
Each market needs a state: open, suspended, closed, settled, void. A price without a state will be bet on after the market should have stopped. Back and lay are separate prices, and either side can be empty. An empty lay is not a zero price. Your client has to show 'no price' rather than inventing one. Matched volume, if the product publishes it, is information about that market, not a promise you will be matched for the stake the player typed. Settlement is a later record, and a correction has to replace the result you paid on.
Liability on a lay is not the stake. The wallet reserves the amount the layer can lose. The Diamond exchange page describes how that reservation works on our product. If you are comparing suppliers, ask whether prices are their own matching engine, a reference to prices seen elsewhere, or a mix. The answer changes your risk and your marketing. It does not, in our case, create a connection to Betfair. That boundary is on the Betfair page. How that two-sided bet differs from a fixed price is the exchange versus fixed-odds comparison.
Cricket exchange markets add fancy and session lines that do not exist on a football 1X2. Those lines have their own void rules, covered alongside the cricket data page. Do not force them into a football market schema.
Unmatched orders and a blank side of the book
Matched volume describes trades that have already happened. Keep an unmatched order cancellable, and reserve lay liability when the lay matches. Locking the full liability before a match freezes money the player has not risked.
Persist a missing back or a missing lay as an empty side. Fancy and session voids, when an over is not completed, are specified on the cricket data page. This file carries market state, the two prices, and liability.
Market state, the screen, and the wallet
| State | What the client shows | What the wallet may do |
|---|---|---|
| Open | Back and lay, with a blank where a side has no price | Reserve lay liability once the lay matches |
| Suspended | The last numbers, with new bets blocked | Refuse a fresh reservation |
| Settled | The result that closed the market | Release the reservation or consume it |
| Void | Void, without a winner you made up | Release the reservation with no profit and no loss |
Questions for any exchange feed
- 01
State on every price
Reject a price update that does not say whether the market is open or suspended.
- 02
Empty is empty
Render a missing lay as no price. Do not coerce it to zero.
- 03
Source of the price
Ask whether the number is matched on this product or only observed elsewhere.
Our exchange product is Diamond
Exchange-style betting offered by Turnkeyxgaming is the Diamond exchange, for operators licensed to provide it. This page does not describe a third party's exchange API.
A worked trade, and where the wallet differs from a fixed-odds slip
A player backs an outcome at 3.0 with 200. Later the same outcome's lay price shortens to 2.0 and the player lays 300 against it. If the outcome wins, the back profits 400 and the lay costs 300 of liability: 100 up. If it loses, the lay keeps 300 and the back costs 200: still 100 up. The position is green either way, which is the point of trading out, and it is only possible because the product stores two prices and two exposure figures rather than one stake against one price.
That is also why the wallet work differs from a sportsbook integration. The lay reserves liability, not the stake, and the reservation releases when the market settles or voids. The lay liability guide covers the ledger detail, and the exchange versus fixed-odds comparison shows the same bet from the book's side of the price.
Questions that separate real exchange products from marketing
- Where prices come from: your own matching engine, prices observed elsewhere, or a blend. Exchange as a noun is not an answer.
- Whether matched volume means matched on this product, and what happens to a stake left unmatched at suspension.
- The in-play stance: whether exchange markets suspend on events, and whether a bet delay applies in play. No delay at all is a statement about who the product is for.
- Commission: charged on net market winnings, on turnover, or not at all, and who configures it.
- Cross-matching: whether exposure on one runner can net against another, and how that appears in the player's history.
- Which markets exist beyond cricket match odds, and whether fancy lines carry exchange-style liability or bookmaker-style fixed liability.
Unmatched, matched, cancelled, voided: what each does to the money
| Order state | Money reserved | Player sees | Ledger entry |
|---|---|---|---|
| Unmatched back | The stake, held | The order, with the price it wanted | Reservation against balance |
| Unmatched lay | The liability, held, which is larger than the stake | The order and the exposure, not just the stake | Reservation against balance |
| Matched | The stake commits on a back; on a lay the liability consumes the reservation | A matched bet with a bet id | Commit, with the reservation released |
| Cancelled before a match | Reservation released in full | The cancellation, with the balance back | Reversal of the reservation |
| Voided after settlement | Stake or liability returned | The void reason, beside the market | Rollback of the settlement |
FAQ
Questions operators ask
Does the exchange feed include casino games?
No. Casino titles that often sit beside an exchange, including Diamond casino games, are a separate catalogue on the same wallet.
Is this file Betfair's Exchange API?
It is a different product. Betfair's API is obtained from Betfair and explained on the Betfair page. This page is exchange-style market data, including Diamond where that is the contract.
When is lay liability reserved?
When the lay matches, for the amount the layer can lose. The backer's stake is a different figure. An unmatched order stays cancellable and should not lock that liability early.
Do exchange bets pay out faster or slower than sportsbook bets?
Neither, as a rule: both settle from the market's result. The difference is the ledger work in between, meaning reservations, releases and commission on net winnings, which is more work than one stake against one price.
What stops a player from laying with money they do not have?
The reservation. A lay cannot be placed unless the balance covers the liability, and that liability is held from placement, matched or not. An empty balance lays nothing.
Can we display the exchange book depth, not just the best price?
Where the feed publishes it, yes. Matched volume and price levels are display data. Depth is not a promise that a player's stake will match at that level, which your copy should say.
Keep reading
Related pages
- Product · ExchangeDiamond exchangeBack and lay on cricket match odds, bookmaker and fancy markets, with lay liability reserved on the same wallet. Not the card games.Read
- Data · Betfair's own APIBetfair's own APIBetfair's Exchange API belongs to Betfair. Turnkeyxgaming is not affiliated, does not resell it, and explains what that means here.Read
- Data · Cricket dataCricket dataCricket fixtures, markets, scores and results, including the ball-by-ball facts used to settle fancy and session markets correctly.Read
- Product · Sports dataSports dataFixtures, pre-match and live odds, scores and results for operators who build their own sportsbook front end and settle bets themselves.Read
Get a written quote and sandbox access
Tell us your licence, target markets and products. You get the GGR rate in writing, the studio list for your markets and sandbox credentials.