Skip to main content
The Decibel WebSocket API provides real-time streaming data for markets, order books, trades, account state, and notifications.

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
depth:{marketAddr}:{level}Depth updates with aggregation level 1, 2, 5, 10, 100, 1000 (default 1)
trades:{marketAddr}Trade stream for a market
market_price:{marketAddr}Real-time price/funding/open interest for a market
all_market_pricesPrice updates for all markets
market_candlestick:{marketAddr}:{interval}OHLCV candlestick data (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/update events
account_positions:{accountAddr}Positions for an account
account_overview:{accountAddr}Account overview updates
user_trades:{accountAddr}User trade fills
notifications:{accountAddr}User notifications
withdraw_queue:{accountAddr}Incremental withdrawal queue updates

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

Topic Compatibility Notes

The server still accepts legacy topic names for backward compatibility:
  • user_open_orders:{accountAddr} (legacy) -> canonical account_open_orders:{accountAddr}
  • user_positions:{accountAddr} (legacy) -> canonical account_positions:{accountAddr}

Message Format

See Connection Management for subscribe/unsubscribe payloads, auth headers, and error responses.

Next Steps

Connection Management

Connect, authenticate, subscribe, reconnect

TypeScript SDK

Managed WebSocket connections via SDK