Skip to main content
The Decibel WebSocket API provides real-time streaming data for markets, orderbooks, trades, and account updates. Use it instead of polling the REST API for time-sensitive data. All connections require authentication. Anonymous WebSocket connections will be disabled. See Connection Management for auth details.

Server URL

NetworkURL
Testnetwss://api.testnet.aptoslabs.com/decibel/ws
Mainnetwss://api.mainnet.aptoslabs.com/decibel/ws

Available Channels

Market Data

ChannelDescription
depth:{marketAddr}Orderbook depth updates. Optional aggregation level suffix: depth:{marketAddr}:{level} where level is 1, 2, 5, 10, 100, or 1000 (default: 1)
trades:{marketAddr}Trade stream for a market
market_price:{marketAddr}Real-time price, funding rate, and open interest for a market
all_market_pricesPrice updates for all markets
market_candlestick:{marketAddr}:{interval}OHLCV candlestick data. Intervals: 1m, 5m, 15m, 30m, 1h, 2h, 4h, 1d, 1w, 1mo

Account

ChannelDescription
account_open_orders:{accountAddr}Open orders for an account
order_updates:{accountAddr}Order status change events
account_positions:{accountAddr}Open positions for an account
account_overview:{accountAddr}Account equity, margin, and balances
user_trades:{accountAddr}Trade fills for a user
notifications:{accountAddr}Real-time notifications (liquidations, etc.)

Bulk Orders

ChannelDescription
bulk_orders:{accountAddr}Bulk order status updates
bulk_order_fills:{accountAddr}Bulk order fill events
bulk_order_rejections:{accountAddr}Bulk order rejection events

TWAP

ChannelDescription
user_active_twaps:{accountAddr}Active TWAP orders for a user

Message Format

See Connection Management for the subscribe/unsubscribe format, authentication, and example messages.

Next Steps

Connection Management

How to connect, authenticate, and handle reconnection

TypeScript SDK

Use the SDK for managed WebSocket connections