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
- 1. 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
8453 |
| Solana | CT_501 |
API 1: Social Hype Leaderboard
Method: GET
URL:
CODEBLOCK0
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: INLINECODE8
Example:
CODEBLOCK1
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:
CODEBLOCK2
Headers: Content-Type: application/json, INLINECODE12
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
leastone,
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=dexpaid,
29=alpha_points, etc. |
Sort Options
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
CODEBLOCK3
Response
CODEBLOCK4
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:
CODEBLOCK5
Headers: Content-Type: application/json, INLINECODE39
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 | No | Address tag type (e.g.
2) |
Example Request
CODEBLOCK6
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:
CODEBLOCK7
Headers: INLINECODE50
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
CODEBLOCK8
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:
CODEBLOCK9
Headers: INLINECODE55
Request Parameters:
| Parameter | Type | Required | Description |
|---|
| chainId | string | Yes | Chain ID: 56 (BSC), CT_501 (Solana) |
| period |
string | No | Time period:
7d,
30d,
90d |
| tag | string | No | 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
CODEBLOCK10
Response
CODEBLOCK11
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) |
Notes
- 1. 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.
加密货币市场排名技能
概述
| API | 功能 | 使用场景 |
|---|
| 社交热度排行榜 | 社交热度排名 | 情绪分析、社交摘要 |
| 统一代币排名 |
多类型代币排名 | 热门趋势、热搜、Alpha、股票（带筛选） |
| 聪明钱流入排名 | 按聪明钱买入量排名代币 | 发现聪明钱买入最多的代币 |
| Meme排名 | Pulse发射台顶级Meme代币 | 寻找最可能爆发的Meme代币 |
| 地址盈亏排名 | 顶级交易者盈亏排行榜 | 顶级盈亏交易者/KOL表现排名 |
使用场景
- 1. 社交热度分析：发现社交热度最高、情绪最强烈的代币
- 热门趋势代币：查看当前热门趋势代币（rankType=10）
- 热搜代币：查看搜索最多的代币（rankType=11）
- Alpha发现：浏览币安Alpha精选（rankType=20）
- 股票代币：查看代币化股票（rankType=40）
- 聪明钱流入：发现聪明钱买入最多的代币
- Meme排名：从Pulse发射台寻找最可能爆发的顶级Meme代币
- 盈亏排行榜：查看表现最佳的交易者地址、盈亏、胜率
- 筛选研究：组合筛选条件进行针对性代币或地址筛选
支持的链
8453 |
| Solana | CT_501 |
API 1：社交热度排行榜
方法：GET
URL：
https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/social/hype/rank/leaderboard
请求参数：
| 参数 | 类型 | 必填 | 描述 |
|---|
| chainId | string | 是 | 链ID |
| sentiment |
string | 否 | 筛选：All、Positive、Negative、Neutral |
| targetLanguage | string | 是 | 翻译目标语言，例如 en、zh |
| timeRange | number | 是 | 时间范围，1 = 24小时 |
| socialLanguage | string | 否 | 内容语言，ALL 表示全部 |
请求头：Accept-Encoding: identity
示例：
bash
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
响应（data.leaderBoardList[]）：
| 字段路径 | 类型 | 描述 |
|---|
| metaInfo.logo | string | 图标URL路径（前缀 https://bin.bnbstatic.com） |
| metaInfo.symbol |
string | 代币符号 |
| metaInfo.chainId | string | 链ID |
| metaInfo.contractAddress | string | 合约地址 |
| metaInfo.tokenAge | number | 创建时间戳（毫秒） |
| marketInfo.marketCap | number | 市值（美元） |
| marketInfo.priceChange | number | 价格变化（%） |
| socialHypeInfo.socialHype | number | 总社交热度指数 |
| socialHypeInfo.sentiment | string | 正面/负面/中性 |
| socialHypeInfo.socialSummaryBrief | string | 简短社交摘要 |
| socialHypeInfo.socialSummaryDetail | string | 详细社交摘要 |
| socialHypeInfo.socialSummaryBriefTranslated | string | 翻译后的简短摘要 |
| socialHypeInfo.socialSummaryDetailTranslated | string | 翻译后的详细摘要 |
API 2：统一代币排名
方法：POST（推荐）/ GET
URL：
https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/unified/rank/list
请求头：Content-Type: application/json、Accept-Encoding: identity
排名类型
| rankType | 名称 | 描述 |
|---|
| 10 | 热门趋势 | 热门趋势代币 |
| 11 |
热搜 | 搜索最多的代币 |
| 20 | Alpha | Alpha代币（币安Alpha精选） |
| 40 | 股票 | 代币化股票代币 |
请求体（所有字段可选）
核心参数：
| 字段 | 类型 | 默认值 | 描述 |
|---|
| rankType | integer | 10 | 排名类型：10=热门趋势、11=热搜、20=Alpha、40=股票 |
| chainId |
string | - | 链ID：1、56、8453、CT_501 |
| period | integer | 50 | 时间段：10=1分钟、20=5分钟、30=1小时、40=4小时、50=24小时 |
| sortBy | integer | 0 | 排序字段（见排序选项） |
| orderAsc | boolean | false | 如果为true则升序排列 |
| page | integer | 1 | 页码（最小1） |
| size | integer | 200 | 每页大小（最大200） |
筛选参数（最小值/最大值配对）：
| 筛选条件 | 类型 | 描述 |
|---|
| percentChangeMin/Max | decimal | 价格变化范围（%） |
| marketCapMin/Max |
decimal | 市值范围（美元） |
| volumeMin/Max | decimal | 交易量范围（美元） |
| liquidityMin/Max | decimal | 流动性范围（美元） |
| holdersMin/Max | long | 持有者数量范围 |
| holdersTop10PercentMin/Max | decimal | 前10持有者占比范围 |
| kycHoldersMin/Max | long | KYC持有者数量（仅Alpha） |
| countMin/Max | long | 交易次数范围 |
| uniqueTraderMin/Max | long | 唯一交易者数量范围 |
| launchTimeMin/Max | long | 代币上线时间范围（时间戳毫秒） |
高级筛选：
| 字段 | 类型 | 描述 |
|---|
| keywords | string[] | 包含匹配这些关键词的符号 |
| excludes |
string[] | 排除这些符号 |
| socials | integer[] | 社交筛选：0=至少一个、1=X、2=Telegram、3=网站 |
| alphaTagFilter | string[] | Alpha叙事标签 |
| auditFilter | integer[] | 审计：0=未放弃、1=可冻结、2=可增发 |
| tagFilter | integer[] | 标签筛选：0=隐藏alpha、23=dex已付费、29=alpha积分等 |
排序选项
网页默认 |
| 2 | 搜索次数 |
| 10 | 上线时间 |
| 20 | 流动性 |
| 30 | 持有者 |
| 40 | 市值 |
| 50 | 价格变化 |
| 60 | 交易次数 |
| 70 | 交易量 |
| 80 | KYC持有者 |
| 90 | 价格 |
| 100 | 唯一交易者 |
示例请求
bash
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 \
-d {rankType:10,chainId:1,period:50,sortBy:70,orderAsc:false,page:1,size:20}
响应
json
{
code: 000000,
data: {
tokens: [{ ... }],
total: 100,
page: 1,
size: 20
},
success: true
}
代币字段（data.tokens[]）：
| 字段 | 类型 | 描述 |
|---|
| chainId | string | 链ID |
| contractAddress |
string | 合约地址 |
| symbol | string | 代币符号 |
| icon | string | 图标URL路径（
