Wallet API

Endpointhttps://web3.binance.com/build

Get Wallet Supported Chains

Return blockchain networks for which the Wallet service can return balances. The supported list is dynamically configured server-side and may change over time. Pass binanceChainId to filter to a single chain; omit to get the full list.

GET

/api/v1/dex/balance/supported/chain

https://web3.binance.com/build

Get Wallet Supported Chains › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Wallet Supported Chains › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get Wallet Supported Chains › Query Parameters

binanceChainId

string

Optional chain identifier. When set, only that chain is returned.

Example: 1

Get Wallet Supported Chains › Responses

Supported chains returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Example: success

object[]

List of supported blockchain networks.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

Get All Token Balances by Address

Return all token balances held by an address across one or more chains, with pagination support. Set excludeRiskToken=true to filter out airdrop-risk and honeypot tokens (honeypot detection currently applies only to ETH / BSC / SOL / BASE).

GET

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

https://web3.binance.com/build

Get All Token Balances by Address › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get All Token Balances by Address › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get All Token Balances by Address › Query Parameters

address

string

Wallet address to query.

Example: 0xed0c6079229e2d407672a117c22b62064f4a4312

chains

string

Comma-separated list of chain identifiers.

Example: 1,56

excludeRiskToken

boolean

Whether to exclude risk-flagged tokens.

Example: true

page

integer · int64

Page number. Defaults to 1.

Example: 1

Default: 1

pageSize

integer · int32 · min: 1 · max: 100

Page size. Range 1–100. Defaults to 20.

Example: 20

Default: 20

Get All Token Balances by Address › Responses

Token balances returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object[]

One entry per requested chain, each containing a paginated list of token balances.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: 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>'

Example Responses

{
  "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

Get Token Balances by Address

Return token balances for a specific list of (chain, contract) pairs. Up to 20 entries per request. Set excludeRiskToken="0" to exclude risk-flagged tokens (default), or "1" to include them.

POST

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

https://web3.binance.com/build

Get Token Balances by Address › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Token Balances by Address › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get Token Balances by Address › Request Body

address

string · required

Wallet address to query.

Example: 0x50c476a139aab23fdaf9bca12614cdd54a4244e3

object[] · maxItems: 20 · required

Tokens to query, up to 20 entries.

excludeRiskToken

string · enum

Risk-token filter. "0"=exclude (default), "1"=include. Honeypot detection currently applies only to ETH / BSC / SOL / BASE.

Enum values:

Example: 0

Default: 0

Get Token Balances by Address › Responses

Token balances returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object[]

One entry per chain that appears in the request, each containing matched token balances.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: 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"
    }
  ]
}
'

Example Request Body

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

json

Example Responses

{
  "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

Get Transactions by Address

Return on-chain transaction history for a wallet address across one or more chains. Results are limited to the most recent 6 months and sorted by time (descending). Supports cursor pagination, time-range filtering, and token-contract filtering.

GET

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

https://web3.binance.com/build

Get Transactions by Address › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Transactions by Address › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get Transactions by Address › Query Parameters

address

string · required

Wallet address to query.

Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

chains

string · required

Comma-separated list of chain identifiers.

Example: 1,56

tokenContractAddress

string

Optional token contract address filter.

Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7

begin

integer · int64

Optional start timestamp (Unix milliseconds, inclusive).

Example: 1746000000000

end

integer · int64

Optional end timestamp (Unix milliseconds, inclusive).

Example: 1748601600000

cursor

string

Pagination cursor returned by the previous page.

Example: eyJ0aW1lIjoxNzQ4NjAwMDAwMDAwLCJpZCI6MTIzfQ==

limit

integer · int32 · min: 1 · max: 100

Page size. Range 1–100. Defaults to 20.

Example: 20

Default: 20

Get Transactions by Address › Responses

Transaction history returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object[]

One entry per queried chain. Each entry contains a transaction list and its own pagination cursor.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: 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>'

Example Responses

{
  "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

Get Transaction Detail by Hash

Look up the full on-chain transaction detail by binanceChainId + txHash. Returns one or more entries describing transaction inputs, outputs, internal calls, and token transfers.

GET

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

https://web3.binance.com/build

Get Transaction Detail by Hash › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Transaction Detail by Hash › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get Transaction Detail by Hash › Query Parameters

binanceChainId

string

Unique chain identifier (e.g. "1"=Ethereum, "56"=BSC, "CT_501"=Solana).

Example: 1

txHash

string

On-chain transaction hash.

Example: 0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890

itype

string

Transaction-type filter (UTXO chains). Reserved — currently has no effect. Values: "0"=outer native-token, "1"=internal contract native-token, "2"=token transfer.

Example: 0

Get Transaction Detail by Hash › Responses

Transaction details returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object[]

Transaction detail entries. May be empty when the transaction is not found.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: 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>'

Example Responses

{
  "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

Wallet API

Endpointhttps://web3.binance.com/build

Download schema

Get Wallet Supported Chains

GET

/api/v1/dex/balance/supported/chain

https://web3.binance.com/build

Get Wallet Supported Chains › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Wallet Supported Chains › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get Wallet Supported Chains › Query Parameters

binanceChainId

string

Optional chain identifier. When set, only that chain is returned.

Example: 1

Get Wallet Supported Chains › Responses

Supported chains returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Example: success

object[]

List of supported blockchain networks.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

Get All Token Balances by Address

GET

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

https://web3.binance.com/build

Get All Token Balances by Address › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get All Token Balances by Address › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get All Token Balances by Address › Query Parameters

address

string

Wallet address to query.

Example: 0xed0c6079229e2d407672a117c22b62064f4a4312

chains

string

Comma-separated list of chain identifiers.

Example: 1,56

excludeRiskToken

boolean

Whether to exclude risk-flagged tokens.

Example: true

page

integer · int64

Page number. Defaults to 1.

Example: 1

Default: 1

pageSize

integer · int32 · min: 1 · max: 100

Page size. Range 1–100. Defaults to 20.

Example: 20

Default: 20

Get All Token Balances by Address › Responses

Token balances returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object[]

One entry per requested chain, each containing a paginated list of token balances.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: 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>'

Example Responses

{
  "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

Get Token Balances by Address

Return token balances for a specific list of (chain, contract) pairs. Up to 20 entries per request. Set excludeRiskToken="0" to exclude risk-flagged tokens (default), or "1" to include them.

POST

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

https://web3.binance.com/build

Get Token Balances by Address › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Token Balances by Address › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get Token Balances by Address › Request Body

address

string · required

Wallet address to query.

Example: 0x50c476a139aab23fdaf9bca12614cdd54a4244e3

object[] · maxItems: 20 · required

Tokens to query, up to 20 entries.

excludeRiskToken

string · enum

Risk-token filter. "0"=exclude (default), "1"=include. Honeypot detection currently applies only to ETH / BSC / SOL / BASE.

Enum values:

Example: 0

Default: 0

Get Token Balances by Address › Responses

Token balances returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object[]

One entry per chain that appears in the request, each containing matched token balances.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: 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"
    }
  ]
}
'

Example Request Body

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

json

Example Responses

{
  "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

Get Transactions by Address

GET

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

https://web3.binance.com/build

Get Transactions by Address › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Transactions by Address › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get Transactions by Address › Query Parameters

address

string · required

Wallet address to query.

Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

chains

string · required

Comma-separated list of chain identifiers.

Example: 1,56

tokenContractAddress

string

Optional token contract address filter.

Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7

begin

integer · int64

Optional start timestamp (Unix milliseconds, inclusive).

Example: 1746000000000

end

integer · int64

Optional end timestamp (Unix milliseconds, inclusive).

Example: 1748601600000

cursor

string

Pagination cursor returned by the previous page.

Example: eyJ0aW1lIjoxNzQ4NjAwMDAwMDAwLCJpZCI6MTIzfQ==

limit

integer · int32 · min: 1 · max: 100

Page size. Range 1–100. Defaults to 20.

Example: 20

Default: 20

Get Transactions by Address › Responses

Transaction history returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object[]

One entry per queried chain. Each entry contains a transaction list and its own pagination cursor.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: 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>'

Example Responses

{
  "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

Get Transaction Detail by Hash

Look up the full on-chain transaction detail by binanceChainId + txHash. Returns one or more entries describing transaction inputs, outputs, internal calls, and token transfers.

GET

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

https://web3.binance.com/build

Get Transaction Detail by Hash › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Transaction Detail by Hash › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get Transaction Detail by Hash › Query Parameters

binanceChainId

string

Unique chain identifier (e.g. "1"=Ethereum, "56"=BSC, "CT_501"=Solana).

Example: 1

txHash

string

On-chain transaction hash.

Example: 0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890

itype

string

Transaction-type filter (UTXO chains). Reserved — currently has no effect. Values: "0"=outer native-token, "1"=internal contract native-token, "2"=token transfer.

Example: 0

Get Transaction Detail by Hash › Responses

Transaction details returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object[]

Transaction detail entries. May be empty when the transaction is not found.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: 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>'

Example Responses

{
  "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