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.

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.

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.

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.

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.

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.

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.

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

Address Portfolio

Endpointhttps://web3.binance.com/build

Download schema

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.

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.

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.

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.

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.

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.

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

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.

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