用于订阅指定钱包的全部实时交易数据
Free | Plus | Pro | Enterprise | 积分消耗 |
---|---|---|---|---|
✅ | ✅ | ✅ | ✅ | 0 |
URL
wss://api-data-v1.dbotx.com/data/ws/
说明
为保证WebSocket连接的可用性和稳定性,需要至少每1分钟(建议每30-55秒)进行一次心跳订阅,否则系统会自动断开超时链接
请求示例
{
"action": "subscribe", // 进行的操作,“subscribe”表示订阅,“unsubscribe”表示取消订阅
"type": "monitorEvent", // 订阅的类型,“tx”表示实时交易,“pairsInfo”表示多交易对数据更新,“newPairInfo”表示新上交易对,“pairInfo”表示单交易对数据更新,”migratedPairInfo“表示最新迁移交易对,"monitorEvent"表示钱包实时交易
"msgData": {
"addresses": [
{
"address": "钱包地址",
"filter": {
"minBoughtAmount": 0.01,
"maxBoughtAmount": 10,
"minSoldAmount": 100,
"maxSoldAmount": 10000,
"minMCap": 500000,
"maxMCap": 50000000000
}
},
{
"address": "钱包地址",
"filter": {
"minBoughtAmount": 0.01,
"maxBoughtAmount": 10,
"minSoldAmount": 100,
"maxSoldAmount": 10000,
"minMCap": 500000,
"maxMCap": 50000000000
}
}
]
}
}
响应数据
{
"status": "ack", // 订阅状态,“ack”代表成功
"method": "subscribeResponse",
"result": {
"type": "monitorEvent", // 订阅的类型,“tx”表示实时交易,“pairsInfo”表示多交易对数据更新,“newPairInfo”表示新上交易对,“pairInfo”表示单交易对数据更新,”migratedPairInfo“表示最新迁移交易对,"monitorEvent"表示钱包实时交易
"t": 1751008703051,
"subscribed": [
"monitorEvent"
],
"message": "Connected and subscribed"
}
}
以NodeJS为例
const WebSocket = require('ws')
function main() {
const ws = new WebSocket('wss://api-data-v1.dbotx.com/data/ws/', {
headers: {
'x-api-key': 'YOUR_API_KEY',
},
})
ws.on('open', () => {
ws.send(
JSON.stringify({
method: 'subscribe',
type: 'monitorEvent',
msgData: {
"addresses": [
{
"address": "钱包地址",
"filter": {
"minBoughtAmount": 0.01,
"maxBoughtAmount": 10,
"minSoldAmount": 100,
"maxSoldAmount": 10000,
"minMCap": 500000,
"maxMCap": 50000000000
}
},
{
"address": "钱包地址",
"filter": {
"minBoughtAmount": 0.01,
"maxBoughtAmount": 10,
"minSoldAmount": 100,
"maxSoldAmount": 10000,
"minMCap": 500000,
"maxMCap": 50000000000
}
}
]
}
})
)
setInterval(() => {
ws.ping()
}, 30000)
})
ws.on('message', res => {
console.log('res:', res.toString('utf-8'))
})
}
main()
以Python为例
import asyncio
import websockets
import json
async def main():
uri = "wss://api-data-v1.dbotx.com/data/ws/"
headers = {"x-api-key": "YOUR_API_KEY"}
msg = {
"action": "subscribe",
"type": "monitorEvent",
"msgData": {
"addresses": [
{
"address": "钱包地址",
"filter": {
"minBoughtAmount": 0.01,
"maxBoughtAmount": 10,
"minSoldAmount": 100,
"maxSoldAmount": 10000,
"minMCap": 500000,
"maxMCap": 50000000000
}
},
{
"address": "钱包地址",
"filter": {
"minBoughtAmount": 0.01,
"maxBoughtAmount": 10,
"minSoldAmount": 100,
"maxSoldAmount": 10000,
"minMCap": 500000,
"maxMCap": 50000000000
}
}
]
}
}
async with websockets.connect(uri, additional_headers=headers) as ws:
await ws.send(json.dumps(msg))
async def keep_alive():
while True:
await ws.ping()
await asyncio.sleep(30)
async def listen_for_messages():
async for message in ws:
print(message)
await asyncio.gather(keep_alive(), listen_for_messages())
if name == “main”:
asyncio.run(main())