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/ai

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/ai?chainId=56&sentiment=All&socialLanguage=ALL&targetLanguage=en&timeRange=1' \

-H 'Accept-Encoding: identity' \

-H 'User-Agent: binance-web3/2.1 (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/ai

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/ai' \

-H 'Content-Type: application/json' \

-H 'Accept-Encoding: identity' \

-H 'User-Agent: binance-web3/2.1 (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/ai

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/ai' \

-H 'Content-Type: application/json' \

-H 'Accept-Encoding: identity' \

-H 'User-Agent: binance-web3/2.1 (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/ai

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/ai?chainId=56' \

-H 'Accept-Encoding: identity' \

-H 'User-Agent: binance-web3/2.1 (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/ai

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/ai?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.1 (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.1 (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.