获取链上交易支持的链
返回 Transaction 服务当前支持的区块链列表(用于 Gas 估算、模拟和广播)。 支持链由服务端动态配置,可能随时变更。
获取链上交易支持的链 › 授权
请求头
X-OC-APIKEYBinance Web3 API 颁发的用于鉴权的 API Key。
X-OC-TIMESTAMP当前 UTC 时间,ISO 8601 格式,精确到毫秒,例如 2026-05-11T10:08:57.715Z。
X-OC-SIGN请求签名(Base64 编码)。
X-OC-RECV-WINDOW允许的时间偏差(毫秒),默认值 5000,最大值 60000。
X-OC-NONCE唯一请求标识符,用于防重放攻击;省略时使用 X-OC-SIGN 代替。
获取链上交易支持的链 › 响应
成功返回支持的链列表。
code业务状态码,0 表示成功,非 0 表示业务错误。
msg状态描述信息。
支持的区块链网络列表。
binanceChainId链唯一标识(EVM 链遵循 EIP-155 chainId;如 "1"=Ethereum,"56"=BSC,"CT_501"=Solana,"CT_195"=Tron)。
name链全称。
shortName链简称。
logoUrl链 Logo 图片 URL。
timestamp服务端响应时间戳(毫秒)。
success由 code == 0 派生的便捷布尔值。
获取 Gas 价格
查询指定链当前的网络 Gas 价格。返回结构因链族而异:
- EVM 链:同时返回
evmLegacyGasPrice(传统 gasPrice)和eip1559GasPrice(baseFee + priority/max fee,链支持 EIP-1559 时)。 - Solana 链:返回solanaGasPrice(compute-unit 价格和 Jito 小费)。 - Tron 链("CT_195"):返回空data对象,因为 Tron 没有链上 Gas 价格概念,请改用 gas-limit 接口。 与当前链族无关的字段为null。
获取 Gas 价格 › 授权
请求头
X-OC-APIKEYBinance Web3 API 颁发的用于鉴权的 API Key。
X-OC-TIMESTAMP当前 UTC 时间,ISO 8601 格式,精确到毫秒,例如 2026-05-11T10:08:57.715Z。
X-OC-SIGN请求签名(Base64 编码)。
X-OC-RECV-WINDOW允许的时间偏差(毫秒),默认值 5000,最大值 60000。
X-OC-NONCE唯一请求标识符,用于防重放攻击;省略时使用 X-OC-SIGN 代替。
获取 Gas 价格 › 响应
指定链当前的 Gas 价格。
code业务状态码,0 表示成功。
msgGas 价格详情,填充字段取决于链族。
evmLegacyGasPriceEVM 传统 gasPrice 三档(wei,整数字符串)。非 EVM 链为 null。
eip1559GasPriceEIP-1559 费用结构(wei,整数字符串)。不支持 EIP-1559 或非 EVM 链为 null。
solanaGasPriceSolana 链 compute-unit 价格与 Jito 小费。非 Solana 链为 null。
timestampsuccess获取最新区块高度
返回 Binance Web3 节点在指定链上当前同步到的最新区块高度。调用方可据此监控节点同步进度, 用于风控以检测节点是否落后于主链高度。
获取最新区块高度 › 授权
请求头
X-OC-APIKEYBinance Web3 API 颁发的用于鉴权的 API Key。
X-OC-TIMESTAMP当前 UTC 时间,ISO 8601 格式,精确到毫秒,例如 2026-05-11T10:08:57.715Z。
X-OC-SIGN请求签名(Base64 编码)。
X-OC-RECV-WINDOW允许的时间偏差(毫秒),默认值 5000,最大值 60000。
X-OC-NONCE唯一请求标识符,用于防重放攻击;省略时使用 X-OC-SIGN 代替。
获取最新区块高度 › 响应
指定链的最新区块高度。
code业务状态码,0 表示成功,非 0 表示业务错误。
msg状态描述信息。
最新区块高度信息。
binanceChainId请求中传入的链标识,原样回传。
blockHeightBinance Web3 节点跟踪的最新区块高度(Solana 为 slot)。以 64 位整数表示。
timestamp服务端响应时间戳(毫秒)。
success由 code == 0 派生的便捷布尔值。
估算 Gas Limit
为未签名交易估算 Gas Limit(Solana 链则为 compute-unit 上限)。
根据 binanceChainId 提供 evmTx(EVM 链)、solTx(Solana 链)或 tronTx(Tron 链,"CT_195")。
Tron 链的响应返回 energy/bandwidth 相关字段而非单一 gas limit; gasLimit 为 fee limit(单位 sun),energy/bandwidth 字段描述资源消耗与定价。
估算 Gas Limit › 授权
请求头
X-OC-APIKEYBinance Web3 API 颁发的用于鉴权的 API Key。
X-OC-TIMESTAMP当前 UTC 时间,ISO 8601 格式,精确到毫秒,例如 2026-05-11T10:08:57.715Z。
X-OC-SIGN请求签名(Base64 编码)。
X-OC-RECV-WINDOW允许的时间偏差(毫秒),默认值 5000,最大值 60000。
X-OC-NONCE唯一请求标识符,用于防重放攻击;省略时使用 X-OC-SIGN 代替。
估算 Gas Limit › 请求体
binanceChainId链唯一标识(如 "1"=Ethereum,"56"=BSC,"CT_501"=Solana,"CT_195"=Tron)。 EVM 链提供 evmTx,Solana 链提供 solTx,Tron 链提供 tronTx,三者必须且只能提供其一。 注:evmTx、solTx 与 tronTx 在 schema 中均标记为 required,仅为渲染需要;实际调用时按 binanceChainId 三选一传入。
EVM 交易体。binanceChainId 为 EVM 链时必填。
from发起方地址。
to接收方地址(合约或外部账户)。
value原生代币转账金额(wei,整数字符串)。ERC-20 转账填 "0"。
dataABI 编码的 calldata(十六进制)。无合约调用时可省略。
Solana 交易体。binanceChainId=CT_501 时必填。
base64TxBase64 编码的未签名 Solana 交易。
Tron 交易体。binanceChainId=CT_195 时必填。
from发起方地址(base58check)。
txTypeTron 合约类型。TRIGGER_SMART_CONTRACT 需提供 triggerSmartContractParams;TRANSFER_CONTRACT 需提供 transferContractParams。
当 txType=TRIGGER_SMART_CONTRACT 时必填。
contractAddress合约地址(base58check)。
dataABI 编码的 calldata(十六进制,无 0x 前缀)。
callValue附带的 TRX 金额(单位 sun),对应 call_value。
feeLimitSun调用方愿意支付的最大费用(单位 sun),可选。未提供时使用服务端默认值。
当 txType=TRANSFER_CONTRACT 时必填。
toAddress接收方地址(base58check)。
amountTRX 金额(单位 sun,1 TRX = 1_000_000 sun)。
估算 Gas Limit › 响应
估算的 Gas Limit。
codemsg估算的 Gas Limit。Tron 链响应会额外返回 energy/bandwidth 字段,不适用的字段为 null。
gasLimit估算的 Gas Limit(EVM)、compute-unit 上限(Solana)或 fee limit(Tron,单位 sun),整数字符串。
energyRequiredTron 交易消耗的 energy(整数字符串)。非 Tron 链为 null。
bandwidthRequiredTron 交易消耗的 bandwidth(整数字符串)。非 Tron 链为 null。
freeEnergy账户在 Tron 上可用的免费 energy(整数字符串)。非 Tron 链为 null。
freeBandwidth账户在 Tron 上可用的免费 bandwidth(整数字符串)。非 Tron 链为 null。
energyFeeTron 上 energy 的单价(sun/energy,整数字符串)。非 Tron 链为 null。
bandwidthFeeTron 上 bandwidth 的单价(sun/byte,整数字符串)。非 Tron 链为 null。
timestampsuccess模拟交易
在广播前对交易进行链下模拟,预测执行结果。 响应包含预测的执行状态、各账户/代币余额变化以及 ERC-20 授权变化(EVM 链)。
根据 binanceChainId 提供 evmTx(EVM 链)、solTx(Solana 链)或 tronTx(Tron 链,"CT_195")。Tron 链下 allowanceChanges 返回空数组。
注意:本接口不支持 Metis 链(chainId 1088)。
模拟交易 › 授权
请求头
X-OC-APIKEYBinance Web3 API 颁发的用于鉴权的 API Key。
X-OC-TIMESTAMP当前 UTC 时间,ISO 8601 格式,精确到毫秒,例如 2026-05-11T10:08:57.715Z。
X-OC-SIGN请求签名(Base64 编码)。
X-OC-RECV-WINDOW允许的时间偏差(毫秒),默认值 5000,最大值 60000。
X-OC-NONCE唯一请求标识符,用于防重放攻击;省略时使用 X-OC-SIGN 代替。
模拟交易 › 请求体
binanceChainId链唯一标识(如 "1"=Ethereum,"56"=BSC,"CT_501"=Solana,"CT_195"=Tron)。 EVM 链提供 evmTx,Solana 链提供 solTx,Tron 链提供 tronTx,三者必须且只能提供其一。 注:evmTx、solTx 与 tronTx 在 schema 中均标记为 required,仅为渲染需要;实际调用时按 binanceChainId 三选一传入。
EVM 交易体。binanceChainId 为 EVM 链时必填。
from发起方地址。
to接收方地址。
value原生代币转账金额(wei,整数字符串)。
dataABI 编码的 calldata(十六进制),可选。
Solana 交易体。binanceChainId=CT_501 时必填。
base64TxBase64 编码的未签名 Solana 交易。
address用于归属余额变化的 Solana 拥有者 / 付费方地址。
Tron 交易体。binanceChainId=CT_195 时必填。
from发起方地址(base58check),同时用于归属余额变化。
txTypeTron 合约类型。TRIGGER_SMART_CONTRACT 需提供 triggerSmartContractParams;TRANSFER_CONTRACT 需提供 transferContractParams。
当 txType=TRIGGER_SMART_CONTRACT 时必填。
contractAddress合约地址(base58check)。
dataABI 编码的 calldata(十六进制,无 0x 前缀)。
callValue附带的 TRX 金额(单位 sun),对应 call_value。
feeLimitSun调用方愿意支付的最大费用(单位 sun),可选。未提供时使用服务端默认值。
当 txType=TRANSFER_CONTRACT 时必填。
toAddress接收方地址(base58check)。
amountTRX 金额(单位 sun,1 TRX = 1_000_000 sun)。
模拟交易 › 响应
模拟结果。
codemsgstatus预测的执行状态。
failReason当 status=FAILED 时返回失败原因,否则为 null。
模拟交易中预测的余额变化。
contractAddress代币合约地址。原生代币使用空值或链定义的标识。
tokenType代币标准。
change以代币最小单位表示的有符号变化(整数字符串)。负值代表流出,正值代表流入。
owner发生余额变化的地址。
预测的 ERC-20 授权变化(仅 EVM 链)。
tokenAddressERC-20 代币合约地址。
owner代币拥有者地址。
spender授权额度发生变化的 spender 地址。
preAmount交易前的授权额度(最小单位,整数字符串)。
postAmount交易后的授权额度(最小单位,整数字符串)。
timestampsuccess广播交易
通过 Binance Web3 API 中继将客户端已签名的交易广播到链上。返回 txHash 以及内部 orderId, 可用于通过 post-transaction 服务跟踪链上状态。
可选的 MEV 保护(仅 EVM 链)会通过私有 mempool 转发交易,缓解抢跑与三明治攻击。 Tron 和 Solana 不支持 MEV 保护,该参数在这两条链上会被忽略。
广播交易 › 授权
请求头
X-OC-APIKEYBinance Web3 API 颁发的用于鉴权的 API Key。
X-OC-TIMESTAMP当前 UTC 时间,ISO 8601 格式,精确到毫秒,例如 2026-05-11T10:08:57.715Z。
X-OC-SIGN请求签名(Base64 编码)。
X-OC-RECV-WINDOW允许的时间偏差(毫秒),默认值 5000,最大值 60000。
X-OC-NONCE唯一请求标识符,用于防重放攻击;省略时使用 X-OC-SIGN 代替。
广播交易 › 请求体
binanceChainId链唯一标识(如 "1"=Ethereum,"56"=BSC,"CT_501"=Solana,"CT_195"=Tron)。
signedTransaction客户端签名后的原始交易。格式取决于 binanceChainId:
- EVM 链:十六进制 RLP 交易(如
0xf86c...)。 - Solana(
CT_501):base64 编码的已签名交易。 - Tron(
CT_195):由 Tron 签名器返回的已签名交易 JSON 字符串,包含raw_data(其中contract[].parameter.value.owner_address)与signature数组。示例:{"raw_data":{"contract":[{"type":"TriggerSmartContract","parameter":{"value":{"owner_address":"T...","contract_address":"T...","data":"<calldata hex>","call_value":0}}}]},"signature":["..."]}。
Tron 注意事项:signedTransaction 不是 simulate / getGasLimit 接口里 tronTx.triggerSmartContractParams.data 所传的 calldata hex。后端会从 raw_data.contract[0].parameter.value.owner_address 提取签名者 并与 address 校验一致;若误传 calldata hex 将被拒绝,返回 code=40001, invalid signedTransaction: failed to parse Tron signedTransaction: syntax error。
address发起方钱包地址,用于状态归属和签名校验。Tron 和 Solana 上为大小写敏感的 base58check 地址。
enableMevProtection为 true 时通过私有 mempool 转发以启用 MEV 保护。
广播交易 › 响应
交易广播成功。
codemsgorderId内部订单 ID。可通过 post-transaction 服务查询链上状态。
txHash链上交易哈希。EVM 链返回十六进制哈希;Tron 返回 base58check 哈希;Solana 返回 base58 哈希。
timestampsuccess查询广播订单
查询通过 /pre-transaction/broadcast-transaction 提交的广播订单。 支持按 txStatus 或 orderId 过滤,并通过 cursor 分页。
查询广播订单 › 授权
请求头
X-OC-APIKEYBinance Web3 API 颁发的用于鉴权的 API Key。
X-OC-TIMESTAMP当前 UTC 时间,ISO 8601 格式,精确到毫秒,例如 2026-05-11T10:08:57.715Z。
X-OC-SIGN请求签名(Base64 编码)。
X-OC-RECV-WINDOW允许的时间偏差(毫秒),默认值 5000,最大值 60000。
X-OC-NONCE唯一请求标识符,用于防重放攻击;省略时使用 X-OC-SIGN 代替。
查询参数
address待查询的发起方钱包地址。
binanceChainId链唯一标识。
txStatus可选的交易状态筛选(服务端定义字符串,如 "pending"、"success"、"fail")。
orderId可选的内部订单 ID 筛选。
cursor上次响应返回的分页游标。首次请求不传。
limit每页返回数量,默认 20。
查询广播订单 › 响应
成功返回订单列表。
codemsgcursor下一页游标。无更多数据时为空字符串。
订单列表。
orderId内部订单 ID。
binanceChainId链唯一标识。
address发起方钱包地址。
txHash链上交易 Hash。订单 pending 时可能为 null。
txStatus交易状态(服务端定义字符串)。
failReason失败原因。交易失败时有值,否则为 null。
timestampsuccess