Address Portfolio

Endpointhttps://web3.binance.com/build

Get Portfolio Supported Chains

Return the list of blockchains supported by address portfolio analysis.

GET

/api/v1/dex/market/portfolio/supported/chain

https://web3.binance.com/build

Get Portfolio 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 Portfolio 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 Portfolio 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 (e.g. "1"=Ethereum, "56"=BSC, "CT_501"=Solana).

Example: 1

name

string

Full chain name.

Example: Ethereum

shortName

string

Short chain name (uppercase).

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

caseSensitive

boolean

Whether addresses on this chain are case-sensitive. true=case-sensitive (e.g. Solana), false=case-insensitive (e.g. EVM chains).

Example: false

nativeTokenSymbol

string

Symbol of the chain's native asset (uppercase).

Example: ETH

nativeTokenDecimals

integer · int32

Native token decimals. Display value = raw value / 10^nativeTokenDecimals.

Example: 18

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

Get Address Portfolio Overview

Return trading performance overview for an address within the selected time frame, including realized PnL, daily PnL breakdown, win rate, and top 3 profitable tokens.

GET

/api/v1/dex/market/portfolio/overview

https://web3.binance.com/build

Get Address Portfolio Overview › 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 Address Portfolio Overview › 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 Address Portfolio Overview › Query Parameters

binanceChainId

string · required

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

Example: 1

walletAddress

string · required

Wallet address to query. EVM chains accept lowercase 42-character hex addresses; Solana accepts base58 addresses (case-sensitive).

Example: 0x28c6c06298d514db089934071355e5743bf21d60

timeFrame

string · enum · required

Statistics time range. 1=1D, 2=7D, 3=1M, 4=3M. Note: these values differ from the leaderboard/list endpoint (where 1=7D, 2=1M, 3=3M); do not reuse enum knowledge across endpoints.

Enum values:

Example: 2

Get Address Portfolio Overview › Responses

Portfolio overview returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Example: success

object

Address portfolio overview.

realizedPnlUsd

string

Total realized PnL within the time frame, denominated in USD. Positive means profit, negative means loss.

Example: 4670.50

realizedPnlPercent

string

Realized PnL percentage within the time frame. "16.44" means +16.44%. No percent sign included.

Example: 16.44

object[]

Daily realized PnL breakdown, sorted by date descending (most recent first). Number of entries matches the timeFrame.

date

string

Date in YYYY-MM-DD format.

Example: 2026-04-25

pnlUsd

string

Realized PnL for this day, denominated in USD. Positive means profit, negative means loss.

Example: 120.50

winRate

string

Win rate within the time frame. "61.11" means 61.11%. No percent sign included.

Example: 61.11

object

Token count breakdown by realized PnL percentage range.

over500Percent

string

Number of tokens with realized PnL ≥500%.

Example: 3

from200To500Percent

string

Number of tokens with realized PnL in [200%, 500%).

Example: 5

from50To200Percent

string

Number of tokens with realized PnL in [50%, 200%).

Example: 8

zeroTo50Percent

string

Number of tokens with realized PnL in [0%, 50%).

Example: 12

zeroToMinus50Percent

string

Number of tokens with realized PnL in [-50%, 0%).

Example: 7

overMinus50Percent

string

Number of tokens with realized PnL < -50%.

Example: 4

buyTxCount

string

Number of buy transactions within the time frame.

Example: 145

sellTxCount

string

Number of sell transactions within the time frame.

Example: 132

totalTokenCount

string

Total number of distinct tokens traded within the time frame.

Example: 73

buyTxVolume

string

Total buy volume within the time frame, denominated in USD.

Example: 15000.50

sellTxVolume

string

Total sell volume within the time frame, denominated in USD.

Example: 12000.30

avgBuyValueUsd

string

Average buy value per transaction within the time frame, denominated in USD.

Example: 86.71

top3PnlTokenSumUsd

string

Total realized PnL of the top 3 profit tokens, denominated in USD.

Example: 3200.00

top3PnlTokenPercent

string

Percentage of total realized PnL contributed by the top 3 profit tokens. No percent sign included.

Example: 68.52

object[]

Top 3 tokens by realized PnL. Returns fewer items if fewer than 3 tokens were traded.

tokenContractAddress

string

Token contract address. EVM addresses are lowercase; Solana addresses are case-sensitive.

Example: 0x6982508145454ce325ddbe47a25d4ec3d2311933

tokenSymbol

string

Token symbol.

Example: PEPE

tokenPnLUsd

string

Realized PnL for this token, denominated in USD. Positive means profit, negative means loss.

Example: 1200.50

tokenPnLPercent

string

Realized PnL percentage for this token. No percent sign included.

Example: 250.5

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

GET/api/v1/dex/market/portfolio/overview

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/market/portfolio/overview?binanceChainId=%3Cstring%3E&walletAddress=%3Cstring%3E&timeFrame=%3Cstring%3E' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "realizedPnlUsd": "4670.50",
    "realizedPnlPercent": "16.44",
    "dailyPnl": [
      {
        "date": "2026-04-25",
        "pnlUsd": "120.50"
      }
    ],
    "winRate": "61.11",
    "tokenCountByPnlPercent": {
      "over500Percent": "3",
      "from200To500Percent": "5",
      "from50To200Percent": "8",
      "zeroTo50Percent": "12",
      "zeroToMinus50Percent": "7",
      "overMinus50Percent": "4"
    },
    "buyTxCount": "145",
    "sellTxCount": "132",
    "totalTokenCount": "73",
    "buyTxVolume": "15000.50",
    "sellTxVolume": "12000.30",
    "avgBuyValueUsd": "86.71",
    "top3PnlTokenSumUsd": "3200.00",
    "top3PnlTokenPercent": "68.52",
    "topPnlTokenList": [
      {
        "tokenContractAddress": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
        "tokenSymbol": "PEPE",
        "tokenPnLUsd": "1200.50",
        "tokenPnLPercent": "250.5"
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get Address Recent PnL

Return recent realized PnL list for an address.

GET

/api/v1/dex/market/portfolio/recent-pnl

https://web3.binance.com/build

Get Address Recent PnL › 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 Address Recent PnL › 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 Address Recent PnL › Query Parameters

binanceChainId

string · required

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

Example: 1

walletAddress

string · required

Wallet address to query. EVM chains accept lowercase 42-character hex addresses; Solana accepts base58 addresses (case-sensitive).

Example: 0x28c6c06298d514db089934071355e5743bf21d60

cursor

string

Pagination cursor. Omit or pass empty string for the first page; pass the cursor from the previous response to get the next page.

Example:

limit

string

Number of records per page. Default 20, max 100.

Example: 20

Get Address Recent PnL › Responses

Recent PnL list returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Example: success

object

Paginated PnL list.

cursor

string

Pagination cursor for the next page. Empty string when no more data.

Example:

object[]

PnL records sorted by lastActiveTimestamp descending.

binanceChainId

string

Unique chain identifier.

Example: 1

tokenContractAddress

string

Token contract address. EVM addresses are lowercase; Solana addresses are case-sensitive.

Example: 0x6982508145454ce325ddbe47a25d4ec3d2311933

tokenSymbol

string

Token symbol.

Example: PEPE

lastActiveTimestamp

string

Timestamp of the last transaction for this token, Unix millisecond timestamp.

Example: 1769398550000

realizedPnlUsd

string

Realized PnL for this token, denominated in USD. Positive means profit, negative means loss.

Example: 1277.837

realizedPnlPercent

string

Realized PnL percentage for this token. No percent sign included.

Example: 77.64

tokenBalanceUsd

string

Current market value of the address's holding in this token, denominated in USD.

Example: 333.598

tokenBalanceAmount

string

Current holding amount of this token (token units).

Example: 18580000

object

Holding duration information for this token.

holdingTimestamp

string

Timestamp of the first buy for this token, Unix millisecond timestamp.

Example: 1756873866000

buyTxCount

string

Number of buy transactions for this token.

Example: 5

buyTxVolume

string

Total buy spend for this token, denominated in USD.

Example: 1958.067

buyAvgPrice

string

Average buy price for this token, denominated in USD.

Example: 0.000105

sellTxCount

string

Number of sell transactions for this token.

Example: 3

sellTxVolume

string

Total sell proceeds for this token, denominated in USD.

Example: 2923.574

sellAvgPrice

string

Average sell price for this token, denominated in USD.

Example: 0.000195

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

GET/api/v1/dex/market/portfolio/recent-pnl

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/market/portfolio/recent-pnl?binanceChainId=%3Cstring%3E&walletAddress=%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": "",
    "pnlList": [
      {
        "binanceChainId": "1",
        "tokenContractAddress": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
        "tokenSymbol": "PEPE",
        "lastActiveTimestamp": "1769398550000",
        "realizedPnlUsd": "1277.837",
        "realizedPnlPercent": "77.64",
        "tokenBalanceUsd": "333.598",
        "tokenBalanceAmount": "18580000",
        "tokenPositionDuration": {
          "holdingTimestamp": "1756873866000"
        },
        "buyTxCount": "5",
        "buyTxVolume": "1958.067",
        "buyAvgPrice": "0.000105",
        "sellTxCount": "3",
        "sellTxVolume": "2923.574",
        "sellAvgPrice": "0.000195"
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get Address PnL for Specific Token

Return the latest realized PnL detail for a specific token held by an address, including buy/sell stats, current balance, and holding duration.

GET

/api/v1/dex/market/portfolio/token/latest-pnl

https://web3.binance.com/build

Get Address PnL for Specific Token › 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 Address PnL for Specific Token › 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 Address PnL for Specific Token › Query Parameters

binanceChainId

string · required

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

Example: 1

walletAddress

string · required

Wallet address to query. EVM chains accept lowercase 42-character hex addresses; Solana accepts base58 addresses (case-sensitive).

Example: 0x28c6c06298d514db089934071355e5743bf21d60

tokenContractAddress

string · required

Token contract address. EVM chains accept lowercase 42-character hex addresses; Solana accepts base58 addresses (case-sensitive).

Example: 0x6982508145454ce325ddbe47a25d4ec3d2311933

Get Address PnL for Specific Token › Responses

Token latest PnL returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Example: success

object

Token latest PnL details.

realizedPnlUsd

string

Cumulative realized PnL for this token, denominated in USD. Positive means profit, negative means loss.

Example: 1277.837

realizedPnlPercent

string

Realized PnL percentage. No percent sign included.

Example: 77.64

buyTxVolume

string

Cumulative buy spend for this token, denominated in USD.

Example: 1958.067

buyAmount

string

Cumulative buy quantity (token units).

Example: 18580000

buyTxCount

string

Number of buy transactions.

Example: 5

sellTxVolume

string

Cumulative sell proceeds for this token, denominated in USD.

Example: 2923.574

sellAmount

string

Cumulative sell quantity (token units).

Example: 15000000

sellTxCount

string

Number of sell transactions.

Example: 3

buyAvgPrice

string

Average buy price, denominated in USD.

Example: 0.000105

sellAvgPrice

string

Average sell price, denominated in USD.

Example: 0.000195

tokenBalanceUsd

string

Current market value of the address's holding in this token, denominated in USD. Returns "0" when fully sold.

Example: 333.598

tokenBalanceAmount

string

Current holding amount (token units). Returns "0" when fully sold.

Example: 3580000

maxBalanceAmount

string

Maximum historical holding amount (token units).

Example: 18580000

holdingDuration

string

Cumulative holding duration in milliseconds. Counts only actual holding periods; gaps between sell and re-buy are excluded. If still holding, counts up to the current time.

Example: 864000000

isPnlSupported

boolean

Whether PnL calculation is meaningful for this token. true=supported; false=not supported. Returns false for stablecoins (USDT/USDC/DAI etc.), native tokens (ETH/BNB/SOL etc.), and wrapped tokens (WETH/WBNB/WSOL etc.). Returns true for regular trading tokens.

Example: true

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

GET/api/v1/dex/market/portfolio/token/latest-pnl

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/market/portfolio/token/latest-pnl?binanceChainId=%3Cstring%3E&walletAddress=%3Cstring%3E&tokenContractAddress=%3Cstring%3E' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "realizedPnlUsd": "1277.837",
    "realizedPnlPercent": "77.64",
    "buyTxVolume": "1958.067",
    "buyAmount": "18580000",
    "buyTxCount": "5",
    "sellTxVolume": "2923.574",
    "sellAmount": "15000000",
    "sellTxCount": "3",
    "buyAvgPrice": "0.000105",
    "sellAvgPrice": "0.000195",
    "tokenBalanceUsd": "333.598",
    "tokenBalanceAmount": "3580000",
    "maxBalanceAmount": "18580000",
    "holdingDuration": "864000000",
    "isPnlSupported": true
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get DEX Trade History

Return swap trade history for a specific address. Supports filtering by time range, token, and trade type.

GET

/api/v1/dex/market/portfolio/dex-history

https://web3.binance.com/build

Get DEX Trade History › 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 DEX Trade History › 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 DEX Trade History › Query Parameters

binanceChainId

string · required

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

Example: 1

walletAddress

string · required

Wallet address to query. EVM chains accept lowercase 42-character hex addresses; Solana accepts base58 addresses (case-sensitive).

Example: 0x28c6c06298d514db089934071355e5743bf21d60

begin

string

Start timestamp (Unix milliseconds, inclusive). If both begin and end are omitted, no time filter is applied.

Example: 1714000000000

end

string

End timestamp (Unix milliseconds, inclusive). If both begin and end are omitted, no time filter is applied.

Example: 1748601600000

tokenContractAddress

string

Filter by token contract address. Returns all tokens when omitted.

Example: 0x6982508145454ce325ddbe47a25d4ec3d2311933

type

string · enum

Trade type filter. 1=Buy, 2=Sell. Omit to return all types.

Enum values:

Example: 1

cursor

string

Pagination cursor. Omit or pass empty string for the first page.

Example:

limit

string

Number of records per page. Default 20, max 100.

Example: 20

Get DEX Trade History › Responses

DEX history returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Example: success

object

Paginated DEX transaction list.

cursor

string

Pagination cursor for the next page. Empty string when no more data.

Example:

object[]

DEX transaction records sorted by time descending.

type

string

Trade type. 1=Buy, 2=Sell.

Example: 1

binanceChainId

string

Unique chain identifier.

Example: 1

tokenContractAddress

string

Token contract address. EVM addresses are lowercase; Solana addresses are case-sensitive.

Example: 0x6982508145454ce325ddbe47a25d4ec3d2311933

tokenSymbol

string

Token symbol.

Example: PEPE

valueUsd

string

Transaction value, denominated in USD.

Example: 312.329

amount

string

Token quantity involved in this transaction (token units).

Example: 18580000

price

string

Execution price of this transaction, denominated in USD.

Example: 0.000016807

marketCap

string

Token market cap at the time of this transaction, denominated in USD.

Example: 168070.50

txHash

string

On-chain transaction hash.

Example: 0x3a2b1c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b

chainLogoUrl

string

Chain logo image URL.

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

time

string

Transaction on-chain time, Unix millisecond timestamp.

Example: 1714000000000

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

GET/api/v1/dex/market/portfolio/dex-history

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/market/portfolio/dex-history?binanceChainId=%3Cstring%3E&walletAddress=%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": "",
    "transactionList": [
      {
        "type": "1",
        "binanceChainId": "1",
        "tokenContractAddress": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
        "tokenSymbol": "PEPE",
        "valueUsd": "312.329",
        "amount": "18580000",
        "price": "0.000016807",
        "marketCap": "168070.50",
        "txHash": "0x3a2b1c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b",
        "chainLogoUrl": "https://onchainos.bnbstatic.com/image/admin_mgs_image_upload/20250228/b549e557-76ca-4873-88ef-3a107cf2c9fe.png",
        "time": "1714000000000"
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get Leaderboard

Return a leaderboard of top-performing wallets, with sorting and filtering by PnL, win rate, transaction count, and volume.

GET

/api/v1/dex/market/leaderboard/list

https://web3.binance.com/build

Get Leaderboard › 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 Leaderboard › 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 Leaderboard › Query Parameters

binanceChainId

string · required

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

Example: 1

timeFrame

string · enum · required

Statistics time range. 1=7D, 2=1M, 3=3M. Note: these values differ from the portfolio/overview endpoint (where 1=1D, 2=7D, 3=1M, 4=3M); do not reuse enum knowledge across endpoints.

Enum values:

Example: 2

sortBy

string · enum · required

Sort field. 1=Realized PnL (USD), 2=Win Rate, 3=Transaction count, 4=Volume (USD), 5=Realized PnL %.

Enum values:

Example: 1

walletType

string · enum

Wallet type filter, single selection only. 1=Smart Money, 2=KOL, 3=Hot List. Returns all types when omitted.

Enum values:

Example: 2

minRealizedPnlUsd

string

Minimum realized PnL filter, denominated in USD.

Example: 1000

maxRealizedPnlUsd

string

Maximum realized PnL filter, denominated in USD.

Example: 50000

minWinRatePercent

string

Minimum win rate filter, without percent sign. "50" means ≥50%.

Example: 50

maxWinRatePercent

string

Maximum win rate filter, without percent sign. "90" means ≤90%.

Example: 90

minTxs

string

Minimum transaction count filter.

Example: 10

maxTxs

string

Maximum transaction count filter.

Example: 1000

minTxVolume

string

Minimum total transaction volume filter, denominated in USD.

Example: 5000

maxTxVolume

string

Maximum total transaction volume filter, denominated in USD.

Example: 1000000

cursor

string

Pagination cursor. Omit or pass empty string for the first page.

Example:

limit

string

Number of records per page. Default 50, max 50.

Example: 50

Get Leaderboard › Responses

Leaderboard list returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Example: success

object

Paginated leaderboard data.

cursor

string

Pagination cursor for the next page. Empty string when no more data.

Example:

object[]

List of leaderboard wallet entries.

walletAddress

string

Wallet address.

Example: 0x28c6c06298d514db089934071355e5743bf21d60

walletName

string

Wallet display name. Empty string when unavailable.

Example: Smart Money #1

walletLogoUrl

string

Wallet avatar URL. Empty string when unavailable.

Example:

walletTwitterUrl

string

Associated Twitter/X profile URL. Empty string when unavailable.

Example: https://x.com/example_trader

walletType

string

Wallet type tags, comma-separated if multiple. 1=Smart Money, 2=KOL, 3=Hot List. Empty string when no tag applies.

Example: 1,2

nativeTokenBalance

string

Native token balance of this address on the queried chain.

Example: 12.5

nativeTokenBalanceUsd

string

Native token balance of this address, denominated in USD.

Example: 31250.00

realizedPnlUsd

string

Cumulative realized PnL within the time frame, denominated in USD. Positive means profit, negative means loss.

Example: 1204530.647494

realizedPnlPercent

string

Realized PnL percentage within the time frame. No percent sign included.

Example: 1699.97

object[]

Daily realized PnL within the selected time frame, sorted by date descending.

date

string

Date in YYYY-MM-DD format.

Example: 2026-04-25

pnlUsd

string

Realized PnL for this day, denominated in USD.

Example: 12000.50

winRatePercent

string

Win rate within the time frame. No percent sign included.

Example: 100.0

txVolume

string

Total transaction volume within the time frame, denominated in USD. Equals buyTxVolume + sellTxVolume.

Example: 1346559.275964

buyTxVolume

string

Total buy volume within the time frame, denominated in USD.

Example: 673279.637982

sellTxVolume

string

Total sell volume within the time frame, denominated in USD.

Example: 673279.637982

avgBuyValueUsd

string

Average buy value per transaction within the time frame, denominated in USD. Returns "0" when no buy transactions.

Example: 23724.225

txs

string

Total transaction count within the time frame. Equals buyTxCount + sellTxCount.

Example: 40

buyTxCount

string

Buy transaction count within the time frame.

Example: 20

sellTxCount

string

Sell transaction count within the time frame.

Example: 20

object[]

Top 3 tokens by realized PnL. Returns fewer items if fewer than 3 tokens were traded.

tokenContractAddress

string

Token contract address. EVM addresses are lowercase; Solana addresses are case-sensitive.

Example: 0xdac17f958d2ee523a2206206994597c13d831ec7

tokenSymbol

string

Token symbol.

Example: USDT

tokenLogoUrl

string

Token logo URL.

Example: https://static.onchainos.com/tokens/usdt.png

tokenPnLUsd

string

Realized PnL for this token, denominated in USD. Positive means profit, negative means loss.

Example: 5000.50

tokenPnLPercent

string

Realized PnL percentage for this token. No percent sign included.

Example: 250.5

object

Token count breakdown by realized PnL percentage range within the time frame.

above500Percent

string

Number of tokens with realized PnL >500%.

Example: 3

between0And500Percent

string

Number of tokens with realized PnL in [0%, 500%].

Example: 8

betweenNeg50And0Percent

string

Number of tokens with realized PnL in [-50%, 0%].

Example: 5

belowNeg50Percent

string

Number of tokens with realized PnL < -50%.

Example: 2

lastActiveTimestamp

string

Timestamp of the address's last trade, Unix millisecond timestamp.

Example: 1776995058000

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

GET/api/v1/dex/market/leaderboard/list

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/market/leaderboard/list?binanceChainId=%3Cstring%3E&timeFrame=%3Cstring%3E&sortBy=%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": "",
    "items": [
      {
        "walletAddress": "0x28c6c06298d514db089934071355e5743bf21d60",
        "walletName": "Smart Money #1",
        "walletLogoUrl": "",
        "walletTwitterUrl": "https://x.com/example_trader",
        "walletType": "1,2",
        "nativeTokenBalance": "12.5",
        "nativeTokenBalanceUsd": "31250.00",
        "realizedPnlUsd": "1204530.647494",
        "realizedPnlPercent": "1699.97",
        "dailyPnl": [
          {
            "date": "2026-04-25",
            "pnlUsd": "12000.50"
          }
        ],
        "winRatePercent": "100.0",
        "txVolume": "1346559.275964",
        "buyTxVolume": "673279.637982",
        "sellTxVolume": "673279.637982",
        "avgBuyValueUsd": "23724.225",
        "txs": "40",
        "buyTxCount": "20",
        "sellTxCount": "20",
        "topPnlTokenList": [
          {
            "tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
            "tokenSymbol": "USDT",
            "tokenLogoUrl": "https://static.onchainos.com/tokens/usdt.png",
            "tokenPnLUsd": "5000.50",
            "tokenPnLPercent": "250.5"
          }
        ],
        "tokenCountByPnlPercent": {
          "above500Percent": "3",
          "between0And500Percent": "8",
          "betweenNeg50And0Percent": "5",
          "belowNeg50Percent": "2"
        },
        "lastActiveTimestamp": "1776995058000"
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get Tracked Trades

Return the latest swap trades from tracked addresses (smart money, KOL, or custom address list).

GET

/api/v1/dex/market/address-tracker/trades

https://web3.binance.com/build

Get Tracked Trades › 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 Tracked Trades › 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 Tracked Trades › Query Parameters

trackerType

string · enum · required

Tracker type. 1=Smart Money, 2=KOL, 3=Custom address list (walletAddress required).

Enum values:

Example: 1

walletAddress

string

Required when trackerType=3. One or more wallet addresses, comma-separated, up to 20. EVM chains accept lowercase 42-character hex addresses; Solana accepts base58 addresses (case-sensitive).

Example: 0x28c6c06298d514db089934071355e5743bf21d60,0xd8da6bf26964af9d7eed9e03e53415d37aa96045

tradeType

string

Trade type filter. 0=All (default), 1=Buy, 2=Sell, 3=Add position, 4=Reduce position, 5=Open position, 6=Close position, 7=Transfer in, 8=Transfer out. Multiple values comma-separated.

Example: 0

binanceChainId

string

Filter by chain. Returns all chains when omitted.

Example: 1

minVolume

string

Minimum trade volume filter, denominated in USD.

Example: 100

maxVolume

string

Maximum trade volume filter, denominated in USD.

Example: 100000

minMarketCap

string

Minimum market cap filter, denominated in USD.

Example: 10000

maxMarketCap

string

Maximum market cap filter, denominated in USD.

Example: 10000000

isHideRiskToken

boolean

Whether to hide risk tokens. true=hide risk tokens (default), false=show all tokens including risk tokens.

Example: true

Default: true

limit

integer · int32

Maximum number of trades to return. Effective only for trackerType=3 (custom address list); trackerType=1/2 ignore this and use the downstream public query fixed cap. Omit to use the downstream default.

Example: 50

Get Tracked Trades › Responses

Address tracker trades returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Example: success

object

Tracker trade results.

object[]

List of tracked address trades.

txHash

string

On-chain transaction hash.

Example: 0x3a2b1c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b

walletAddress

string

Wallet address that initiated this trade. EVM addresses are lowercase; Solana addresses are case-sensitive.

Example: 0x28c6c06298d514db089934071355e5743bf21d60

tokenSymbol

string

Symbol of the traded token.

Example: PEPE

tokenContractAddress

string

Contract address of the traded token. EVM addresses are lowercase; Solana addresses are case-sensitive.

Example: 0x6982508145454ce325ddbe47a25d4ec3d2311933

binanceChainId

string

Unique chain identifier of the traded token.

Example: 1

tokenPrice

string

Token price at the time of this trade, denominated in USD.

Example: 0.00153

marketCap

string

Token market cap at the time of this trade, denominated in USD.

Example: 1534835.38

tradeType

string

Trade type. 1=Buy, 2=Sell, 3=Add position, 4=Reduce position, 5=Open position, 6=Close position, 7=Transfer in, 8=Transfer out.

Example: 1

tradeTime

string

On-chain time of this trade, Unix millisecond timestamp.

Example: 1777113793000

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

GET/api/v1/dex/market/address-tracker/trades

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/market/address-tracker/trades?trackerType=%3Cstring%3E' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "trades": [
      {
        "txHash": "0x3a2b1c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b",
        "walletAddress": "0x28c6c06298d514db089934071355e5743bf21d60",
        "tokenSymbol": "PEPE",
        "tokenContractAddress": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
        "binanceChainId": "1",
        "tokenPrice": "0.00153",
        "marketCap": "1534835.38",
        "tradeType": "1",
        "tradeTime": "1777113793000"
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json