链查询与广播

地址资产查询

查询指定链上某地址持有的代币余额。

请求路径： POST /bgw-pro/wallet/v1/account/balancesV3

请求参数

参数	类型	是否必填	参数说明
chain	string	是	链标识，如 eth、bnb、matic 等
address	string	是	用户钱包地址
contract	[]string	否	Token 合约地址列表，为空时查询最多 1000 条

请求示例


{
    "chain": "eth",
    "address": "0x000000000000Bb1B11e5Ac8099E92e366B64c133",
    "contract": ["0x2b591e99afE9f32eAA6214f7B7629768c40Eeb39"]
}

响应示例


{
    "code": 0,
    "data": {
        "0x2b591e99afE9f32eAA6214f7B7629768c40Eeb39": {
            "chain": "eth",
            "address": "0x000000000000Bb1B11e5Ac8099E92e366B64c133",
            "contract": "0x2b591e99afE9f32eAA6214f7B7629768c40Eeb39",
            "balance": "1.000000000000000000",
            "update_time": 1775358110
        }
    },
    "message": "success"
}

Gas 费用查询

查询指定链当前的 Gas 价格，支持 EVM 链的 EIP-1559 费用模型。

请求路径： POST /bgw-pro/chain/public/getGasPriceV1

请求参数

参数	类型	是否必填	参数说明
chain	string	是	链标识，如 eth、bnb、matic 等

请求示例


{
  "chain": "eth"
}

响应示例


{
  "code": 0,
  "message": "success",
  "data": {
    "gasPrice": "0.117109435",
    "mediumGasPrice": "0.13467585025",
    "fastGasPrice": "0.1756641525",
    "eip1559": {
      "baseFeePerGas": "0.116719073",
      "maxPriorityFeePerGas": "0.000054325",
      "maxPriorityFeePerGasTiered": {
        "normal": "0.000054325",
        "medium": "0.001",
        "fast": "0.020171544"
      }
    },
    "chainType": "evm"
  }
}

响应字段说明

字段	类型	说明
gasPrice	string	普通 Gas 价格（Gwei）
mediumGasPrice	string	中等速度 Gas 价格
fastGasPrice	string	快速 Gas 价格
eip1559.baseFeePerGas	string	EIP-1559 基础费用
eip1559.maxPriorityFeePerGas	string	默认优先费用
eip1559.maxPriorityFeePerGasTiered.normal	string	普通档优先费
eip1559.maxPriorityFeePerGasTiered.medium	string	中等档优先费
eip1559.maxPriorityFeePerGasTiered.fast	string	快速档优先费
chainType	string	链类型，如 `evm`

交易广播

将已签名的原始交易广播到链上。

请求路径： POST /bgw-pro/chain/public/send

请求参数

参数	类型	是否必填	参数说明
chain	string	是	链标识，如 eth、bnb、sol、trx 等
sig	string	是	已签名的原始交易（hex 或 base64，视链而定）
useMevProtect	bool	否	是否开启 MEV 保护

请求示例


{
  "chain": "eth",
  "sig": "0xf86c808504a817c800825208940x1234...880de0b6b3a76400008025a0...",
  "useMevProtect": true
}

响应示例


{
  "code": 0,
  "message": "success",
  "data": {
    "txid": "0xabc123..."
  }
}

交易详情查询

从链上查询单笔交易详情；成功时直接返回交易详情对象，不使用 { code, message, data } 包装。

请求路径： POST /bgw-pro/chain/public/getDetail

请求参数

参数	类型	是否必填	参数说明
chain	string	是	链标识，如 eth、arbitrum、sol 等
txid	string	是	链上交易 hash

请求示例


{
  "chain": "arbitrum",
  "txid": "0x1dd7a1610eb303084e716c71cd2b32008631b610bc5d922e272c5a049ccbc140"
}

响应示例


{
  "txid": "0x1dd7a1610eb303084e716c71cd2b32008631b610bc5d922e272c5a049ccbc140",
  "status": 1,
  "height": 464149490,
  "time": 1779115993,
  "from": "0x69a1ad2dc946256e8871bc75abc565c41422cef5",
  "to": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
  "value": "0",
  "fee": 7.02331846e-7,
  "feeData": {
    "coin": "eth",
    "gasPriceText": "0.020026 Gwei",
    "gasPrice": "0.000000000020026",
    "gasLimit": 49137,
    "gasUsed": 35071
  },
  "nonce": 98,
  "transfers": [
    {
      "contract": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
      "from": "0x69a1ad2dc946256e8871bc75abc565c41422cef5",
      "to": "0x000000000022d473030f116ddee9f6b43ac78ba3",
      "value": "0",
      "type": "approval",
      "symbol": "USDC",
      "name": "USD Coin"
    }
  ],
  "data": "0x095ea7b3000000000000000000000000000000000022d473030f116ddee9f6b43ac78ba30000000000000000000000000000000000000000000000000000000000000000",
  "symbol": "eth"
}

响应字段说明

字段	类型	说明
txid	string	交易 hash
status	number	交易状态：`1` 成功，`2` 失败，`0` 待确认（部分链）；查询失败时可能返回 `{ status, errorMsg, txId }`
height	number	区块高度 / slot
time	number	区块时间戳（秒）
from	string	发起方地址
to	string	接收方地址
value	string / number	主币转账金额
fee	number	手续费
feeData	object	手续费明细（结构因链而异）
transfers	array	转账 / 授权记录
symbol	string	主币符号（EVM 链）
nonce	number	交易 nonce（EVM 链）
data	string	input data（EVM 链）