Crypto Market Rank Skill

Overview

API Function Use Case

Social Hype Leaderboard Social buzz ranking Sentiment analysis, social summaries

Unified Token Rank Multi-type token rankings Trending, Top Search, Alpha, Stock with filters

Smart Money Inflow Rank Token rank by smart money buys Discover tokens smart money is buying most

Meme Rank Top meme tokens from Pulse launchpad Find meme tokens most likely to break out

Address Pnl Rank Top trader PnL leaderboard Top PnL traders / KOL performance ranking

Use Cases

• Social Hype Analysis: Discover tokens with highest social buzz and sentiment

• Trending Tokens: View currently trending tokens (rankType=10)

• Top Searched: See most searched tokens (rankType=11)

• Alpha Discovery: Browse Binance Alpha picks (rankType=20)

• Stock Tokens: View tokenized stocks (rankType=40)

• Smart Money Inflow: Discover which tokens smart money is buying most

• Meme Rank: Find top meme tokens from Pulse launchpad most likely to break out

• PnL Leaderboard: View top-performing trader addresses, PnL, win rates

• Filtered Research: Combine filters for targeted token or address screening

Supported Chains

Chain chainId

BSC 56

Base 8453

Solana CT_501

API 1: Social Hype Leaderboard

Method: GET

URL:

https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/social/hype/rank/leaderboard

Request Parameters:

Parameter Type Required Description

chainId string Yes Chain ID

sentiment string No Filter: All , Positive , Negative , Neutral

targetLanguage string Yes Translation target, e.g., en , zh

timeRange number Yes Time range, 1 = 24 hours

socialLanguage string No Content language, ALL for all

Headers: Accept-Encoding: identity

Example:

curl 'https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/social/hype/rank/leaderboard?chainId=56&sentiment=All&socialLanguage=ALL&targetLanguage=en&timeRange=1'
-H 'Accept-Encoding: identity'
-H 'User-Agent: binance-web3/2.0 (Skill)'

Response (data.leaderBoardList[] ):

Field Path Type Description

metaInfo.logo string Icon URL path (prefix https://bin.bnbstatic.com )

metaInfo.symbol string Token symbol

metaInfo.chainId string Chain ID

metaInfo.contractAddress string Contract address

metaInfo.tokenAge number Creation timestamp (ms)

marketInfo.marketCap number Market cap (USD)

marketInfo.priceChange number Price change (%)

socialHypeInfo.socialHype number Total social hype index

socialHypeInfo.sentiment string Positive / Negative / Neutral

socialHypeInfo.socialSummaryBrief string Brief social summary

socialHypeInfo.socialSummaryDetail string Detailed social summary

socialHypeInfo.socialSummaryBriefTranslated string Translated brief summary

socialHypeInfo.socialSummaryDetailTranslated string Translated detailed summary

API 2: Unified Token Rank

Method: POST (recommended) / GET

URL:

https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/unified/rank/list

Headers: Content-Type: application/json , Accept-Encoding: identity

Rank Types

rankType Name Description

10 Trending Hot trending tokens

11 Top Search Most searched tokens

20 Alpha Alpha tokens (Binance Alpha picks)

40 Stock Tokenized stock tokens

Request Body (all fields optional)

Core Parameters:

Field Type Default Description

rankType integer 10 Rank type: 10 =Trending, 11 =TopSearch, 20 =Alpha, 40 =Stock

chainId string

Chain ID: 1 , 56 , 8453 , CT_501

period integer 50 Time period: 10 =1m, 20 =5m, 30 =1h, 40 =4h, 50 =24h

sortBy integer 0 Sort field (see Sort Options)

orderAsc boolean false Ascending order if true

page integer 1 Page number (min 1)

size integer 200 Page size (max 200)

Filter Parameters (Min/Max pairs):

Filter Type Description

percentChangeMin/Max decimal Price change range (%)

marketCapMin/Max decimal Market cap range (USD)

volumeMin/Max decimal Volume range (USD)

liquidityMin/Max decimal Liquidity range (USD)

holdersMin/Max long Holder count range

holdersTop10PercentMin/Max decimal Top10 holder % range

kycHoldersMin/Max long KYC holder count (Alpha only)

countMin/Max long Transaction count range

uniqueTraderMin/Max long Unique trader count range

launchTimeMin/Max long Token launch time range (timestamp ms)

Advanced Filters:

Field Type Description

keywords string[] Include symbols matching these keywords

excludes string[] Exclude these symbols

socials integer[] Social filter: 0 =at_least_one, 1 =X, 2 =Telegram, 3 =Website

alphaTagFilter string[] Alpha narrative tags

auditFilter integer[] Audit: 0 =not_renounced, 1 =freezable, 2 =mintable

tagFilter integer[] Tag filter: 0 =hide_alpha, 23 =dex_paid, 29 =alpha_points, etc.

Sort Options

sortBy Field

0 Default

1 Web default

2 Search count

10 Launch time

20 Liquidity

30 Holders

40 Market cap

50 Price change

60 Transaction count

70 Volume

80 KYC holders

90 Price

100 Unique traders

Example Request

curl -X POST 'https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/unified/rank/list'
-H 'Content-Type: application/json'
-H 'Accept-Encoding: identity'
-H 'User-Agent: binance-web3/2.0 (Skill)'
-d '{"rankType":10,"chainId":"1","period":50,"sortBy":70,"orderAsc":false,"page":1,"size":20}'

Response

{ "code": "000000", "data": { "tokens": [{ "..." }], "total": 100, "page": 1, "size": 20 }, "success": true }

Token Fields (data.tokens[] ):

Field Type Description

chainId string Chain ID

contractAddress string Contract address

symbol string Token symbol

icon string Logo URL path (prefix https://bin.bnbstatic.com )

price string Current price (USD)

marketCap string Market cap

liquidity string Liquidity

holders string Holder count

launchTime string Launch timestamp (ms)

decimals integer Token decimals

links string Social links JSON

percentChange{1m,5m,1h,4h,24h} string Price change by period (%)

volume{1m,5m,1h,4h,24h} string Volume by period (USD)

volume{1m,5m,1h,4h,24h}Buy/Sell string Buy/Sell volume by period

count{1m,5m,1h,4h,24h} string Transaction count by period

count{1m,5m,1h,4h,24h}Buy/Sell string Buy/Sell tx count by period

uniqueTrader{1m,5m,1h,4h,24h} string Unique traders by period

alphaInfo object Alpha info (tagList, description)

auditInfo object Audit info (riskLevel, riskNum, cautionNum)

tokenTag object Token tag info

kycHolders string KYC holder count

holdersTop10Percent string Top10 holder percentage

API 3: Smart Money Inflow Rank

Method: POST

URL:

https://web3.binance.com/bapi/defi/v1/public/wallet-direct/tracker/wallet/token/inflow/rank/query

Headers: Content-Type: application/json , Accept-Encoding: identity

Request Body:

Field Type Required Description

chainId string Yes Chain ID: 56 (BSC), CT_501 (Solana)

period string No Stats window: 5m , 1h , 4h , 24h

tagType integer Yes Address tag type (always 2 )

Example Request

curl -X POST 'https://web3.binance.com/bapi/defi/v1/public/wallet-direct/tracker/wallet/token/inflow/rank/query'
-H 'Content-Type: application/json'
-H 'Accept-Encoding: identity'
-H 'User-Agent: binance-web3/2.0 (Skill)'
-d '{"chainId":"56","period":"24h","tagType":2}'

Response (data[] )

Field Type Description

tokenName string Token name

tokenIconUrl string Icon URL path (prefix https://bin.bnbstatic.com )

ca string Contract address

price string Current price (USD)

marketCap string Market cap (USD)

volume string Trading volume in period (USD)

priceChangeRate string Price change in period (%)

liquidity string Liquidity (USD)

holders string Total holder count

kycHolders string KYC holder count

holdersTop10Percent string Top10 holder percentage

count string Transaction count in period

countBuy / countSell string Buy / Sell tx count

inflow number Smart money net inflow amount (USD)

traders integer Number of smart money addresses trading this token

launchTime number Token launch timestamp (ms)

tokenDecimals integer Token decimals

tokenRiskLevel integer Risk level (-1=unknown, 1=low, 2=medium, 3=high)

link array Social links: [{label, link}]

tokenTag object Token tags by category

API 4: Meme Rank

Method: GET

URL:

https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/exclusive/rank/list

Headers: Accept-Encoding: identity

Request Parameters:

Parameter Type Required Description

chainId string Yes Chain ID: 56 (BSC)

Returns top 100 meme tokens launched via Pulse platform, scored and ranked by an algorithm evaluating breakout potential.

Example Request

curl 'https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/exclusive/rank/list?chainId=56'
-H 'Accept-Encoding: identity'
-H 'User-Agent: binance-web3/2.0 (Skill)'

Response (data.tokens[] )

Field Type Description

chainId string Chain ID

contractAddress string Contract address

symbol string Token symbol

rank integer Rank position

score string Algorithm score (higher = more likely to break out)

alphaStatus integer Alpha listing status

price string Current price (USD)

percentChange string Price change (%)

percentChange7d string 7-day price change (%)

marketCap string Market cap (USD)

liquidity string Liquidity (USD)

volume string Total volume (USD)

volumeBnTotal string Binance user total volume

volumeBn7d string Binance user 7-day volume

holders string Total holder count

kycHolders string KYC holder count

bnUniqueHolders string Binance unique holder count

holdersTop10Percent string Top10 holder percentage

count integer Total transaction count

countBnTotal integer Binance user total tx count

countBn7d integer Binance user 7-day tx count

uniqueTraderBn integer Binance unique traders

uniqueTraderBn7d integer Binance 7-day unique traders

impression integer Impression/view count

createTime number Token creation timestamp (ms)

migrateTime number Migration timestamp (ms)

metaInfo.icon string Icon URL path (prefix https://bin.bnbstatic.com )

metaInfo.name string Token full name

metaInfo.decimals integer Token decimals

metaInfo.aiNarrativeFlag integer AI narrative flag (1=yes)

previewLink object Social links: {website[], x[], telegram[]}

tokenTag object Token tags by category

API 5: Address Pnl Rank

Method: GET

URL:

https://web3.binance.com/bapi/defi/v1/public/wallet-direct/market/leaderboard/query

Headers: Accept-Encoding: identity

Request Parameters:

Parameter Type Required Description

chainId string Yes Chain ID: 56 (BSC), CT_501 (Solana)

period string Yes Time period: 7d , 30d , 90d

tag string Yes Address tag filter: ALL , KOL

sortBy integer No Sort field

orderBy integer No Order direction

pageNo integer No Page number (min 1)

pageSize integer No Page size (max 25)

Filter Parameters (Min/Max pairs):

Filter Type Description

PNLMin/Max decimal Realized PnL range (USD)

winRateMin/Max decimal Win rate range (percentage, e.g. 1 = 1%)

txMin/Max long Transaction count range

volumeMin/Max decimal Volume range (USD)

Example Request

curl 'https://web3.binance.com/bapi/defi/v1/public/wallet-direct/market/leaderboard/query?tag=ALL&pageNo=1&chainId=CT_501&pageSize=25&sortBy=0&orderBy=0&period=30d'
-H 'Accept-Encoding: identity'
-H 'User-Agent: binance-web3/2.0 (Skill)'

Response

{ "code": "000000", "data": { "data": [{ "..." }], "current": 1, "size": 25, "pages": 35 }, "success": true }

Address Fields (data.data[] ):

Field Type Description

address string Wallet address

addressLogo string Address avatar URL

addressLabel string Address display name

balance string On-chain balance (native token, e.g. SOL/BNB)

tags array Address tags (e.g. KOL)

realizedPnl string Realized PnL for the period (USD)

realizedPnlPercent string Realized PnL percentage

dailyPNL array Daily PnL list: [{realizedPnl, dt}]

winRate string Win rate for the period

totalVolume string Total trading volume (USD)

buyVolume / sellVolume string Buy / Sell volume

avgBuyVolume string Average buy amount

totalTxCnt integer Total transaction count

buyTxCnt / sellTxCnt integer Buy / Sell transaction count

totalTradedTokens integer Number of tokens traded

topEarningTokens array Top profit tokens: [{tokenAddress, tokenSymbol, tokenUrl, realizedPnl, profitRate}]

tokenDistribution object PnL distribution: {gt500Cnt, between0And500Cnt, between0AndNegative50Cnt, ltNegative50Cnt}

lastActivity number Last active timestamp (ms)

genericAddressTagList array Detailed tag info (tagName, logoUrl, extraInfo)

User Agent Header

Include User-Agent header with the following string: binance-web3/2.0 (Skill)

Notes

• Icon/logo URLs require prefix: https://bin.bnbstatic.com

• path

• Unified Token Rank supports both GET and POST; POST is recommended

• All numeric fields in responses are strings — parse when needed

• Period fields use shorthand: {1m,5m,1h,4h,24h} means separate fields like percentChange1m , percentChange5m , etc.