API Reference
DBot OfficialDBot DashboardPricing

订阅钱包实时交易(WS)

用于订阅指定钱包的全部实时交易数据

FreePlusProEnterprise积分消耗
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())