API Reference
DBot OfficialDBot DashboardPricing
Start typing to search…

创建自动狙击（WS）

用于创建多链的代币狙击任务

FreePlusProEnterprise积分消耗
✅✅✅✅0

URL

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

说明

为保证WebSocket连接的可用性和稳定性，需要至少每1分钟(建议每30-55秒)进行一次心跳订阅，否则系统会自动断开超时链接

请求示例

{
  "id": 1761291309, // 调用id,响应结果返回相同ID
  "method": "createSnipeOrder",
  "params": {
    "enabled": true, // "true"表示启用狙击
    "chain": "solana", // 链 (solana/ethereum/base/bsc/tron)
    "token": "8NA5VTjANcDGvwq1vdSd6EUuFxEZUDPCYx9Ut2rqpump", // 需要狙击的token的合约地址
    "walletId": "mglqkeq5009dol", // 使用的钱包的id，可通过“钱包信息 API”获取
    "expireDelta": 360000000, // 止盈止损任务的过期时间，最大值为432000000 (毫秒)
    "buySettings": {
      "buyAmountUI": "0.1", // 用于狙击的金额（ETH/SOL/BNB/TRX）
      "customFeeAndTip": false, // "true"表示优先费 (priorityFee) 和贿赂费 (jitoTip) 两个字段均有效，系统将按填写的值执行交易 (null表示自动优先费/自动贿赂费)，"false"表示高速模式下只有优先费 (priorityFee) 有效，防夹模式下只有贿赂费 (jitoTip) 有效，系统将自动进行分配
      "priorityFee": "0.00005", // 优先费 (SOL)，对Solana有效，空字符串表示使用自动优先费
      "gasFeeDelta": 5, // 额外增加的gas (Gwei)，对EVM链有效
      "maxFeePerGas": 100, // 基础gas超过此值时将不进行交易 (Gwei)，对EVM链有效
      "jitoEnabled": true, // "true"表示启用防夹模式 (Solana & Ethereum & Bsc)
      "jitoTip": 0.001, // 防夹模式使用的贿赂费 (Solana)，"jitoEnabled"或"customFeeAndTip"为true时必填 (null表示自动优先费/自动贿赂费)
      "maxSlippage": 0.1, // 最大滑点（0.00-1.00），买入时表示实际成交价格和期望价格之间的差距，卖出时表示期望价格和实际成交价格之间的差距，相差倍数=1/(1-滑点)，0.5即最多接受2倍价差，1 即不限制价差
      "minLiquidity": 0, // 流动性需要大于此值才会触发狙击（美元）
      "concurrentNodes": 2, // 并发节点数（1-3）
      "retries": 1 // 失败后的重试次数（0-10）
    },
    "sellSettings": {
      "enabled": true,
      "stopEarnEnabled": true, // 是否启用止盈，止盈止损至少启用一个
      "stopEarnMode": "profit_percent", // 止盈方式，目前支持"profit_percent"，表示按百分比止盈，启用止盈时必填
      "stopEarnPercentOrPrice": 1,
      "stopLossEnabled": true, // 是否启用止损，止盈止损至少启用一个
      "stopLossMode": "loss_percent", // 止损方式，目前支持"profit_percent"，表示按百分比止损，启用止损时必填
      "stopLossPercentOrPrice": 0.5,
      "autoSell": false, // 在任务结束未触发止盈止损时，是否自动卖出
      "useMidPrice": false, // "true"表示启用防插针模式，将使用1秒内的中间价格作为触发价，会尽可能但无法100%保证避免插针
      "customFeeAndTip": false, // "true"表示优先费 (priorityFee) 和贿赂费 (jitoTip) 两个字段均有效，系统将按填写的值执行交易 (null表示自动优先费/自动贿赂费)，"false"表示高速模式下只有优先费 (priorityFee) 有效，防夹模式下只有贿赂费 (jitoTip) 有效，系统将自动进行分配
      "priorityFee": "0.00005", // 优先费 (SOL)，对Solana有效，空字符串表示使用自动优先费
      "gasFeeDelta": 5, // 额外增加的gas (Gwei)，对EVM链有效
      "maxFeePerGas": 100, // 基础gas超过此值时将不进行交易 (Gwei)，对EVM链有效
      "jitoEnabled": true, // "true"表示启用防夹模式 (Solana & Ethereum & Bsc)
      "jitoTip": 0.001, // 防夹模式使用的贿赂费 (Solana)，"jitoEnabled"或"customFeeAndTip"为true时必填 (null表示自动优先费/自动贿赂费)
      "maxSlippage": 0.1, // 最大滑点（0.00-1.00），买入时表示实际成交价格和期望价格之间的差距，卖出时表示期望价格和实际成交价格之间的差距，相差倍数=1/(1-滑点)，0.5即最多接受2倍价差，1 即不限制价差
      "concurrentNodes": 2, // 并发节点数（1-3）
      "retries": 1 // 失败后的重试次数（0-10）
    }
  }
}

响应数据

{
    "method": "rpcResponse", // rpc响应
    "id": 1761291309, // 调用id
    "result": {
        "err": false, // 是否发生错误
        "res": {
            "id": "mh46i2rg000igj",
            "accountId": "lz99kwxp0006q0", // 用户id
            "enabled": true, // 任务启用状态，true/false
            "chain": "solana", // 链 (solana/ethereum/base/bsc/tron)
            "token": "8NA5VTjANcDGvwq1vdSd6EUuFxEZUDPCYx9Ut2rqpump", // 需要买入/卖出的代币地址或交易对地址
            "tokenInfo": { // 代币信息
                "contract": "8NA5VTjANcDGvwq1vdSd6EUuFxEZUDPCYx9Ut2rqpump",
                "name": "T1 Diabetes Cure Coin Flywheel",
                "symbol": "$JDCOINV2",
                "decimals": 6,
                "icon": null,
                "totalSupply": "1000000000000000",
                "tokenProgram": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
                "mintAuthority": null,
                "freezeAuthority": null,
                "createAt": 1761231132699 // 创建时间 (毫秒时间戳)
            },
            "walletId": "mglqkeq5003dol", // 使用的钱包的id，可通过“钱包信息 API”获取
            "expireAt": 1761629695612, // 任务过期时间 (毫秒时间戳)
            "expireDelta": 360000000, // 止盈止损任务的过期时间，最大值为432000000 (毫秒)
            "buySettings": {
                "buyAmountUI": 0.1, // 交易类型为buy时，填写买入金额（ETH/SOL/BNB/TRX），交易类型为sell时，填写卖出比例（0.00-1.00）
                "customFeeAndTip": false, // "true"表示优先费 (priorityFee) 和贿赂费 (jitoTip) 两个字段均有效，系统将按填写的值执行交易 (null表示自动优先费/自动贿赂费)，"false"表示高速模式下只有优先费 (priorityFee) 有效，防夹模式下只有贿赂费 (jitoTip) 有效，系统将自动进行分配
                "priorityFee": 0.00005, // 优先费 (SOL)，对Solana有效，空字符串表示使用自动优先费
                "gasFeeDelta": 5, // 额外增加的gas (Gwei)，对EVM链有效
                "maxFeePerGas": 100, // 基础gas超过此值时将不进行交易 (Gwei)，对EVM链有效
                "jitoEnabled": true, // "true"表示启用防夹模式 (Solana & Ethereum & Bsc)
                "jitoTip": 0.001, // 防夹模式使用的贿赂费 (Solana)，"jitoEnabled"或"customFeeAndTip"为true时必填 (null表示自动优先费/自动贿赂费)
                "maxSlippage": 0.1, // 最大滑点（0.00-1.00），买入时表示实际成交价格和期望价格之间的差距，卖出时表示期望价格和实际成交价格之间的差距，相差倍数=1/(1-滑点)，0.5即最多接受2倍价差，1 即不限制价差
                "minLiquidity": 0,
                "concurrentNodes": 2, // 并发节点数（1-3）
                "retries": 1 // 失败后的重试次数（0-10）
            },
            "sellSettings": {
                "enabled": true, // "true"表示启用止盈止损
                "stopEarnEnabled": true,
                "stopEarnMode": "profit_percent",
                "stopEarnPercentOrPrice": 1, // 止盈比例，0.5表示上涨50%时卖出，"null"表示不启用止盈
                "stopLossEnabled": true,
                "stopLossMode": "loss_percent",
                "stopLossPercentOrPrice": 0.5, // 止损比例（0.00-1.00），0.5表示下跌50%时卖出，"null"表示不启用止损
                "autoSell": false,
                "useMidPrice": false, // "true"表示启用防插针模式，将使用1秒内的中间价格作为触发价，会尽可能但无法100%保证避免插针
                "customFeeAndTip": false, // "true"表示优先费 (priorityFee) 和贿赂费 (jitoTip) 两个字段均有效，系统将按填写的值执行交易 (null表示自动优先费/自动贿赂费)，"false"表示高速模式下只有优先费 (priorityFee) 有效，防夹模式下只有贿赂费 (jitoTip) 有效，系统将自动进行分配
                "priorityFee": 0.00005, // 优先费 (SOL)，对Solana有效，空字符串表示使用自动优先费
                "gasFeeDelta": 5, // 额外增加的gas (Gwei)，对EVM链有效
                "maxFeePerGas": 100, // 基础gas超过此值时将不进行交易 (Gwei)，对EVM链有效
                "jitoEnabled": true, // "true"表示启用防夹模式 (Solana & Ethereum & Bsc)
                "jitoTip": 0.001, // 防夹模式使用的贿赂费 (Solana)，"jitoEnabled"或"customFeeAndTip"为true时必填 (null表示自动优先费/自动贿赂费)
                "maxSlippage": 0.1, // 最大滑点（0.00-1.00），买入时表示实际成交价格和期望价格之间的差距，卖出时表示期望价格和实际成交价格之间的差距，相差倍数=1/(1-滑点)，0.5即最多接受2倍价差，1 即不限制价差
                "concurrentNodes": 2, // 并发节点数（1-3）
                "retries": 1 // 失败后的重试次数（0-10）
            },
            "buyState": "init",
            "buyStateUpdateAt": 1761269695612,
            "sellState": "init",
            "sellStateUpdateAt": 1761269695612,
            "createAt": 1761269695612, // 创建时间 (毫秒时间戳)
            "updateAt": 1761269695612
        }
    }
}

以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": "createSnipeOrder",
        "params": {
          "enabled": true,
          "chain": "solana",
          "token": "8NA5VTjANcDGvwq1vdSd6EUuFxEZUDPCYx9Ut2rqpump",
          "walletId": "mglqkeq5009dol",
          "expireDelta": 360000000,
          "buySettings": {
            "buyAmountUI": "0.1",
            "customFeeAndTip": false,
            "priorityFee": "0.00005",
            "gasFeeDelta": 5,
            "maxFeePerGas": 100,
            "jitoEnabled": true,
            "jitoTip": 0.001,
            "maxSlippage": 0.1,
            "minLiquidity": 0,
            "concurrentNodes": 2,
            "retries": 1
          },
          "sellSettings": {
            "enabled": true,
            "stopEarnEnabled": true,
            "stopEarnMode": "profit_percent",
            "stopEarnPercentOrPrice": 1,
            "stopLossEnabled": true,
            "stopLossMode": "loss_percent",
            "stopLossPercentOrPrice": 0.5,
            "autoSell": false,
            "useMidPrice": false,
            "customFeeAndTip": false,
            "priorityFee": "0.00005",
            "gasFeeDelta": 5,
            "maxFeePerGas": 100,
            "jitoEnabled": true,
            "jitoTip": 0.001,
            "maxSlippage": 0.1,
            "concurrentNodes": 2,
            "retries": 1
          }
        }
      })
    )

    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/trade/ws/"
    headers = {"x-api-key": "YOUR_API_KEY"}
    msg = {
        "id": 1761291309,
        "method": "createSnipeOrder",
        "params": {
            "enabled": True,
            "chain": "solana",
            "token": "8NA5VTjANcDGvwq1vdSd6EUuFxEZUDPCYx9Ut2rqpump",
            "walletId": "mglqkeq5009dol",
            "expireDelta": 360000000,
            "buySettings": {
                "buyAmountUI": "0.1",
                "customFeeAndTip": False,
                "priorityFee": "0.00005",
                "gasFeeDelta": 5,
                "maxFeePerGas": 100,
                "jitoEnabled": True,
                "jitoTip": 0.001,
                "maxSlippage": 0.1,
                "minLiquidity": 0,
                "concurrentNodes": 2,
                "retries": 1
            },
            "sellSettings": {
                "enabled": True,
                "stopEarnEnabled": True,
                "stopEarnMode": "profit_percent",
                "stopEarnPercentOrPrice": 1,
                "stopLossEnabled": True,
                "stopLossMode": "loss_percent",
                "stopLossPercentOrPrice": 0.5,
                "autoSell": False,
                "useMidPrice": False,
                "customFeeAndTip": False,
                "priorityFee": "0.00005",
                "gasFeeDelta": 5,
                "maxFeePerGas": 100,
                "jitoEnabled": True,
                "jitoTip": 0.001,
                "maxSlippage": 0.1,
                "concurrentNodes": 2,
                "retries": 1
            }
        }
    }

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

请求参数可视化参考