链上交易 API

端点https://web3.binance.com/build

下载Schema

获取链上交易支持的链

返回 Transaction 服务当前支持的区块链列表（用于 Gas 估算、模拟和广播）。支持链由服务端动态配置，可能随时变更。

GET

/api/v1/dex/pre-transaction/supported/chain

https://web3.binance.com/build

获取链上交易支持的链 › 授权

这是一个签名端点，必须在请求头中包含签名。了解如何生成有效签名，请参考认证。

获取链上交易支持的链 › 请求头

X-OC-APIKEY

string · 必须

Binance Web3 API 颁发的用于鉴权的 API Key。

示例： your-api-key-here

X-OC-TIMESTAMP

string · 必须

当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。

示例： 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · 必须

请求签名（Base64 编码）。

示例： Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

允许的时间偏差（毫秒），默认值 5000，最大值 60000。

示例： 5000

X-OC-NONCE

string

唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。

示例： unique-nonce-string

获取链上交易支持的链 › 响应

成功返回支持的链列表。

code

integer · int32

业务状态码，0 表示成功，非 0 表示业务错误。

示例： 0

msg

string

状态描述信息。

示例： success

object[]

支持的区块链网络列表。

timestamp

integer · int64

服务端响应时间戳（毫秒）。

示例： 1748601600000

success

boolean

由 code == 0 派生的便捷布尔值。

示例： true

获取 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。

GET

/api/v1/dex/pre-transaction/gas-price

https://web3.binance.com/build

获取 Gas 价格 › 授权

这是一个签名端点，必须在请求头中包含签名。了解如何生成有效签名，请参考认证。

获取 Gas 价格 › 请求头

X-OC-APIKEY

string · 必须

Binance Web3 API 颁发的用于鉴权的 API Key。

示例： your-api-key-here

X-OC-TIMESTAMP

string · 必须

当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。

示例： 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · 必须

请求签名（Base64 编码）。

示例： Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

允许的时间偏差（毫秒），默认值 5000，最大值 60000。

示例： 5000

X-OC-NONCE

string

唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。

示例： unique-nonce-string

获取 Gas 价格 › 查询参数

binanceChainId

string · 必须

链唯一标识（如 "1"=Ethereum，"56"=BSC，"CT_501"=Solana，"CT_195"=Tron）。

示例： 1

获取 Gas 价格 › 响应

指定链当前的 Gas 价格。

code

integer · int32

业务状态码，0 表示成功。

示例： 0

msg

string

示例： success

object

Gas 价格详情，填充字段取决于链族。

timestamp

integer · int64

示例： 1748601600000

success

boolean

示例： true

GET/api/v1/dex/pre-transaction/gas-price

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/pre-transaction/gas-price?binanceChainId=%3Cstring%3E' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

示例响应

{
  "code": 0,
  "msg": "success",
  "data": {
    "evmLegacyGasPrice": {
      "lowGasPrice": "1000000000",
      "mediumGasPrice": "2000000000",
      "highGasPrice": "5000000000"
    },
    "eip1559GasPrice": {
      "baseFee": "1500000000",
      "lowPriorityFee": "100000000",
      "lowMaxFee": "1700000000",
      "mediumPriorityFee": "500000000",
      "mediumMaxFee": "2200000000",
      "highPriorityFee": "1000000000",
      "highMaxFee": "3000000000"
    },
    "solanaGasPrice": {
      "lowComputeUnitPrice": "500",
      "lowJitoTip": "10000",
      "mediumComputeUnitPrice": "1000",
      "mediumJitoTip": "50000",
      "highComputeUnitPrice": "5000",
      "highJitoTip": "200000"
    }
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

获取最新区块高度

返回 Binance Web3 节点在指定链上当前同步到的最新区块高度。调用方可据此监控节点同步进度，用于风控以检测节点是否落后于主链高度。

GET

/api/v1/dex/pre-transaction/block-height

https://web3.binance.com/build

获取最新区块高度 › 授权

这是一个签名端点，必须在请求头中包含签名。了解如何生成有效签名，请参考认证。

获取最新区块高度 › 请求头

X-OC-APIKEY

string · 必须

Binance Web3 API 颁发的用于鉴权的 API Key。

示例： your-api-key-here

X-OC-TIMESTAMP

string · 必须

当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。

示例： 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · 必须

请求签名（Base64 编码）。

示例： Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

允许的时间偏差（毫秒），默认值 5000，最大值 60000。

示例： 5000

X-OC-NONCE

string

唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。

示例： unique-nonce-string

获取最新区块高度 › 查询参数

binanceChainId

string · 必须

链唯一标识（如 "1"=Ethereum，"56"=BSC，"CT_501"=Solana，"CT_195"=Tron）。

示例： 1

获取最新区块高度 › 响应

指定链的最新区块高度。

code

integer · int32

业务状态码，0 表示成功，非 0 表示业务错误。

示例： 0

msg

string

状态描述信息。

示例： success

object

最新区块高度信息。

timestamp

integer · int64

服务端响应时间戳（毫秒）。

示例： 1748601600000

success

boolean

由 code == 0 派生的便捷布尔值。

示例： true

估算 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 字段描述资源消耗与定价。

POST

/api/v1/dex/pre-transaction/gas-limit

https://web3.binance.com/build

估算 Gas Limit › 授权

这是一个签名端点，必须在请求头中包含签名。了解如何生成有效签名，请参考认证。

估算 Gas Limit › 请求头

X-OC-APIKEY

string · 必须

Binance Web3 API 颁发的用于鉴权的 API Key。

示例： your-api-key-here

X-OC-TIMESTAMP

string · 必须

当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。

示例： 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · 必须

请求签名（Base64 编码）。

示例： Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

允许的时间偏差（毫秒），默认值 5000，最大值 60000。

示例： 5000

X-OC-NONCE

string

唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。

示例： unique-nonce-string

估算 Gas Limit › 请求体

binanceChainId

string · 必须

链唯一标识（如 "1"=Ethereum，"56"=BSC，"CT_501"=Solana，"CT_195"=Tron）。 EVM 链提供 evmTx，Solana 链提供 solTx，Tron 链提供 tronTx，三者必须且只能提供其一。注：evmTx、solTx 与 tronTx 在 schema 中均标记为 required，仅为渲染需要；实际调用时按 binanceChainId 三选一传入。

示例： 1

object · 必须

EVM 交易体。binanceChainId 为 EVM 链时必填。

示例： {"from":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","to":"0xdAC17F958D2ee523a2206206994597C13D831ec7","value":"0","data":"0xa9059cbb000000000000000000000000d8dA6BF26964aF9D7eEd9e03E53415D37aA960450000000000000000000000000000000000000000000000000000000000f4240"}

object · 必须

Solana 交易体。binanceChainId=CT_501 时必填。

示例： {"base64Tx":"AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAECAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQEAAA=="}

object · 必须

Tron 交易体。binanceChainId=CT_195 时必填。

估算 Gas Limit › 响应

估算的 Gas Limit。

code

integer · int32

示例： 0

msg

string

示例： success

object

估算的 Gas Limit。Tron 链响应会额外返回 energy/bandwidth 字段，不适用的字段为 null。

timestamp

integer · int64

示例： 1748601600000

success

boolean

示例： true

POST/api/v1/dex/pre-transaction/gas-limit

curl --request POST \
  --url https://web3.binance.com/build/api/v1/dex/pre-transaction/gas-limit \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "binanceChainId": "1",
  "evmTx": {
    "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "value": "0",
    "data": "0xa9059cbb000000000000000000000000d8dA6BF26964aF9D7eEd9e03E53415D37aA960450000000000000000000000000000000000000000000000000000000000f4240"
  }
}
'

示例请求体

{
  "binanceChainId": "1",
  "evmTx": {
    "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "value": "0",
    "data": "0xa9059cbb000000000000000000000000d8dA6BF26964aF9D7eEd9e03E53415D37aA960450000000000000000000000000000000000000000000000000000000000f4240"
  }
}

json

application/json

示例响应

{
  "code": 0,
  "msg": "success",
  "data": {
    "gasLimit": "21000",
    "energyRequired": "15000",
    "bandwidthRequired": "268",
    "freeEnergy": "14145",
    "freeBandwidth": "600",
    "energyFee": "210",
    "bandwidthFee": "1000"
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

模拟交易

在广播前对交易进行链下模拟，预测执行结果。响应包含预测的执行状态、各账户/代币余额变化以及 ERC-20 授权变化（EVM 链）。根据 binanceChainId 提供 evmTx（EVM 链）、solTx（Solana 链）或 tronTx（Tron 链，"CT_195"）。Tron 链下 allowanceChanges 返回空数组。注意：本接口不支持 Metis 链（chainId 1088）。

POST

/api/v1/dex/pre-transaction/simulate

https://web3.binance.com/build

模拟交易 › 授权

这是一个签名端点，必须在请求头中包含签名。了解如何生成有效签名，请参考认证。

模拟交易 › 请求头

X-OC-APIKEY

string · 必须

Binance Web3 API 颁发的用于鉴权的 API Key。

示例： your-api-key-here

X-OC-TIMESTAMP

string · 必须

当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。

示例： 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · 必须

请求签名（Base64 编码）。

示例： Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

允许的时间偏差（毫秒），默认值 5000，最大值 60000。

示例： 5000

X-OC-NONCE

string

唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。

示例： unique-nonce-string

模拟交易 › 请求体

binanceChainId

string · 必须

示例： 1

object · 必须

EVM 交易体。binanceChainId 为 EVM 链时必填。

object · 必须

Solana 交易体。binanceChainId=CT_501 时必填。

object · 必须

Tron 交易体。binanceChainId=CT_195 时必填。

模拟交易 › 响应

模拟结果。

code

integer · int32

示例： 0

msg

string

示例： success

object

timestamp

integer · int64

示例： 1748601600000

success

boolean

示例： true

POST/api/v1/dex/pre-transaction/simulate

curl --request POST \
  --url https://web3.binance.com/build/api/v1/dex/pre-transaction/simulate \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "binanceChainId": "1",
  "evmTx": {
    "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "value": "0",
    "data": "0xa9059cbb000000000000000000000000d8dA6BF26964aF9D7eEd9e03E53415D37aA960450000000000000000000000000000000000000000000000000000000000f4240"
  }
}
'

示例请求体

{
  "binanceChainId": "1",
  "evmTx": {
    "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "value": "0",
    "data": "0xa9059cbb000000000000000000000000d8dA6BF26964aF9D7eEd9e03E53415D37aA960450000000000000000000000000000000000000000000000000000000000f4240"
  }
}

json

application/json

示例响应

{
  "code": 0,
  "msg": "success",
  "data": {
    "status": "SUCCESS",
    "failReason": "execution reverted: ERC20InsufficientBalance",
    "balanceChanges": [
      {
        "contractAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
        "tokenType": "ERC20",
        "change": "-1000000",
        "owner": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      }
    ],
    "allowanceChanges": [
      {
        "tokenAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
        "owner": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
        "spender": "0x1111111254EEB25477B68fb85Ed929f73A960582",
        "preAmount": "0",
        "postAmount": "1000000"
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

广播交易

通过 Binance Web3 API 中继将客户端已签名的交易广播到链上。返回 txHash 以及内部 orderId，可用于通过 post-transaction 服务跟踪链上状态。可选的 MEV 保护（仅 EVM 链）会通过私有 mempool 转发交易，缓解抢跑与三明治攻击。 Tron 和 Solana 不支持 MEV 保护，该参数在这两条链上会被忽略。

POST

/api/v1/dex/pre-transaction/broadcast-transaction

https://web3.binance.com/build

广播交易 › 授权

这是一个签名端点，必须在请求头中包含签名。了解如何生成有效签名，请参考认证。

广播交易 › 请求头

X-OC-APIKEY

string · 必须

Binance Web3 API 颁发的用于鉴权的 API Key。

示例： your-api-key-here

X-OC-TIMESTAMP

string · 必须

当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。

示例： 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · 必须

请求签名（Base64 编码）。

示例： Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

允许的时间偏差（毫秒），默认值 5000，最大值 60000。

示例： 5000

X-OC-NONCE

string

唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。

示例： unique-nonce-string

广播交易 › 请求体

binanceChainId

string · 必须

链唯一标识（如 "1"=Ethereum，"56"=BSC，"CT_501"=Solana，"CT_195"=Tron）。

示例： 1

signedTransaction

string · 必须

客户端签名后的原始交易。格式取决于 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。

示例： 0xf86c808504a817c80082520894d8da6bf26964af9d7eed9e03e53415d37aa96045880de0b6b3a76400008025a0...

address

string · 必须

发起方钱包地址，用于状态归属和签名校验。Tron 和 Solana 上为大小写敏感的 base58check 地址。

示例： 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

enableMevProtection

boolean

为 true 时通过私有 mempool 转发以启用 MEV 保护。

示例： false

广播交易 › 响应

交易广播成功。

code

integer · int32

示例： 0

msg

string

示例： success

object

timestamp

integer · int64

示例： 1748601600000

success

boolean

示例： true

POST/api/v1/dex/pre-transaction/broadcast-transaction

curl --request POST \
  --url https://web3.binance.com/build/api/v1/dex/pre-transaction/broadcast-transaction \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "binanceChainId": "1",
  "signedTransaction": "0xf86c808504a817c80082520894d8da6bf26964af9d7eed9e03e53415d37aa96045880de0b6b3a76400008025a0...",
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}
'

示例请求体

{
  "binanceChainId": "1",
  "signedTransaction": "0xf86c808504a817c80082520894d8da6bf26964af9d7eed9e03e53415d37aa96045880de0b6b3a76400008025a0...",
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}

json

示例响应

{
  "code": 0,
  "msg": "success",
  "data": {
    "orderId": "1812345678901234567",
    "txHash": "0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890"
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

查询广播订单

查询通过 /pre-transaction/broadcast-transaction 提交的广播订单。支持按 txStatus 或 orderId 过滤，并通过 cursor 分页。

GET

/api/v1/dex/post-transaction/orders

https://web3.binance.com/build

查询广播订单 › 授权

这是一个签名端点，必须在请求头中包含签名。了解如何生成有效签名，请参考认证。

查询广播订单 › 请求头

X-OC-APIKEY

string · 必须

Binance Web3 API 颁发的用于鉴权的 API Key。

示例： your-api-key-here

X-OC-TIMESTAMP

string · 必须

当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。

示例： 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · 必须

请求签名（Base64 编码）。

示例： Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

允许的时间偏差（毫秒），默认值 5000，最大值 60000。

示例： 5000

X-OC-NONCE

string

唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。

示例： unique-nonce-string

查询广播订单 › 查询参数

address

string · 必须

待查询的发起方钱包地址。

示例： 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

binanceChainId

string · 必须

链唯一标识。

示例： 1

txStatus

string

可选的交易状态筛选（服务端定义字符串，如 "pending"、"success"、"fail"）。

示例： success

orderId

string

可选的内部订单 ID 筛选。

示例： 1812345678901234567

cursor

string

上次响应返回的分页游标。首次请求不传。

示例： eyJ0aW1lIjoxNzQ4NjAwMDAwMDAwLCJpZCI6MTIzfQ==

limit

integer · int32

每页返回数量，默认 20。

示例： 20

默认值： 20

查询广播订单 › 响应

成功返回订单列表。

code

integer · int32

示例： 0

msg

string

示例： success

object

timestamp

integer · int64

示例： 1748601600000

success

boolean

示例： true

GET/api/v1/dex/post-transaction/orders

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/post-transaction/orders?address=%3Cstring%3E&binanceChainId=%3Cstring%3E' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

示例响应

{
  "code": 0,
  "msg": "success",
  "data": {
    "cursor": "eyJ0aW1lIjoxNzQ4NTk5MDAwMDAwLCJpZCI6Nzh9",
    "orders": [
      {
        "orderId": "1812345678901234567",
        "binanceChainId": "1",
        "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
        "txHash": "0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890",
        "txStatus": "success",
        "failReason": "execution reverted: insufficient liquidity"
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

链上交易 API

端点https://web3.binance.com/build

下载Schema

获取链上交易支持的链

返回 Transaction 服务当前支持的区块链列表（用于 Gas 估算、模拟和广播）。支持链由服务端动态配置，可能随时变更。

GET

/api/v1/dex/pre-transaction/supported/chain

https://web3.binance.com/build

获取链上交易支持的链 › 授权

这是一个签名端点，必须在请求头中包含签名。了解如何生成有效签名，请参考认证。

获取链上交易支持的链 › 请求头

X-OC-APIKEY

string · 必须

Binance Web3 API 颁发的用于鉴权的 API Key。

示例： your-api-key-here

X-OC-TIMESTAMP

string · 必须

当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。

示例： 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · 必须

请求签名（Base64 编码）。

示例： Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

允许的时间偏差（毫秒），默认值 5000，最大值 60000。

示例： 5000

X-OC-NONCE

string

唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。

示例： unique-nonce-string

获取链上交易支持的链 › 响应

成功返回支持的链列表。

code

integer · int32

业务状态码，0 表示成功，非 0 表示业务错误。

示例： 0

msg

string

状态描述信息。

示例： success

object[]

支持的区块链网络列表。

timestamp

integer · int64

服务端响应时间戳（毫秒）。

示例： 1748601600000

success

boolean

由 code == 0 派生的便捷布尔值。

示例： true

获取 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。

GET

/api/v1/dex/pre-transaction/gas-price

https://web3.binance.com/build

获取 Gas 价格 › 授权

这是一个签名端点，必须在请求头中包含签名。了解如何生成有效签名，请参考认证。

获取 Gas 价格 › 请求头

X-OC-APIKEY

string · 必须

Binance Web3 API 颁发的用于鉴权的 API Key。

示例： your-api-key-here

X-OC-TIMESTAMP

string · 必须

当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。

示例： 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · 必须

请求签名（Base64 编码）。

示例： Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

允许的时间偏差（毫秒），默认值 5000，最大值 60000。

示例： 5000

X-OC-NONCE

string

唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。

示例： unique-nonce-string

获取 Gas 价格 › 查询参数

binanceChainId

string · 必须

链唯一标识（如 "1"=Ethereum，"56"=BSC，"CT_501"=Solana，"CT_195"=Tron）。

示例： 1

获取 Gas 价格 › 响应

指定链当前的 Gas 价格。

code

integer · int32

业务状态码，0 表示成功。

示例： 0

msg

string

示例： success

object

Gas 价格详情，填充字段取决于链族。

timestamp

integer · int64

示例： 1748601600000

success

boolean

示例： true

GET/api/v1/dex/pre-transaction/gas-price

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/pre-transaction/gas-price?binanceChainId=%3Cstring%3E' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

示例响应

{
  "code": 0,
  "msg": "success",
  "data": {
    "evmLegacyGasPrice": {
      "lowGasPrice": "1000000000",
      "mediumGasPrice": "2000000000",
      "highGasPrice": "5000000000"
    },
    "eip1559GasPrice": {
      "baseFee": "1500000000",
      "lowPriorityFee": "100000000",
      "lowMaxFee": "1700000000",
      "mediumPriorityFee": "500000000",
      "mediumMaxFee": "2200000000",
      "highPriorityFee": "1000000000",
      "highMaxFee": "3000000000"
    },
    "solanaGasPrice": {
      "lowComputeUnitPrice": "500",
      "lowJitoTip": "10000",
      "mediumComputeUnitPrice": "1000",
      "mediumJitoTip": "50000",
      "highComputeUnitPrice": "5000",
      "highJitoTip": "200000"
    }
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

获取最新区块高度

返回 Binance Web3 节点在指定链上当前同步到的最新区块高度。调用方可据此监控节点同步进度，用于风控以检测节点是否落后于主链高度。

GET

/api/v1/dex/pre-transaction/block-height

https://web3.binance.com/build

获取最新区块高度 › 授权

这是一个签名端点，必须在请求头中包含签名。了解如何生成有效签名，请参考认证。

获取最新区块高度 › 请求头

X-OC-APIKEY

string · 必须

Binance Web3 API 颁发的用于鉴权的 API Key。

示例： your-api-key-here

X-OC-TIMESTAMP

string · 必须

当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。

示例： 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · 必须

请求签名（Base64 编码）。

示例： Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

允许的时间偏差（毫秒），默认值 5000，最大值 60000。

示例： 5000

X-OC-NONCE

string

唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。

示例： unique-nonce-string

获取最新区块高度 › 查询参数

binanceChainId

string · 必须

链唯一标识（如 "1"=Ethereum，"56"=BSC，"CT_501"=Solana，"CT_195"=Tron）。

示例： 1

获取最新区块高度 › 响应

指定链的最新区块高度。

code

integer · int32

业务状态码，0 表示成功，非 0 表示业务错误。

示例： 0

msg

string

状态描述信息。

示例： success

object

最新区块高度信息。

timestamp

integer · int64

服务端响应时间戳（毫秒）。

示例： 1748601600000

success

boolean

由 code == 0 派生的便捷布尔值。

示例： true

估算 Gas Limit

POST

/api/v1/dex/pre-transaction/gas-limit

https://web3.binance.com/build

估算 Gas Limit › 授权

这是一个签名端点，必须在请求头中包含签名。了解如何生成有效签名，请参考认证。

估算 Gas Limit › 请求头

X-OC-APIKEY

string · 必须

Binance Web3 API 颁发的用于鉴权的 API Key。

示例： your-api-key-here

X-OC-TIMESTAMP

string · 必须

当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。

示例： 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · 必须

请求签名（Base64 编码）。

示例： Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

允许的时间偏差（毫秒），默认值 5000，最大值 60000。

示例： 5000

X-OC-NONCE

string

唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。

示例： unique-nonce-string

估算 Gas Limit › 请求体

binanceChainId

string · 必须

示例： 1

object · 必须

EVM 交易体。binanceChainId 为 EVM 链时必填。

object · 必须

Solana 交易体。binanceChainId=CT_501 时必填。

object · 必须

Tron 交易体。binanceChainId=CT_195 时必填。

估算 Gas Limit › 响应

估算的 Gas Limit。

code

integer · int32

示例： 0

msg

string

示例： success

object

估算的 Gas Limit。Tron 链响应会额外返回 energy/bandwidth 字段，不适用的字段为 null。

timestamp

integer · int64

示例： 1748601600000

success

boolean

示例： true

POST/api/v1/dex/pre-transaction/gas-limit

curl --request POST \
  --url https://web3.binance.com/build/api/v1/dex/pre-transaction/gas-limit \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "binanceChainId": "1",
  "evmTx": {
    "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "value": "0",
    "data": "0xa9059cbb000000000000000000000000d8dA6BF26964aF9D7eEd9e03E53415D37aA960450000000000000000000000000000000000000000000000000000000000f4240"
  }
}
'

示例请求体

{
  "binanceChainId": "1",
  "evmTx": {
    "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "value": "0",
    "data": "0xa9059cbb000000000000000000000000d8dA6BF26964aF9D7eEd9e03E53415D37aA960450000000000000000000000000000000000000000000000000000000000f4240"
  }
}

json

application/json

示例响应

{
  "code": 0,
  "msg": "success",
  "data": {
    "gasLimit": "21000",
    "energyRequired": "15000",
    "bandwidthRequired": "268",
    "freeEnergy": "14145",
    "freeBandwidth": "600",
    "energyFee": "210",
    "bandwidthFee": "1000"
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

模拟交易

POST

/api/v1/dex/pre-transaction/simulate

https://web3.binance.com/build

模拟交易 › 授权

这是一个签名端点，必须在请求头中包含签名。了解如何生成有效签名，请参考认证。

模拟交易 › 请求头

X-OC-APIKEY

string · 必须

Binance Web3 API 颁发的用于鉴权的 API Key。

示例： your-api-key-here

X-OC-TIMESTAMP

string · 必须

当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。

示例： 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · 必须

请求签名（Base64 编码）。

示例： Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

允许的时间偏差（毫秒），默认值 5000，最大值 60000。

示例： 5000

X-OC-NONCE

string

唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。

示例： unique-nonce-string

模拟交易 › 请求体

binanceChainId

string · 必须

示例： 1

object · 必须

EVM 交易体。binanceChainId 为 EVM 链时必填。

object · 必须

Solana 交易体。binanceChainId=CT_501 时必填。

object · 必须

Tron 交易体。binanceChainId=CT_195 时必填。

模拟交易 › 响应

模拟结果。

code

integer · int32

示例： 0

msg

string

示例： success

object

timestamp

integer · int64

示例： 1748601600000

success

boolean

示例： true

POST/api/v1/dex/pre-transaction/simulate

curl --request POST \
  --url https://web3.binance.com/build/api/v1/dex/pre-transaction/simulate \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "binanceChainId": "1",
  "evmTx": {
    "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "value": "0",
    "data": "0xa9059cbb000000000000000000000000d8dA6BF26964aF9D7eEd9e03E53415D37aA960450000000000000000000000000000000000000000000000000000000000f4240"
  }
}
'

示例请求体

{
  "binanceChainId": "1",
  "evmTx": {
    "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "value": "0",
    "data": "0xa9059cbb000000000000000000000000d8dA6BF26964aF9D7eEd9e03E53415D37aA960450000000000000000000000000000000000000000000000000000000000f4240"
  }
}

json

application/json

示例响应

{
  "code": 0,
  "msg": "success",
  "data": {
    "status": "SUCCESS",
    "failReason": "execution reverted: ERC20InsufficientBalance",
    "balanceChanges": [
      {
        "contractAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
        "tokenType": "ERC20",
        "change": "-1000000",
        "owner": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      }
    ],
    "allowanceChanges": [
      {
        "tokenAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
        "owner": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
        "spender": "0x1111111254EEB25477B68fb85Ed929f73A960582",
        "preAmount": "0",
        "postAmount": "1000000"
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

广播交易

POST

/api/v1/dex/pre-transaction/broadcast-transaction

https://web3.binance.com/build

广播交易 › 授权

这是一个签名端点，必须在请求头中包含签名。了解如何生成有效签名，请参考认证。

广播交易 › 请求头

X-OC-APIKEY

string · 必须

Binance Web3 API 颁发的用于鉴权的 API Key。

示例： your-api-key-here

X-OC-TIMESTAMP

string · 必须

当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。

示例： 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · 必须

请求签名（Base64 编码）。

示例： Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

允许的时间偏差（毫秒），默认值 5000，最大值 60000。

示例： 5000

X-OC-NONCE

string

唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。

示例： unique-nonce-string

广播交易 › 请求体

binanceChainId

string · 必须

链唯一标识（如 "1"=Ethereum，"56"=BSC，"CT_501"=Solana，"CT_195"=Tron）。

示例： 1

signedTransaction

string · 必须

客户端签名后的原始交易。格式取决于 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":["..."]}。

示例： 0xf86c808504a817c80082520894d8da6bf26964af9d7eed9e03e53415d37aa96045880de0b6b3a76400008025a0...

address

string · 必须

发起方钱包地址，用于状态归属和签名校验。Tron 和 Solana 上为大小写敏感的 base58check 地址。

示例： 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

enableMevProtection

boolean

为 true 时通过私有 mempool 转发以启用 MEV 保护。

示例： false

广播交易 › 响应

交易广播成功。

code

integer · int32

示例： 0

msg

string

示例： success

object

timestamp

integer · int64

示例： 1748601600000

success

boolean

示例： true

POST/api/v1/dex/pre-transaction/broadcast-transaction

curl --request POST \
  --url https://web3.binance.com/build/api/v1/dex/pre-transaction/broadcast-transaction \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "binanceChainId": "1",
  "signedTransaction": "0xf86c808504a817c80082520894d8da6bf26964af9d7eed9e03e53415d37aa96045880de0b6b3a76400008025a0...",
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}
'

示例请求体

{
  "binanceChainId": "1",
  "signedTransaction": "0xf86c808504a817c80082520894d8da6bf26964af9d7eed9e03e53415d37aa96045880de0b6b3a76400008025a0...",
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}

json

示例响应

{
  "code": 0,
  "msg": "success",
  "data": {
    "orderId": "1812345678901234567",
    "txHash": "0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890"
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

查询广播订单

查询通过 /pre-transaction/broadcast-transaction 提交的广播订单。支持按 txStatus 或 orderId 过滤，并通过 cursor 分页。

GET

/api/v1/dex/post-transaction/orders

https://web3.binance.com/build

查询广播订单 › 授权

这是一个签名端点，必须在请求头中包含签名。了解如何生成有效签名，请参考认证。

查询广播订单 › 请求头

X-OC-APIKEY

string · 必须

Binance Web3 API 颁发的用于鉴权的 API Key。

示例： your-api-key-here

X-OC-TIMESTAMP

string · 必须

当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。

示例： 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · 必须

请求签名（Base64 编码）。

示例： Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

允许的时间偏差（毫秒），默认值 5000，最大值 60000。

示例： 5000

X-OC-NONCE

string

唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。

示例： unique-nonce-string

查询广播订单 › 查询参数

address

string · 必须

待查询的发起方钱包地址。

示例： 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

binanceChainId

string · 必须

链唯一标识。

示例： 1

txStatus

string

可选的交易状态筛选（服务端定义字符串，如 "pending"、"success"、"fail"）。

示例： success

orderId

string

可选的内部订单 ID 筛选。

示例： 1812345678901234567

cursor

string

上次响应返回的分页游标。首次请求不传。

示例： eyJ0aW1lIjoxNzQ4NjAwMDAwMDAwLCJpZCI6MTIzfQ==

limit

integer · int32

每页返回数量，默认 20。

示例： 20

默认值： 20

查询广播订单 › 响应

成功返回订单列表。

code

integer · int32

示例： 0

msg

string

示例： success

object

timestamp

integer · int64

示例： 1748601600000

success

boolean

示例： true

GET/api/v1/dex/post-transaction/orders

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/post-transaction/orders?address=%3Cstring%3E&binanceChainId=%3Cstring%3E' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

示例响应

{
  "code": 0,
  "msg": "success",
  "data": {
    "cursor": "eyJ0aW1lIjoxNzQ4NTk5MDAwMDAwLCJpZCI6Nzh9",
    "orders": [
      {
        "orderId": "1812345678901234567",
        "binanceChainId": "1",
        "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
        "txHash": "0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890",
        "txStatus": "success",
        "failReason": "execution reverted: insufficient liquidity"
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json