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/aiRequest 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/aiHeaders: 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/aiHeaders: 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/aiHeaders: 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/aiHeaders: 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 likepercentChange1m,percentChange5m, etc.
