API Key
A credential required for posting orders, cancelling orders, and accessing real-time WebSocket updates. Generated from your account at sx.bet. Passed as anX-Api-Key HTTP header for REST calls, and used to obtain a connection token for WebSocket subscriptions. See API Key.
apiExpiry
A Unix timestamp (in seconds) specifying when an order expires from the API’s perspective. After this time, the order is removed from the orderbook. Distinct from the on-chainexpiry field, which is deprecated and must always be 2209006800.
Base token
The ERC-20 token used to denominate a bet. On SX Bet, the primary base token is USDC (6 decimals). Referenced by contract address in API calls. See References.Bet group
A categorical grouping of related market types (e.g.,"game-lines", "outright-winner", "set-betting"). Returned in market objects from the API.
Betting delay
A short waiting period between when a fill is submitted and when the exchange matches it against the orderbook. Protects makers from toxic flow during in-play betting. See Betting Delays.Capital efficiency (CE)
A system that recognizes hedged exposure across opposing outcomes within a market group and releases escrowed funds early. Driven by the maximum-loss (MXL) algorithm. See Capital Efficiency.Cash out
The ability to exit a position early by selling it back. Mutually exclusive with CE refunds within the same market group.Chain ID
A numeric identifier for a blockchain network. SX mainnet is4162, SX testnet (Toronto) is 79479957.
Checksum format
A way of writing Ethereum addresses with mixed uppercase and lowercase letters (EIP-55) to catch typos. All addresses in the SX Bet API must use checksum format.Diming
Posting odds in tiny increments to gain an unfair edge over existing orders. The odds ladder prevents this by enforcing minimum step sizes.EIP-712
An Ethereum standard for signing structured typed data. Used by SX Bet to sign fill payloads and cancel requests. See EIP-712 Signing.Escrow
A smart contract that holds both sides’ funds while a bet is active. Automatically pays out the winner after settlement.Exchange model
SX Bet’s peer-to-peer model where users trade directly with each other rather than against a house or sportsbook. See The Exchange Model.Executor
The SX Bet exchange contract address that executes matched orders on-chain. Retrieved fromGET /metadata and required in every maker order.
Exposure
The total amount of capital at risk across your open orders. Calculated as the sum oftotalBetSize - fillAmount for all active orders. Must stay under your wallet balance.
fillAmount
The portion of a maker order that has already been matched by takers. The remaining fillable amount istotalBetSize - fillAmount.
fillSalt
A random 32-byte value that uniquely identifies a fill submission. Must match between the EIP-712 signature and the API request body.Fixture
An individual sporting event (game, match, race, etc.) that betting markets are created for. Each fixture has a status indicating its current state. See Fixture Statuses.Heartbeat
A safety mechanism that automatically cancels all your open orders if your service stops sending periodic heartbeat requests within a configured timeout. See Heartbeat.Implied probability
Odds expressed as a probability between 0% and 100%. The native odds format on SX Bet. Stored as a fixed-point integer with 20 decimal places (e.g., 52.5% =52500000000000000000).
isMakerBettingOutcomeOne
A boolean field on orders indicating which outcome the maker is backing.true = outcome one, false = outcome two. The taker always takes the opposite side.
Maker
A user who posts an order to the orderbook, specifying an outcome, stake, and odds. Makers wait for takers to fill their orders. Makers pay 0% fees on SX Bet.Market
A specific betting proposition on a fixture, defined by its sport, league, fixture, market type, and line. Identified by itsmarketHash.
Market group
A collection of related markets for a single fixture (e.g., all markets for one game). Used for calculating maximum loss and CE refunds.marketHash
A unique keccak256 hash identifying a specific market. The primary key used in API calls to reference markets.Market type
The category of bet — moneyline (1), spread (2), total/over-under (3), Asian handicap, etc. See Market Types.Maximum loss (MXL)
The worst-case net loss across all open positions within a market group. The CE algorithm calculates this to determine when escrow funds can be released.Moneyline
A market type where you predict which team or player will win outright, with no point spread. Market type ID1.
Odds ladder
The set of valid odds values you can post orders at. Currently enforced at 0.125% intervals to prevent diming. See Odds Rounding.oddsSlippage
An integer (0–100) representing the percentage tolerance ondesiredOdds when filling. Applied to the weighted average odds across all matched orders. See Slippage.
Orderbook
The collection of all active, unfilled maker orders for a given market. Fully transparent — all users can see all orders. See The Orderbook.orderHash
A unique identifier for a specific maker order, computed from the order fields. Returned when an order is successfully posted.Outcome
One of two bettable sides in a market. Outcome one is typically the first team/option listed, outcome two is the second. Some markets also have a void outcome (e.g., draw).Parlay
A multi-leg bet combining multiple markets. All legs must win for the parlay to pay out. SX Bet applies a 5% fee on parlay profits. See Parlays.Partial fill
When a taker fills only a portion of a maker’s available stake. The remaining unfilled portion stays on the orderbook for other takers.percentageOdds
The odds for a maker order expressed as the maker’s implied probability multiplied by 10^20. For example, 52.5% implied ="52500000000000000000". The taker receives the complementary odds on the opposite outcome.
RFQ (Request for Quote)
The system used for parlay betting. When a bettor requests a parlay, makers receive the request via WebSocket and have 3 seconds to post orders. See Parlays.Salt
A random number included in an order to differentiate otherwise identical orders. Ensures each order produces a unique hash.Settlement
The process of determining the outcome of a market after the event concludes and distributing funds to winners. Handled by the on-chain ReporterService contract.solidityKeccak256
A hashing function used to compute maker order hashes. Takes ABI-encoded order fields and produces a bytes32 hash that the maker signs.Spread
A market type where you predict whether a team will win by more or less than a specified point margin (the “line”). Market type ID2.
sportXeventId
A string identifier for sporting events within SX Bet’s system. Used to group markets by fixture and for event-level cancellations.stakeWei
The taker’s bet amount in base token units (Ethereum format). For USDC with 6 decimals,"50000000" = 50 USDC. See Unit Conversion.
SX Network
The blockchain that SX Bet runs on. Mainnet chain ID4162.
Taker
A user who fills an existing order from the orderbook. Takers get immediate execution at the posted price. Takers pay 0% fees on single bets, 5% on parlay profits.TokenTransferProxy
A smart contract that must be approved (via ERC-20approve) before you can place bets. It transfers tokens on your behalf when orders are matched. See Enabling Betting.
Total (Over/Under)
A market type where you predict whether a combined score or statistic will be over or under a specified line. Market type ID3.
totalBetSize
The maximum amount of tokens a maker puts at risk if the order is fully filled. Expressed in base token units (e.g.,"100000000" = 100 USDC).