Core Concepts
Supported Exchanges
Exchanges available through Synpath, their capabilities, and upcoming integrations.
Synpath gives one API over several prediction market exchanges. The venue key is the value you pass everywhere: the prefix of every Synpath id, the argument to synpath.exchange(...), and the path segment in the REST API.
Available exchanges
| Exchange | Venue key | Description | REST | WebSocket |
|---|---|---|---|---|
| Kalshi | kalshi | CFTC-regulated US exchange. One book per market, quoted on the YES leg. | Market data, trading | Order book, ticker, trades, market status, orders, fills, positions |
| Polymarket | polymarket | On-chain CLOB on Polygon. YES and NO are separate tokens; Synpath folds them into one market. | Market data, trading | Order book, ticker, trades; orders and fills on the user stream |
| Polymarket US | polymarket_us | CFTC-regulated US exchange, separate from the on-chain CLOB, mostly sports. An event is a game or a question; each market trades one YES instrument, NO being its book reflected. A retail API and an exchange API for onboarded firms; market data needs no key. | Market data, trading | Order book, ticker, trades; orders, fills, positions, balance on the private stream |
| Opinion | opinion | On-chain CLOB on BNB Chain, settled in USDT. YES and NO are separate tokens, as on Polymarket; a categorical topic is an event of binary markets. | Market data, trading | Order book, last price, trades; orders and fills on the user stream. Every channel needs an Opinion API key |
| Hyperliquid | hyperliquid | Outcome markets (HIP-4) on the Hyperliquid L1, settled in USDC. A question ("Premier League winner") is an event of binary outcomes; YES and NO trade as two coins on one book. Fees only when a position closes or settles. | Market data, trading | Order book, top of book, trades; orders and fills on the user stream. No key for any channel |
| predict.fun | predict_fun | On-chain CLOB on BNB Chain, settled in USDT. A category is an event of binary markets; YES and NO are separate tokens on one book. Most markets copy a Polymarket market and say which. Every mainnet request needs an API key. | Market data, trading | Order book, top of book; orders and fills on the user stream. Every channel needs an API key |
| Limitless | limitless | On-chain CLOB on Base, settled in USDC. A group is an event of binary markets; YES and NO are separate tokens on one book. Many markets copy a Polymarket market and say which. No key for market data; trading needs a Limitless API token. | Market data, trading | Order book, top of book, resolutions; orders and fills on the user stream |
| SX Bet | sx_bet | Peer-to-peer sports exchange on its own chain, settled in USDC. A fixture is an event of binary markets (moneylines, spreads, totals, props), outcome one as YES; a market can be voided, which refunds every bet. Fees on a winning taker's profit. No key for market data; streams and trading need an SX Bet API key. | Market data, trading | Order book, top of book, trades, market changes; orders and fills on the user stream. Every channel needs an API key |
| Betfair | betfair | Betfair Exchange, a betting exchange. Each runner is a yes/no market (betfair:1.234567890-47972); the Betfair market holding the runners is its event. Backs and lays are read as YES. Every call needs your own Betfair account and app key; a delayed key is 1 to 180 seconds late, three levels deep. | Market data | Order book, over the Exchange Stream API (TLS socket). Needs your app key |
| Smarkets | smarkets | UK betting exchange. Each contract is a yes/no market (smarkets:164973231-456060183); the Smarkets market holding the contracts is its event. Prices are already probabilities. No account for market data; quotes are delayed without a login. | Market data | Order book, polled from REST quotes |
| Novig | novig | US sports prediction exchange. Each two-outcome market is a yes/no market, the outcome Novig lists first as YES (novig:<marketId>); the game is its event. Market data needs no account. Trading needs a Novig account (US identity and location checks; Arizona, Michigan and Nevada excluded) and a key from Profile → Settings → Novig API; Paper is Novig's play-money copy. | Market data, trading | Order book, trades, market status, orders, positions (with a trading key; the public book is polled without one) |
| Matchbook | matchbook | UK betting exchange. Each runner is a yes/no market (matchbook:<event>-<market>-<runner>); backs and lays are read as Betfair's are. Market data needs no account; trading needs your Matchbook login. | Market data, trading | Order book, polled (Matchbook has no push API) |
| ProphetX | prophetx | US sports exchange. Each moneyline, spread or total line is a yes/no market, the first listed side as YES; American odds are converted to prices exactly. Every call needs keys: a trading key pair from a ProphetX account, or a market-data key ProphetX issues on request. | Market data, trading | Order book, trades, orders and fills |
| Azuro | azuro | On-chain sports betting pool (Polygon, Base). Bets take the pool's odds rather than resting orders: an order is a market order with a minimum-odds bound, and a placed bet cannot be cancelled. Market data needs no account; trading needs a wallet. | Market data, trading | Odds and market status |
| Myriad | myriad | On-chain prediction market on BNB Chain, Abstract and Linea, with order-book and AMM markets, sports among them. Market data needs no account; trading (order-book markets) needs a wallet, with an API key or a sign-in. | Market data, trading | Order book, prices, trades; orders and positions on the user stream |
| Gemini | gemini | Gemini Predictions, a CFTC-regulated US exchange with sports moneylines, spreads, totals and props. One book per contract, quoted on YES. Market data needs no account; trading needs a Gemini account eligible for prediction markets. | Market data, trading | Order book, ticker, trades, contract status; orders, fills, positions and balances on the user stream |
import synpath
kalshi = synpath.exchange("kalshi")
polymarket = synpath.exchange("polymarket")
polymarket_us = synpath.exchange("polymarket_us")
opinion = synpath.exchange("opinion")
hyperliquid = synpath.exchange("hyperliquid")
predict_fun = synpath.exchange("predict_fun") # PREDICT_FUN_API_KEY
limitless = synpath.exchange("limitless")
sx_bet = synpath.exchange("sx_bet")
betfair = synpath.exchange("betfair") # BETFAIR_APP_KEY, BETFAIR_USERNAME, BETFAIR_PASSWORD
smarkets = synpath.exchange("smarkets")
novig = synpath.exchange("novig")
matchbook = synpath.exchange("matchbook")
prophetx = synpath.exchange("prophetx") # PROPHETX_ACCESS_KEY, PROPHETX_SECRET_KEY
azuro = synpath.exchange("azuro")
myriad = synpath.exchange("myriad")
gemini = synpath.exchange("gemini")Differences handled for you
- One price. Every price is the YES price, on every venue. Polymarket's NO token and Kalshi's reflected NO book are read back onto the YES leg.
- One id.
venue:native, so an id says where it lives; see Synpath IDs. - Market orders. No venue has a true market order. Synpath sends an immediate limit at your protection price and refuses one without it.
- Contracts, not tokens. Amounts are contracts everywhere. On Polymarket, a position is the net of the YES and NO token inventories.
- Fees.
fetch_fee_schedulereads each venue's own schedule so an estimate is available before you trade. Opinion publishes its rates only on chain; Synpath reads them there, with no key or wallet. Hyperliquid charges only when a position closes or settles, and an estimate says so. - Rate limits. Each adapter knows its venue's limits and backs off on
RateLimitExceeded, honouringretry_afterwhen the venue sends one.
Opinion's terms of use bar residents and citizens of several countries, the US and UK among them. Check them before trading there.
Hyperliquid's terms bar the US, Ontario and sanctioned places, and some outcome-market front ends bar more, the UK among them. Check what applies to you before trading there with real funds.
Logging in to trade on predict.fun signs its login message, which accepts its Terms of Service. Read them, and check they allow you to trade, before the first order.
Betfair and Smarkets give market data only; neither takes orders through Synpath yet. Betfair needs your own account and app key (
BETFAIR_APP_KEY, BETFAIR_USERNAME, BETFAIR_PASSWORD, optionally BETFAIR_CERT_PATH and BETFAIR_KEY_PATH for certificate login, and BETFAIR_JURISDICTION). Smarkets needs no account; SMARKETS_USERNAME and SMARKETS_PASSWORD are optional and give undelayed quotes.Betfair's API is refused from several countries, the US, Germany, France, the Netherlands, Singapore, India, Turkey and the UAE among them. Its keys are for your own betting: showing its prices to anyone else needs a data licence from Betfair.
Smarkets' API terms allow viewing prices and betting on your own account, and prohibit odds scraping.
Polymarket and Polymarket US share a brand and nothing else. The first is the on-chain order book; the second is the regulated US exchange. They are separate venue keys with separate credentials.

