Subscription Interface

Events

1. Kline Data Subscription

1.1 Kline Data Subscription (v1 - Spot Only, Original)

socket.emit('subscribe_kline', poolId, interval);

socket.emit('subscribe_kline', 1, '1m');

Returns only spot engine kline data, excluding AMM swap klines. This is the original behavior and remains the default.

1.2 Kline Data Subscription v2 (Aggregated)

socket.emit('subscribe_kline_v2', poolId, interval);

socket.emit('subscribe_kline_v2', 1, '1m');

Returns aggregated kline data (spot + AMM) including AMM swap klines. This is the new enhanced version.

2. Depth Data Subscription

2.1 Depth Data Subscription (v1 - Spot Only, Original)

socket.emit('subscribe_depth', poolId, precision);

socket.emit('subscribe_depth', 1, '0.00000001');

Returns only spot order book depth data, excluding AMM liquidity. This is the original behavior and remains the default.

2.2 Depth Data Subscription v2 (Aggregated)

socket.emit('subscribe_depth_v2', poolId, precision);

socket.emit('subscribe_depth_v2', 1, '0.00000001');

Returns aggregated depth data (spot + AMM) when AMM pools are available. This is the new enhanced version.

3.Pool Stats Data Subscription

socket.emit('subscribe_pool_stats', poolId);

socket.emit('subscribe_pool_stats', 1);

All Pools Stats Data Subscription

socket.emit('subscribe_all_pool_stats');

12. Unsubscribe

socket.emit('unsubscribe', subscriptionType, poolId, interval, precision);

socket.emit('unsubscribe', 'kline', 1, '1m');
socket.emit('unsubscribe', 'kline_v2', 1, '1m');
socket.emit('unsubscribe', 'perp_kline', 1, '1m');

socket.emit('unsubscribe', 'depth', 1, '0.00000001');
socket.emit('unsubscribe', 'depth_v2', 1, '0.00000001');
socket.emit('unsubscribe', 'perp_depth', 1, '0.00000001');

socket.emit('unsubscribe', 'trades', 1);
socket.emit('unsubscribe', 'trades_v2', 1);
socket.emit('unsubscribe', 'perp_trades', 1);

socket.emit('unsubscribe', 'amm_swap', 1);

socket.emit('unsubscribe', 'pool_stats', 1);
socket.emit('unsubscribe', 'perp_pool_stats', 1);

socket.emit('unsubscribe', 'perp_price', 1);

Unsubscribe All

socket.emit('unsubscribe_all');

Unsubscribe All Kline

socket.emit('unsubscribe_all_kline');

Unsubscribe All Depth

socket.emit('unsubscribe_all_depth');

Unsubscribe All Pool Stats

socket.emit('unsubscribe_all_pool_stats');

Subscription Response

When successfully subscribing to a topic, the subscribed event is received:

socket.on('subscribed', (response) => {
    console.log(response);
});

Last updated