API Reference
DBot OfficialDBot DashboardPricing

Limit Orders (WS)

Used to get the user's all limit orders

FreePlusProEnterprise积分消耗
0

URL

wss://api-bot-v1.dbotx.com/trade/ws/

Notes

To ensure the availability and stability of the WebSocket connection, a heartbeat subscription must be sent at least once every minute (recommended every 30–55 seconds), otherwise the system will automatically disconnect the timeout link

Request Example

{
  "id": 1761291309, // Call ID; the response returns the same ID as the request
  "method": "listLimitOrders", // Method to query limit order tasks
  "params": {
    "page": 0, // Page number (0 / 1 / 2 ...)
    "size": 5, // Page size (10 / 20, max 20)
    "chain": "solana", // Blockchain (solana/ethereum/base/bsc/tron)
    "state":"init", // Order status: init (initial), processing, done (completed), fail, expired
    "groupId":"m8zl720z0015pp", // Group id
    "token":"5nvNUh3ZU2Q3AJmD5YP8ykcUSv2P8C4Z8MKt5vmTpump" // Token address
  }
}

Response Data

{
    "method": "rpcResponse", // RPC response
    "id": 1761291309, // Call ID
    "result": {
        "err": false, // Request result status; false means succeeded, true means failed
        "res": [
            {
                "id": "mh4bbw0b000r39", // Task id
                "accountId": "lz99kwxp0006q0", // User ID
                "enabled": true, // Task enable status, true/false
                "chain": "solana", // Chain (solana/ethereum/base/bsc/tron)
                "pairType": "pump_swap", // DEX source
                "pairFee": null,
                "pair": "D3tmyEWPN4qW7LYHbUVNYsSydkQNzF3JiKfWVwxn7kYj", // Trading pair contract address
                "token": "5nvNUh3ZU2Q3AJmD5YP8ykcUSv2P8C4Z8MKt5vmTpump", // Token address
                "tokenInfo": { // Token information
                    "contract": "5nvNUh3ZU2Q3AJmD5YP8ykcUSv2P8C4Z8MKt5vmTpump",
                    "createAt": 1761238119769, // Creation time (ms timestamp)
                    "name": "Animals Wif Guns",
                    "symbol": "Guns",
                    "decimals": 6,
                    "totalSupply": "1000000000000000",
                    "icon": null,
                    "tokenProgram": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
                    "mintAuthority": null,
                    "freezeAuthority": null
                },
                "currency": "So11111111111111111111111111111111111111112", // Base currency address
                "currencyInfo": { // Base currency information
                    "contract": "So11111111111111111111111111111111111111112",
                    "name": "Wrapped SOL",
                    "symbol": "SOL",
                    "decimals": 9,
                    "totalSupply": null,
                    "icon": "https://assets-cdn.trustwallet.com/blockchains/solana/assets/So11111111111111111111111111111111111111112/logo.png",
                    "createAt": null
                },
                "pairCurrency": null,
                "pairCurrencyInfo": null,
                "walletId": "mglqkeq5003dol", // Wallet ID used, obtainable via "Wallet Info API"
                "groupId": null, // Group ID
                "groupName": null,
                "tradeType": "sell", // Trade type, values buy or sell
                "triggerDirection": "up", // "down" means execute buy/sell when below trigger price, "up" when above
                "triggerPriceUsd": 0.000646014057, // Trigger buy/sell price (USD)
                "currencyAmountUI": 1, // For buy type, enter buy amount (ETH/SOL/BNB/TRX); for sell type, enter sell ratio (0.00-1.00)
                "expireDelta": 432000000, // Task validity duration, max 432000000 (ms)
                "expireAt": 1761709805003, // Task expiration time (ms timestamp)
                "expireExecute": true, // "true" means if not triggered within validity period, execute automatically at end
                "useMidPrice": true, // "true" enables Anti-Spike mode using 1-second mid-price as trigger price (not 100% guaranteed)
                "gasFeeDelta": 5, // Extra added gas (Gwei), valid for EVM
                "maxFeePerGas": 100, // When base gas exceeds this value, no transaction (Gwei), valid for EVM chains
                "priorityFee": 0.00001, // Priority Fee (SOL), valid for Solana, empty string means auto priority fee
                "maxSlippage": 0.1, // Max slippage tolerance (0.00-1.00), for buy: difference between actual and expected price; for sell: expected and actual, multiplier = 1/(1-slippage)
                "retries": 0, // Number of retries after failure (0-10)
                "concurrentNodes": 1, // Number of concurrent nodes (1-3)
                "jitoEnabled": false, // "true" enables anti-MEV mode (Solana & Ethereum & Bsc)
                "jitoTip": 0.00001, // Bribery tip for Anti-MEV (Solana), required when jitoEnabled or customFeeAndTip is true (null for auto)
                "customFeeAndTip": true, // "true" means both priorityFee and jitoTip valid; "false" means turbo: only priorityFee, anti-MEV: only jitoTip, auto allocation
                "state": "init", // Order status: init (initial), processing, done (completed), fail, expired
                "lastStateUpdateAt": 1761277805002,
                "createAt": 1761277805002, // Creation time (ms timestamp)
                "updateAt": 1761277805002,
                "errorCode": "", // Error type
                "errorMessage": "", // Error message
                "links": { // Related links for this transaction
                    "etherscan": null,
                    "dexscreener": "https://dexscreener.com/solana/D3tmyEWPN4qW7LYHbUVNYsSydkQNzF3JiKfWVwxn7kYj",
                    "uniswap": "https://jup.ag/swap/So11111111111111111111111111111111111111112-5nvNUh3ZU2Q3AJmD5YP8ykcUSv2P8C4Z8MKt5vmTpump"
                },
                "walletName": "222", // Wallet name
                "walletAddress": "6pNBhbgtWwWd6tnQHNoH1tqZW2hBvUfLPVtq5BwTQNZt", // Wallet address
                "walletType": "solana", // Wallet type (solana/evm)
                "nonceCount": 4
            }
        ]
    }
}

Example in NodeJS

const WebSocket = require('ws')

function main() {
  const ws = new WebSocket('wss://api-data-v1.dbotx.com/trade/ws/', {
    headers: {
      'x-api-key': 'YOUR_API_KEY',
    },
  })

  ws.on('open', () => {
    ws.send(
      JSON.stringify({
        "id": 1761291309,
        "method": "listLimitOrders",
        "params": {
          "page": 0,
          "size": 5,
          "chain": "solana",
          "state":"init",
          "groupId":"m8zl720z0015pp",
          "token":"5nvNUh3ZU2Q3AJmD5YP8ykcUSv2P8C4Z8MKt5vmTpump"
      }
    })
    )

    setInterval(() => {
      ws.ping()
    }, 30000)
  })

  ws.on('message', res => {
    console.log('res:', res.toString('utf-8'))
  })
}

main()

Example in Python

import asyncio
import websockets
import json

async def main():
    uri = "wss://api-data-v1.dbotx.com/trade/ws/"
    headers = {"x-api-key": "YOUR_API_KEY"}
    msg = {
      "id": 1761291309,
      "method": "listLimitOrders",
      "params": {
        "page": 0,
        "size": 5,
        "chain": "solana",
        "state":"init",
        "groupId":"m8zl720z0015pp",
        "token":"5nvNUh3ZU2Q3AJmD5YP8ykcUSv2P8C4Z8MKt5vmTpump"
    }
  }

    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())

Response data visualization reference