Synchronicity Exchange API
The Synchronicity Exchange API is designed for programmatic traders to express their trading preference with a high degree of expressivity and read and write data with the lowest latency possible while maintaining a simple, intuitive interface.
Base URLs
| Service | URL | Purpose |
|---|---|---|
| Rollup API | https://api.t.synchronicity.xyz/ | Submit transactions (orders, cancellations, deposits, withdrawals) |
| Indexer API | https://api.t.synchronicity.xyz/indexer | Read market data, account balances and positions, and real-time updates |
| WebSocket | wss://api.t.synchronicity.xyz/indexer-ws/ws | Real-time market and account data streams |
Price & Size Decimals
Each orderbook has a price_decimals and size_decimals value. These always sum to 6.
For example, BTC-USDT has price_decimals: 1 and size_decimals: 5.
- Transactions (Rollup API): Prices and sizes must be submitted as raw
u128integers with decimals already applied. A price of50000.0with 1 price decimal is sent as500000. A size of1.50000with 5 size decimals is sent as150000. - REST API & WebSocket (Indexer API): Prices and sizes are returned as formatted decimal strings (e.g.
"50000.0","1.50000").
Use GET /api/orderbook/:orderbookId/decimals or GET /api/orderbooks to look up the decimal configuration for each orderbook.
Sections
Session Cookie
The indexer REST API (/api/*) and WebSocket endpoint require an HMAC-signed _idx_session cookie. Start here before calling any other indexer endpoint. The rollup/sequencer API is unaffected.
Market Info
Public market data available without authentication — query markets, orderbooks, candles, and status.
User Info
Authenticated REST endpoints for account data — balances, positions, order history, and strategies. Includes SIWE authentication details.
Market Info Websocket
Public WebSocket channels — real-time orderbook depth, trades, context, and candle updates.
User Websocket
Authenticated WebSocket channels — real-time account state, strategy updates, and notifications.
Exchange Transactions
Transaction building, signing, submission, and the full perpetual exchange API — order placement, cancellation, leverage management, and more.
Gas & Fees
The SYNC gas token, the 2-D gas_limit shape required on SL/TP / TWAP / trigger calls / conditional executions, the reactive queue, and how gas charges show up in balance history.