Turnkeyxgaming

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

StateWhat the client showsWhat the wallet may do
OpenBack and lay, with a blank where a side has no priceReserve lay liability once the lay matches
SuspendedThe last numbers, with new bets blockedRefuse a fresh reservation
SettledThe result that closed the marketRelease the reservation or consume it
VoidVoid, without a winner you made upRelease the reservation with no profit and no loss

Questions for any exchange feed

  1. 01

    State on every price

    Reject a price update that does not say whether the market is open or suspended.

  2. 02

    Empty is empty

    Render a missing lay as no price. Do not coerce it to zero.

  3. 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 stateMoney reservedPlayer seesLedger entry
Unmatched backThe stake, heldThe order, with the price it wantedReservation against balance
Unmatched layThe liability, held, which is larger than the stakeThe order and the exposure, not just the stakeReservation against balance
MatchedThe stake commits on a back; on a lay the liability consumes the reservationA matched bet with a bet idCommit, with the reservation released
Cancelled before a matchReservation released in fullThe cancellation, with the balance backReversal of the reservation
Voided after settlementStake or liability returnedThe void reason, beside the marketRollback 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.

Telegram @turnkeyxhub WhatsApp Email Contact form