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.

binanceChainId

string

Unique chain identifier (follows EIP-155 chainId for EVM chains; e.g. "1"=Ethereum, "56"=BSC, "CT_501"=Solana).

Example: 1

name

string

Full chain name.

Example: Ethereum

shortName

string

Short chain name.

Example: ETH

logoUrl

string

Chain logo image URL.

Example: https://onchainos.bnbstatic.com/image/admin_mgs_image_upload/20250228/b549e557-76ca-4873-88ef-3a107cf2c9fe.png

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

Get All Token Balances by Address

Return all token balances held by an address on a single chain, 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

Currently only a single chain is supported. Passing multiple comma-separated chain IDs returns an error; multi-chain support may be added in the future.

Example: 1

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.

page

integer · int64

Current page number.

Example: 1

pageSize

integer · int32

Page size.

Example: 20

object[]

Token balance entries for this chain.

binanceChainId

string

Chain identifier.

Example: 1

tokenContractAddress

string

Token contract address. Empty string for the chain's native asset.

Example: 0x2260fac5e5542a773aa44fbcfedf7c193bc2c599

address

string

Wallet address echoed from the request.

Example: 0xed0c6079229e2d407672a117c22b62064f4a4312

symbol

string

Token ticker.

Example: WBTC

balance

string

Token amount scaled by decimals (decimal string).

Example: 329.10055205

rawBalance

string

Raw token amount in the smallest unit (integer string). Empty string when the chain doesn't expose a raw value.

Example: 32910055205

tokenPrice

string

Token USD price (decimal string).

Example: 98847.8

isRiskToken

boolean

Whether the token is risk-flagged.

Example: false

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.

binanceChainId

string · required

Unique chain identifier (e.g. "1"=Ethereum, "56"=BSC, "8453"=Base).

Example: 1

tokenContractAddress

string · required

Token contract address. Pass an empty string for the chain's native asset.

Example: 0x2260fac5e5542a773aa44fbcfedf7c193bc2c599

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.

object[]

Matched token balances for this chain.

binanceChainId

string

Chain identifier.

Example: 1

tokenContractAddress

string

Token contract address. Empty string for the chain's native asset.

Example: 0x2260fac5e5542a773aa44fbcfedf7c193bc2c599

address

string

Wallet address echoed from the request.

Example: 0x50c476a139aab23fdaf9bca12614cdd54a4244e3

symbol

string

Token ticker.

Example: WBTC

balance

string

Token amount scaled by decimals.

Example: 329.10055205

rawBalance

string

Raw token amount in the smallest unit. Empty string when the chain doesn't expose a raw value.

Example: 32910055205

tokenPrice

string

Token USD price.

Example: 98847.8

isRiskToken

boolean

Whether the token is risk-flagged.

Example: false

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.

cursor

string

Cursor for the next page within this chain. Empty string when no more pages.

Example: eyJ0aW1lIjoxNzQ4NTk5MDAwMDAwLCJpZCI6Nzh9

object[]

Transaction history items, sorted by time (descending).

binanceChainId

string

Chain identifier.

Example: 1

txHash

string

On-chain transaction hash.

Example: 0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890

itype

string · enum

Transaction layer type. "0"=outer native-token transfer, "1"=internal contract native-token transfer, "2"=token transfer.

Enum values:

Example: 0

methodId

string | null

Contract method ID (function selector). Null for plain native-token transfers.

Example: 0xa9059cbb

nonce

string

Sender's nonce for this transaction.

Example: 42

txTime

string

Transaction time (Unix milliseconds, string form).

Example: 1748601600000

object[]

Inputs (sender addresses and amounts).

address

string

Sender address. For multi-sig transactions, comma-separated.

Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

amount

string

Input amount (smallest unit, decimal string).

Example: 1500000

object[]

Outputs (receiver addresses and amounts).

address

string

Receiver address. For multi-sig transactions, comma-separated.

Example: 0x1111111254EEB25477B68fb85Ed929f73A960582

amount

string

Output amount.

Example: 1500000

tokenContractAddress

string | null

Token contract address. Null for native-token transfers.

Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7

amount

string

Transaction amount in the token's smallest unit.

Example: 1500000

symbol

string

Symbol of the transferred asset.

Example: USDT

txFee

string

Transaction fee (native-token amount, decimal string).

Example: 0.000125

txStatus

string · enum

Transaction status.

Enum values:

success

fail

pending

Example: success

hitBlacklist

boolean | null

Whether the transaction matches a blacklist rule.

Example: false

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.

chainIndex

string

Chain identifier.

Example: 1

height

string

Block height (decimal string).

Example: 39812345

txTime

string

Transaction time (Unix milliseconds, string form).

Example: 1748601600000

txhash

string

On-chain transaction hash.

Example: 0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890

txStatus

string · enum

Transaction status. One of: "success", "fail", "pending".

Enum values:

success

fail

pending

Example: success

gasLimit

string | null

Gas limit (decimal string).

Example: 200000

gasUsed

string | null

Gas actually consumed.

Example: 150000

gasPrice

string | null

Gas price (wei, decimal string).

Example: 5000000000

txFee

string

Transaction fee in the chain's native token.

Example: 0.000750

nonce

string

Sender nonce.

Example: 42

amount

string

Transaction amount.

Example: 1500000

symbol

string

Symbol of the transferred asset.

Example: USDT

methodId

string | null

Contract method ID (function selector). Null for plain native-token transfers.

Example: 0xa9059cbb

l1OriginHash

string | null

L1 origin transaction hash for rollup / L2 transactions; null otherwise.

Example: 0xdef456...

object[]

Transaction inputs (sender details).

address

string

Sender / input address.

Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

vinIndex

string | null

Current transaction input index (UTXO chains).

Example: 0

preVoutIndex

string | null

Linked previous output index (UTXO chains).

Example: 1

txHash

string | null

Previous transaction hash (UTXO chains, locates the input UTXO together with preVoutIndex).

Example: 0xpreabc...

isContract

boolean | null

Whether the sender address is a contract.

Example: false

amount

string

Input amount.

Example: 1500000

object[]

Transaction outputs (receiver details).

address

string

Receiver / output address.

Example: 0x1111111254EEB25477B68fb85Ed929f73A960582

voutIndex

string | null

Output index (UTXO chains).

Example: 0

isContract

boolean | null

Whether the receiver address is a contract.

Example: true

amount

string

Output amount.

Example: 1500000

object[]

Internal transaction details.

from

string

Sender address.

Example: 0x1111111254EEB25477B68fb85Ed929f73A960582

to

string

Receiver address.

Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

isFromContract

boolean | null

Whether the sender is a contract.

Example: true

isToContract

boolean | null

Whether the receiver is a contract.

Example: false

amount

string

Internal call amount.

Example: 100000

txStatus

string

Internal call status.

Example: success

object[]

Token transfer details emitted by this transaction.

from

string

Sender address.

Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

to

string

Receiver address.

Example: 0x1111111254EEB25477B68fb85Ed929f73A960582

isFromContract

boolean | null

Whether the sender is a contract.

Example: false

isToContract

boolean | null

Whether the receiver is a contract.

Example: true

tokenContractAddress

string

Token contract address.

Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7

symbol

string

Token ticker.

Example: USDT

amount

string

Transfer amount (smallest unit, decimal string).

Example: 1500000

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.

binanceChainId

string

Unique chain identifier (follows EIP-155 chainId for EVM chains; e.g. "1"=Ethereum, "56"=BSC, "CT_501"=Solana).

Example: 1

name

string

Full chain name.

Example: Ethereum

shortName

string

Short chain name.

Example: ETH

logoUrl

string

Chain logo image URL.

Example: https://onchainos.bnbstatic.com/image/admin_mgs_image_upload/20250228/b549e557-76ca-4873-88ef-3a107cf2c9fe.png

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

Currently only a single chain is supported. Passing multiple comma-separated chain IDs returns an error; multi-chain support may be added in the future.

Example: 1

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.

page

integer · int64

Current page number.

Example: 1

pageSize

integer · int32

Page size.

Example: 20

object[]

Token balance entries for this chain.

binanceChainId

string

Chain identifier.

Example: 1

tokenContractAddress

string

Token contract address. Empty string for the chain's native asset.

Example: 0x2260fac5e5542a773aa44fbcfedf7c193bc2c599

address

string

Wallet address echoed from the request.

Example: 0xed0c6079229e2d407672a117c22b62064f4a4312

symbol

string

Token ticker.

Example: WBTC

balance

string

Token amount scaled by decimals (decimal string).

Example: 329.10055205

rawBalance

string

Raw token amount in the smallest unit (integer string). Empty string when the chain doesn't expose a raw value.

Example: 32910055205

tokenPrice

string

Token USD price (decimal string).

Example: 98847.8

isRiskToken

boolean

Whether the token is risk-flagged.

Example: false

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.

binanceChainId

string · required

Unique chain identifier (e.g. "1"=Ethereum, "56"=BSC, "8453"=Base).

Example: 1

tokenContractAddress

string · required

Token contract address. Pass an empty string for the chain's native asset.

Example: 0x2260fac5e5542a773aa44fbcfedf7c193bc2c599

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.

object[]

Matched token balances for this chain.

binanceChainId

string

Chain identifier.

Example: 1

tokenContractAddress

string

Token contract address. Empty string for the chain's native asset.

Example: 0x2260fac5e5542a773aa44fbcfedf7c193bc2c599

address

string

Wallet address echoed from the request.

Example: 0x50c476a139aab23fdaf9bca12614cdd54a4244e3

symbol

string

Token ticker.

Example: WBTC

balance

string

Token amount scaled by decimals.

Example: 329.10055205

rawBalance

string

Raw token amount in the smallest unit. Empty string when the chain doesn't expose a raw value.

Example: 32910055205

tokenPrice

string

Token USD price.

Example: 98847.8

isRiskToken

boolean

Whether the token is risk-flagged.

Example: false

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.

cursor

string

Cursor for the next page within this chain. Empty string when no more pages.

Example: eyJ0aW1lIjoxNzQ4NTk5MDAwMDAwLCJpZCI6Nzh9

object[]

Transaction history items, sorted by time (descending).

binanceChainId

string

Chain identifier.

Example: 1

txHash

string

On-chain transaction hash.

Example: 0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890

itype

string · enum

Transaction layer type. "0"=outer native-token transfer, "1"=internal contract native-token transfer, "2"=token transfer.

Enum values:

Example: 0

methodId

string | null

Contract method ID (function selector). Null for plain native-token transfers.

Example: 0xa9059cbb

nonce

string

Sender's nonce for this transaction.

Example: 42

txTime

string

Transaction time (Unix milliseconds, string form).

Example: 1748601600000

object[]

Inputs (sender addresses and amounts).

address

string

Sender address. For multi-sig transactions, comma-separated.

Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

amount

string

Input amount (smallest unit, decimal string).

Example: 1500000

object[]

Outputs (receiver addresses and amounts).

address

string

Receiver address. For multi-sig transactions, comma-separated.

Example: 0x1111111254EEB25477B68fb85Ed929f73A960582

amount

string

Output amount.

Example: 1500000

tokenContractAddress

string | null

Token contract address. Null for native-token transfers.

Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7

amount

string

Transaction amount in the token's smallest unit.

Example: 1500000

symbol

string

Symbol of the transferred asset.

Example: USDT

txFee

string

Transaction fee (native-token amount, decimal string).

Example: 0.000125

txStatus

string · enum

Transaction status.

Enum values:

success

fail

pending

Example: success

hitBlacklist

boolean | null

Whether the transaction matches a blacklist rule.

Example: false

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.

chainIndex

string

Chain identifier.

Example: 1

height

string

Block height (decimal string).

Example: 39812345

txTime

string

Transaction time (Unix milliseconds, string form).

Example: 1748601600000

txhash

string

On-chain transaction hash.

Example: 0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890

txStatus

string · enum

Transaction status. One of: "success", "fail", "pending".

Enum values:

success

fail

pending

Example: success

gasLimit

string | null

Gas limit (decimal string).

Example: 200000

gasUsed

string | null

Gas actually consumed.

Example: 150000

gasPrice

string | null

Gas price (wei, decimal string).

Example: 5000000000

txFee

string

Transaction fee in the chain's native token.

Example: 0.000750

nonce

string

Sender nonce.

Example: 42

amount

string

Transaction amount.

Example: 1500000

symbol

string

Symbol of the transferred asset.

Example: USDT

methodId

string | null

Contract method ID (function selector). Null for plain native-token transfers.

Example: 0xa9059cbb

l1OriginHash

string | null

L1 origin transaction hash for rollup / L2 transactions; null otherwise.

Example: 0xdef456...

object[]

Transaction inputs (sender details).

address

string

Sender / input address.

Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

vinIndex

string | null

Current transaction input index (UTXO chains).

Example: 0

preVoutIndex

string | null

Linked previous output index (UTXO chains).

Example: 1

txHash

string | null

Previous transaction hash (UTXO chains, locates the input UTXO together with preVoutIndex).

Example: 0xpreabc...

isContract

boolean | null

Whether the sender address is a contract.

Example: false

amount

string

Input amount.

Example: 1500000

object[]

Transaction outputs (receiver details).

address

string

Receiver / output address.

Example: 0x1111111254EEB25477B68fb85Ed929f73A960582

voutIndex

string | null

Output index (UTXO chains).

Example: 0

isContract

boolean | null

Whether the receiver address is a contract.

Example: true

amount

string

Output amount.

Example: 1500000

object[]

Internal transaction details.

from

string

Sender address.

Example: 0x1111111254EEB25477B68fb85Ed929f73A960582

to

string

Receiver address.

Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

isFromContract

boolean | null

Whether the sender is a contract.

Example: true

isToContract

boolean | null

Whether the receiver is a contract.

Example: false

amount

string

Internal call amount.

Example: 100000

txStatus

string

Internal call status.

Example: success

object[]

Token transfer details emitted by this transaction.

from

string

Sender address.

Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

to

string

Receiver address.

Example: 0x1111111254EEB25477B68fb85Ed929f73A960582

isFromContract

boolean | null

Whether the sender is a contract.

Example: false

isToContract

boolean | null

Whether the receiver is a contract.

Example: true

tokenContractAddress

string

Token contract address.

Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7

symbol

string

Token ticker.

Example: USDT

amount

string

Transfer amount (smallest unit, decimal string).

Example: 1500000

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