Skip to main content

Private websocket

Private websocket​

Private websocket address​

mainnet: wss://stream.deepcoin.com/v1/private

Get listenkey​

HTTP Method: GET

HTTP Request: /deepcoin/listenkey/acquire

response:

{
"code": "0",
"msg": "",
"data": {
"listenkey": "a29e6d260bb2a82478abf49759cb31a9",
"expire_time": 1691403285
}
}

Extend expiration time​

By sliding window, the expiration time will be extended for another hour

HTTP Method: GET

HTTP Request: /deepcoin/listenkey/extend

body listenkey="f24739a259bc1ac714dad2ac6690c816"

response:

{
"code": "0",
"msg": "",
"data": {
"listenkey": "a29e6d260bb2a82478abf49759cb31a9",
"expire_time": 1691403285
}
}

Connection Limit​

Same IP limited to 300 connections per 5 minutes. Rate limited but no limit on total connection count.

Subscribe ws​

wss://stream.deepcoin.com/v1/private?listenKey=404879eae0a969e199d2bc3f3766faa1

Return parameters​

Currently, once the subscription is successful, fund changes, order changes, etc. will be pushed at once.

Subscribe with tables parameter​

The private WebSocket supports subscribing to specific channels. Send the following message to subscribe to only the channels you need:

{"action":"subscribe","tables":["Account","AccountDetail","Order","Position","Trade","TriggerOrder"]}

If tables is not specified, all channels will be subscribed by default.

To unsubscribe from specific channels, re-subscribe with a tables array that only includes the channels you want to keep.

Tables to Channels Mapping​

tablesChannelDescription
AccountAssetAccount balance changes
AccountDetailAccount DetailsAccount detail changes
OrderOrderOrder changes
PositionPositionPosition changes
TradeTradeTrade record changes
TriggerOrderTrigger OrderTrigger order changes