钱包 API

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

下载Schema

获取钱包支持的链

返回 Wallet 服务能够查询余额的区块链列表。支持链由服务端动态配置，可能随时变更。传入 binanceChainId 仅返回该链信息；不传则返回全量列表。

GET

/api/v1/dex/balance/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

获取钱包支持的链 › 查询参数

binanceChainId

string

可选的链唯一标识。指定时仅返回对应链；不传则返回全量列表。

示例： 1

获取钱包支持的链 › 响应

成功返回支持的链列表。

code

integer · int32

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

示例： 0

msg

string

示例： success

object[]

支持的区块链网络列表。

timestamp

integer · int64

示例： 1748601600000

success

boolean

示例： true

查询地址全部代币余额

返回地址在一个或多个链上的全部代币余额，支持分页。将 excludeRiskToken=true 可过滤空投风险币与蜜罐币（蜜罐检测当前仅支持 ETH / BSC / SOL / BASE）。

GET

/api/v1/dex/balance/all-token-balances-by-address

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

待查询的钱包地址。

示例： 0xed0c6079229e2d407672a117c22b62064f4a4312

chains

string

链 ID 列表，英文逗号分隔。

示例： 1,56

excludeRiskToken

boolean

是否排除风险代币。

示例： true

page

integer · int64

页码，默认 1。

示例： 1

默认值： 1

pageSize

integer · int32 · min: 1 · max: 100

每页条数，范围 1–100，默认 20。

示例： 20

默认值： 20

查询地址全部代币余额 › 响应

成功返回代币余额。

code

integer · int32

示例： 0

msg

string

示例： success

object[]

每个查询链对应一条记录，包含该链上分页后的代币余额列表。

timestamp

integer · int64

示例： 1748601600000

success

boolean

示例： true

GET/api/v1/dex/balance/all-token-balances-by-address

curl --request GET \
  --url https://web3.binance.com/build/api/v1/dex/balance/all-token-balances-by-address \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

示例响应

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "page": 1,
      "pageSize": 20,
      "tokenAssets": [
        {
          "binanceChainId": "1",
          "tokenContractAddress": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
          "address": "0xed0c6079229e2d407672a117c22b62064f4a4312",
          "symbol": "WBTC",
          "balance": "329.10055205",
          "rawBalance": "32910055205",
          "tokenPrice": "98847.8",
          "isRiskToken": false
        }
      ]
    }
  ],
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

查询地址特定代币余额

查询指定 (链, 合约) 列表的代币余额，单次请求最多 20 条。 excludeRiskToken="0" 过滤风险代币（默认），"1" 不过滤。

POST

/api/v1/dex/balance/token-balances-by-address

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 · 必须

钱包地址。

示例： 0x50c476a139aab23fdaf9bca12614cdd54a4244e3

object[] · maxItems: 20 · 必须

要查询的代币列表，最多 20 条。

excludeRiskToken

string · enum

风险代币筛选。"0"=过滤（默认），"1"=不过滤。蜜罐检测当前仅支持 ETH / BSC / SOL / BASE。

枚举值:

示例： 0

默认值： 0

查询地址特定代币余额 › 响应

成功返回代币余额。

code

integer · int32

示例： 0

msg

string

示例： success

object[]

每条对应请求中出现过的一个链，包含匹配到的代币余额。

timestamp

integer · int64

示例： 1748601600000

success

boolean

示例： true

POST/api/v1/dex/balance/token-balances-by-address

curl --request POST \
  --url https://web3.binance.com/build/api/v1/dex/balance/token-balances-by-address \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "address": "0x50c476a139aab23fdaf9bca12614cdd54a4244e3",
  "tokenContractAddresses": [
    {
      "binanceChainId": "1",
      "tokenContractAddress": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599"
    }
  ]
}
'

示例请求体

{
  "address": "0x50c476a139aab23fdaf9bca12614cdd54a4244e3",
  "tokenContractAddresses": [
    {
      "binanceChainId": "1",
      "tokenContractAddress": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599"
    }
  ]
}

json

示例响应

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "tokenAssets": [
        {
          "binanceChainId": "1",
          "tokenContractAddress": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
          "address": "0x50c476a139aab23fdaf9bca12614cdd54a4244e3",
          "symbol": "WBTC",
          "balance": "329.10055205",
          "rawBalance": "32910055205",
          "tokenPrice": "98847.8",
          "isRiskToken": false
        }
      ]
    }
  ],
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

查询地址链上交易历史

返回钱包地址在指定链上的交易历史。仅返回最近 6 个月的记录，按时间倒序排列。支持游标分页、时间范围筛选和代币合约筛选。

GET

/api/v1/dex/post-transaction/transactions-by-address

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

chains

string · 必须

链 ID 列表，英文逗号分隔。

示例： 1,56

tokenContractAddress

string

可选的代币合约地址筛选。

示例： 0xdAC17F958D2ee523a2206206994597C13D831ec7

begin

integer · int64

起始时间戳（Unix 毫秒，包含）。

示例： 1746000000000

end

integer · int64

截止时间戳（Unix 毫秒，包含）。

示例： 1748601600000

cursor

string

上次响应返回的分页游标。

示例： eyJ0aW1lIjoxNzQ4NjAwMDAwMDAwLCJpZCI6MTIzfQ==

limit

integer · int32 · min: 1 · max: 100

每页返回数量，范围 1–100，默认 20。

示例： 20

默认值： 20

查询地址链上交易历史 › 响应

成功返回交易历史。

code

integer · int32

示例： 0

msg

string

示例： success

object[]

每条对应一个链。每条包含该链的交易列表与独立分页游标。

timestamp

integer · int64

示例： 1748601600000

success

boolean

示例： true

GET/api/v1/dex/post-transaction/transactions-by-address

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

示例响应

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "cursor": "eyJ0aW1lIjoxNzQ4NTk5MDAwMDAwLCJpZCI6Nzh9",
      "transactionList": [
        {
          "binanceChainId": "1",
          "txHash": "0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890",
          "itype": "0",
          "methodId": "0xa9059cbb",
          "nonce": "42",
          "txTime": "1748601600000",
          "from": [
            {
              "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
              "amount": "1500000"
            }
          ],
          "to": [
            {
              "address": "0x1111111254EEB25477B68fb85Ed929f73A960582",
              "amount": "1500000"
            }
          ],
          "tokenContractAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
          "amount": "1500000",
          "symbol": "USDT",
          "txFee": "0.000125",
          "txStatus": "success",
          "hitBlacklist": false
        }
      ]
    }
  ],
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

根据 Hash 查询交易详情

根据 binanceChainId 与 txHash 查询链上交易详情，返回交易的输入、输出、内部调用与代币转账明细。

GET

/api/v1/dex/post-transaction/transaction-detail-by-txhash

https://web3.binance.com/build

根据 Hash 查询交易详情 › 授权

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

根据 Hash 查询交易详情 › 请求头

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

根据 Hash 查询交易详情 › 查询参数

binanceChainId

string

链唯一标识。

示例： 1

txHash

string

链上交易 Hash。

示例： 0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890

itype

string

交易类型筛选（部分 UTXO 链）。保留参数，当前暂不生效。取值："0"=外层原生币，"1"=内部合约原生币，"2"=Token 转账。

示例： 0

根据 Hash 查询交易详情 › 响应

成功返回交易详情。

code

integer · int32

示例： 0

msg

string

示例： success

object[]

交易详情列表。未找到时为空列表。

timestamp

integer · int64

示例： 1748601600000

success

boolean

示例： true

GET/api/v1/dex/post-transaction/transaction-detail-by-txhash

curl --request GET \
  --url https://web3.binance.com/build/api/v1/dex/post-transaction/transaction-detail-by-txhash \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

示例响应

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "chainIndex": "1",
      "height": "39812345",
      "txTime": "1748601600000",
      "txhash": "0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890",
      "txStatus": "success",
      "gasLimit": "200000",
      "gasUsed": "150000",
      "gasPrice": "5000000000",
      "txFee": "0.000750",
      "nonce": "42",
      "amount": "1500000",
      "symbol": "USDT",
      "methodId": "0xa9059cbb",
      "l1OriginHash": "0xdef456...",
      "fromDetails": [
        {
          "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
          "vinIndex": "0",
          "preVoutIndex": "1",
          "txHash": "0xpreabc...",
          "isContract": false,
          "amount": "1500000"
        }
      ],
      "toDetails": [
        {
          "address": "0x1111111254EEB25477B68fb85Ed929f73A960582",
          "voutIndex": "0",
          "isContract": true,
          "amount": "1500000"
        }
      ],
      "internalTransactionDetails": [
        {
          "from": "0x1111111254EEB25477B68fb85Ed929f73A960582",
          "to": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
          "isFromContract": true,
          "isToContract": false,
          "amount": "100000",
          "txStatus": "success"
        }
      ],
      "tokenTransferDetails": [
        {
          "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
          "to": "0x1111111254EEB25477B68fb85Ed929f73A960582",
          "isFromContract": false,
          "isToContract": true,
          "tokenContractAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
          "symbol": "USDT",
          "amount": "1500000"
        }
      ]
    }
  ],
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

钱包 API

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

下载Schema

获取钱包支持的链

返回 Wallet 服务能够查询余额的区块链列表。支持链由服务端动态配置，可能随时变更。传入 binanceChainId 仅返回该链信息；不传则返回全量列表。

GET

/api/v1/dex/balance/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

获取钱包支持的链 › 查询参数

binanceChainId

string

可选的链唯一标识。指定时仅返回对应链；不传则返回全量列表。

示例： 1

获取钱包支持的链 › 响应

成功返回支持的链列表。

code

integer · int32

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

示例： 0

msg

string

示例： success

object[]

支持的区块链网络列表。

timestamp

integer · int64

示例： 1748601600000

success

boolean

示例： true

查询地址全部代币余额

返回地址在一个或多个链上的全部代币余额，支持分页。将 excludeRiskToken=true 可过滤空投风险币与蜜罐币（蜜罐检测当前仅支持 ETH / BSC / SOL / BASE）。

GET

/api/v1/dex/balance/all-token-balances-by-address

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

待查询的钱包地址。

示例： 0xed0c6079229e2d407672a117c22b62064f4a4312

chains

string

链 ID 列表，英文逗号分隔。

示例： 1,56

excludeRiskToken

boolean

是否排除风险代币。

示例： true

page

integer · int64

页码，默认 1。

示例： 1

默认值： 1

pageSize

integer · int32 · min: 1 · max: 100

每页条数，范围 1–100，默认 20。

示例： 20

默认值： 20

查询地址全部代币余额 › 响应

成功返回代币余额。

code

integer · int32

示例： 0

msg

string

示例： success

object[]

每个查询链对应一条记录，包含该链上分页后的代币余额列表。

timestamp

integer · int64

示例： 1748601600000

success

boolean

示例： true

GET/api/v1/dex/balance/all-token-balances-by-address

curl --request GET \
  --url https://web3.binance.com/build/api/v1/dex/balance/all-token-balances-by-address \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

示例响应

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "page": 1,
      "pageSize": 20,
      "tokenAssets": [
        {
          "binanceChainId": "1",
          "tokenContractAddress": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
          "address": "0xed0c6079229e2d407672a117c22b62064f4a4312",
          "symbol": "WBTC",
          "balance": "329.10055205",
          "rawBalance": "32910055205",
          "tokenPrice": "98847.8",
          "isRiskToken": false
        }
      ]
    }
  ],
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

查询地址特定代币余额

查询指定 (链, 合约) 列表的代币余额，单次请求最多 20 条。 excludeRiskToken="0" 过滤风险代币（默认），"1" 不过滤。

POST

/api/v1/dex/balance/token-balances-by-address

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 · 必须

钱包地址。

示例： 0x50c476a139aab23fdaf9bca12614cdd54a4244e3

object[] · maxItems: 20 · 必须

要查询的代币列表，最多 20 条。

excludeRiskToken

string · enum

风险代币筛选。"0"=过滤（默认），"1"=不过滤。蜜罐检测当前仅支持 ETH / BSC / SOL / BASE。

枚举值:

示例： 0

默认值： 0

查询地址特定代币余额 › 响应

成功返回代币余额。

code

integer · int32

示例： 0

msg

string

示例： success

object[]

每条对应请求中出现过的一个链，包含匹配到的代币余额。

timestamp

integer · int64

示例： 1748601600000

success

boolean

示例： true

POST/api/v1/dex/balance/token-balances-by-address

curl --request POST \
  --url https://web3.binance.com/build/api/v1/dex/balance/token-balances-by-address \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "address": "0x50c476a139aab23fdaf9bca12614cdd54a4244e3",
  "tokenContractAddresses": [
    {
      "binanceChainId": "1",
      "tokenContractAddress": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599"
    }
  ]
}
'

示例请求体

{
  "address": "0x50c476a139aab23fdaf9bca12614cdd54a4244e3",
  "tokenContractAddresses": [
    {
      "binanceChainId": "1",
      "tokenContractAddress": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599"
    }
  ]
}

json

示例响应

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "tokenAssets": [
        {
          "binanceChainId": "1",
          "tokenContractAddress": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
          "address": "0x50c476a139aab23fdaf9bca12614cdd54a4244e3",
          "symbol": "WBTC",
          "balance": "329.10055205",
          "rawBalance": "32910055205",
          "tokenPrice": "98847.8",
          "isRiskToken": false
        }
      ]
    }
  ],
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

查询地址链上交易历史

返回钱包地址在指定链上的交易历史。仅返回最近 6 个月的记录，按时间倒序排列。支持游标分页、时间范围筛选和代币合约筛选。

GET

/api/v1/dex/post-transaction/transactions-by-address

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

chains

string · 必须

链 ID 列表，英文逗号分隔。

示例： 1,56

tokenContractAddress

string

可选的代币合约地址筛选。

示例： 0xdAC17F958D2ee523a2206206994597C13D831ec7

begin

integer · int64

起始时间戳（Unix 毫秒，包含）。

示例： 1746000000000

end

integer · int64

截止时间戳（Unix 毫秒，包含）。

示例： 1748601600000

cursor

string

上次响应返回的分页游标。

示例： eyJ0aW1lIjoxNzQ4NjAwMDAwMDAwLCJpZCI6MTIzfQ==

limit

integer · int32 · min: 1 · max: 100

每页返回数量，范围 1–100，默认 20。

示例： 20

默认值： 20

查询地址链上交易历史 › 响应

成功返回交易历史。

code

integer · int32

示例： 0

msg

string

示例： success

object[]

每条对应一个链。每条包含该链的交易列表与独立分页游标。

timestamp

integer · int64

示例： 1748601600000

success

boolean

示例： true

GET/api/v1/dex/post-transaction/transactions-by-address

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

示例响应

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "cursor": "eyJ0aW1lIjoxNzQ4NTk5MDAwMDAwLCJpZCI6Nzh9",
      "transactionList": [
        {
          "binanceChainId": "1",
          "txHash": "0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890",
          "itype": "0",
          "methodId": "0xa9059cbb",
          "nonce": "42",
          "txTime": "1748601600000",
          "from": [
            {
              "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
              "amount": "1500000"
            }
          ],
          "to": [
            {
              "address": "0x1111111254EEB25477B68fb85Ed929f73A960582",
              "amount": "1500000"
            }
          ],
          "tokenContractAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
          "amount": "1500000",
          "symbol": "USDT",
          "txFee": "0.000125",
          "txStatus": "success",
          "hitBlacklist": false
        }
      ]
    }
  ],
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

根据 Hash 查询交易详情

根据 binanceChainId 与 txHash 查询链上交易详情，返回交易的输入、输出、内部调用与代币转账明细。

GET

/api/v1/dex/post-transaction/transaction-detail-by-txhash

https://web3.binance.com/build

根据 Hash 查询交易详情 › 授权

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

根据 Hash 查询交易详情 › 请求头

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

根据 Hash 查询交易详情 › 查询参数

binanceChainId

string

链唯一标识。

示例： 1

txHash

string

链上交易 Hash。

示例： 0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890

itype

string

交易类型筛选（部分 UTXO 链）。保留参数，当前暂不生效。取值："0"=外层原生币，"1"=内部合约原生币，"2"=Token 转账。

示例： 0

根据 Hash 查询交易详情 › 响应

成功返回交易详情。

code

integer · int32

示例： 0

msg

string

示例： success

object[]

交易详情列表。未找到时为空列表。

timestamp

integer · int64

示例： 1748601600000

success

boolean

示例： true

GET/api/v1/dex/post-transaction/transaction-detail-by-txhash

curl --request GET \
  --url https://web3.binance.com/build/api/v1/dex/post-transaction/transaction-detail-by-txhash \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

示例响应

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "chainIndex": "1",
      "height": "39812345",
      "txTime": "1748601600000",
      "txhash": "0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890",
      "txStatus": "success",
      "gasLimit": "200000",
      "gasUsed": "150000",
      "gasPrice": "5000000000",
      "txFee": "0.000750",
      "nonce": "42",
      "amount": "1500000",
      "symbol": "USDT",
      "methodId": "0xa9059cbb",
      "l1OriginHash": "0xdef456...",
      "fromDetails": [
        {
          "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
          "vinIndex": "0",
          "preVoutIndex": "1",
          "txHash": "0xpreabc...",
          "isContract": false,
          "amount": "1500000"
        }
      ],
      "toDetails": [
        {
          "address": "0x1111111254EEB25477B68fb85Ed929f73A960582",
          "voutIndex": "0",
          "isContract": true,
          "amount": "1500000"
        }
      ],
      "internalTransactionDetails": [
        {
          "from": "0x1111111254EEB25477B68fb85Ed929f73A960582",
          "to": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
          "isFromContract": true,
          "isToContract": false,
          "amount": "100000",
          "txStatus": "success"
        }
      ],
      "tokenTransferDetails": [
        {
          "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
          "to": "0x1111111254EEB25477B68fb85Ed929f73A960582",
          "isFromContract": false,
          "isToContract": true,
          "tokenContractAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
          "symbol": "USDT",
          "amount": "1500000"
        }
      ]
    }
  ],
  "timestamp": 1748601600000,
  "success": true
}

json

application/json