CoinMarketCap 排名、自选与持仓
CoinMarketCap: Crypto Tracker 是币安旗下 CoinMarketCap(coinmarketcap.com)的安卓客户端。用户按市值排币、打开带图表与供给统计的币种页、维护命名自选、跟踪持仓账本(手填或交易所联动)、设置价格预警,并看比特币主导率与恐惧贪婪指数等全球卡片。全球零售持币者、台桌分析师与业余交易者把它当行情与组合跟踪器而非券商,与 Investing.com、TradingView、Yahoo Finance、Binance 并列。
排名列表行钉住 cmcRank、symbol 与嵌套的 percentChange24h 报价,币种页再加上 marketCapDominance、highAllTime 和 watchCount。自选返回 watchListId 与 cryptoCurrencies;持仓行带 balance、cryptocurrencyId 和 valueChange24h,账本汇总落在 currentTotalHoldings、plValue 与 unrealizedProfit。全球指标给出 btcDominance 与恐惧贪婪 score;预警把 targetPrice 对上 coinId。
投研台把排行报价接到自选 id,PMS 机器人对账持仓盈亏,宏观屏把主导率与恐惧贪婪盖到账本上。openData Studio 把这套排行、持仓与预警表面做成可调用的开放数据。
应用截图
API 端点一览
以下端点与请求/响应示例均依据应用界面推导重构,为示意说明,并非实际抓包。
加密货币排行
GET
/v1/markets/rankingsopendata分页首页排行:tickers.cryptoCurrencyList 行带 cmcRank、symbol、circulatingSupply 以及嵌套 Quote 的 price / percentChange24h / marketCap。
认证方式: 每次调用带 Bearer 令牌:未登录浏览使用匿名访客令牌,已登录则使用用户访问令牌。请求同时附带客户端平台与应用版本头。
- tickers
- cryptoCurrencyList
- totalCount
- id
- name
- symbol
- slug
- cmcRank
- marketPairCount
- circulatingSupply
- totalSupply
- maxSupply
- quotes
- price
- percentChange1h
- percentChange24h
- percentChange7d
- percentChange30d
- volume24h
- marketCap
- dominance
- fullyDilluttedMarketCap
- turnover
- ytdPriceChangePercentage
- error_code
- error_message
GET /v1/markets/rankings?convertIds=2781&start=1&limit=100&sortBy=cmc_rank&sortType=desc&status=active HTTP/1.1 Accept: application/json Authorization: Bearer <guest_or_access_token>{ "tickers": { "cryptoCurrencyList": [ { "id": 1, "name": "Bitcoin", "symbol": "BTC", "slug": "bitcoin", "cmcRank": 1, "marketPairCount": 11840, "circulatingSupply": 19800000.0, "totalSupply": 19800000.0, "maxSupply": 21000000.0, "quotes": [ { "name": "USD", "price": 67420.12, "percentChange1h": 0.12, "percentChange24h": -1.84, "percentChange7d": 3.41, "percentChange30d": 8.02, "volume24h": 28450000000.0, "marketCap": 1334000000000.0, "dominance": 54.2, "fullyDilluttedMarketCap": 1415000000000.0, "turnover": 0.021, "ytdPriceChangePercentage": 42.5, "lastUpdated": "2026-10-17T12:00:00.000Z" } ] } ], "totalCount": 9999 }, "status": { "error_code": 0, "error_message": "" } }最新报价
GET
/v1/markets/quotesopendata按币种 id 刷新最新 Quote:price、percentChange1h/24h/7d、volume24h 与 marketCap。
认证方式: 每次调用带 Bearer 令牌:未登录浏览使用匿名访客令牌,已登录则使用用户访问令牌。请求同时附带客户端平台与应用版本头。
- id
- name
- symbol
- slug
- cmcRank
- quotes
- price
- percentChange1h
- percentChange24h
- percentChange7d
- volume24h
- marketCap
- lastUpdated
- error_code
GET /v1/markets/quotes?id=1,1027&convertIds=2781 HTTP/1.1 Accept: application/json Authorization: Bearer <guest_or_access_token>{ "data": [ { "id": 1, "name": "Bitcoin", "symbol": "BTC", "slug": "bitcoin", "cmcRank": 1, "quotes": [ { "name": "USD", "price": 67420.12, "percentChange1h": 0.12, "percentChange24h": -1.84, "percentChange7d": 3.41, "volume24h": 28450000000.0, "marketCap": 1334000000000.0, "lastUpdated": "2026-10-17T12:00:00.000Z" } ] } ], "status": { "error_code": 0, "error_message": "" } }币种详情
GET
/v1/assets/{asset_id}opendata加载币种页:id/slug 身份、watchCount,以及 Statistics 的 price、marketCapDominance、highAllTime 与 circulatingSupply。
认证方式: 每次调用带 Bearer 令牌:未登录浏览使用匿名访客令牌,已登录则使用用户访问令牌。请求同时附带客户端平台与应用版本头。
- id
- name
- symbol
- slug
- category
- dateAdded
- description
- watchCount
- volume
- volumeChangePercentage24h
- statistics
- price
- marketCap
- marketCapDominance
- high24h
- low24h
- highAllTime
- priceChangePercentage24h
- circulatingSupply
- fullyDilutedMarketCap
- rank
GET /v1/assets/1 HTTP/1.1 Accept: application/json Authorization: Bearer <guest_or_access_token>{ "id": 1, "name": "Bitcoin", "symbol": "BTC", "slug": "bitcoin", "category": "coin", "dateAdded": "2010-07-13T00:00:00.000Z", "description": "Bitcoin is a decentralized cryptocurrency.", "watchCount": "4200000", "volume": 28450000000.0, "volumeChangePercentage24h": -4.2, "statistics": { "price": 67420.12, "marketCap": 1334000000000.0, "marketCapDominance": 54.2, "high24h": 68110.0, "low24h": 66102.0, "highAllTime": 73750.07, "priceChangePercentage24h": -1.84, "circulatingSupply": 19800000.0, "fullyDilutedMarketCap": 1415000000000.0, "rank": 1 } }全球指标
GET
/v1/markets/overviewopendata读取市场总览卡:metric.volume24 / marketCap、fearGreed.score,以及 dominance.btcDominance / ethDominance。
认证方式: 每次调用带 Bearer 令牌:未登录浏览使用匿名访客令牌,已登录则使用用户访问令牌。请求同时附带客户端平台与应用版本头。
- metric
- volume24
- volume24hChangePercent
- marketCap
- marketCapChangePercent
- btcMarketCap
- ethMarketCap
- fearGreed
- score
- dominance
- btcDominance
- ethDominance
- btcPrice
- ethPrice
- altcoinIndex
- avgRSI
- avgMACD
- timestamp
GET /v1/markets/overview HTTP/1.1 Accept: application/json Authorization: Bearer <guest_or_access_token>{ "metric": { "volume24": 98400000000.0, "volume24hChangePercent": -3.1, "marketCap": 2460000000000.0, "marketCapChangePercent": -1.4, "btcMarketCap": 1334000000000.0, "ethMarketCap": 401000000000.0 }, "fearGreed": { "score": 47.0 }, "dominance": { "btcDominance": 54.2, "ethDominance": 16.3 }, "btcPrice": 67420.12, "ethPrice": 3320.4, "altcoinIndex": 62.0, "avgRSI": 51.2, "avgMACD": -12.4, "timestamp": "2026-10-17T12:00:00.000Z" }自选查询
POST
/v1/watchlists/searchopenfinance返回已登录 watchLists:watchListId、name、cryptoSize 以及嵌套 cryptoCurrencies 的 id/symbol/rank 行。
认证方式: 已登录会话的 Authorization Bearer access_token。请求同时附带客户端平台与应用版本头。
- watchListId
- watchListType
- convertIds
- aux
- isMain
- cryptoAux
- limit
- dexMigration
- watchLists
- name
- cryptoSize
- main
- shared
- followerSize
- cryptoCurrencies
- id
- symbol
- slug
- rank
- circulatingSupply
- marketPairCount
POST /v1/watchlists/search HTTP/1.1 Accept: application/json Authorization: Bearer <access_token> Content-Type: application/json { "watchListId": "wl_main", "watchListType": "cryptocurrency", "convertIds": "2781", "aux": 0, "isMain": true, "cryptoAux": "cmc_rank,circulating_supply", "limit": 100 }{ "watchListType": "cryptocurrency", "dexMigration": false, "watchLists": [ { "watchListId": "wl_main", "name": "Main", "cryptoSize": 12, "main": true, "shared": false, "followerSize": "0", "cryptoCurrencies": [ { "id": 1, "name": "Bitcoin", "symbol": "BTC", "slug": "bitcoin", "rank": 1, "circulatingSupply": 19800000.0, "marketPairCount": 11840 } ] } ] }自选摘要
POST
/v1/watchlists/cardsopenfinance列出自选卡片:watchListId、name、totalAssetSize、cryptoSize、followerSize 与 topCrypto id。
认证方式: 已登录会话的 Authorization Bearer access_token。请求同时附带客户端平台与应用版本头。
- watchListId
- name
- type
- main
- shared
- totalAssetSize
- cryptoSize
- followerSize
- topCrypto
- description
POST /v1/watchlists/cards HTTP/1.1 Accept: application/json Authorization: Bearer <access_token> Content-Type: application/json {}{ "watchListId": "wl_main", "name": "Main", "type": "cryptocurrency", "main": true, "shared": false, "totalAssetSize": 12, "cryptoSize": 12, "followerSize": 0, "topCrypto": [1, 1027, 825], "description": "" }组合持仓
POST
/v1/portfolios/holdings/searchopenfinance分页仪表盘 holdingList:cryptocurrencyId、balance、currentPrice、value 与 valueChange24h,外加 statisticsInfo.totalValue。
认证方式: 已登录会话的 Authorization Bearer access_token。请求同时附带客户端平台与应用版本头。
- convertFiatId
- convertCryptoId
- currentPage
- pageSize
- sortBy
- sortType
- cryptoUnitPrice
- fiatUnitPrice
- statisticsInfo
- totalValue
- totalValueChange24h
- totalValueChangePercentage24h
- hasPortfolio
- holdingList
- cryptocurrencyId
- name
- symbol
- balance
- currentPrice
- value
- valueChange24h
- valueChangePercentage24h
- holdingsPercent
- contractAddress
- platformName
POST /v1/portfolios/holdings/search HTTP/1.1 Accept: application/json Authorization: Bearer <access_token> Content-Type: application/json { "convertFiatId": 2781, "convertCryptoId": 1, "currentPage": 1, "pageSize": 20, "sortBy": "value", "sortType": "desc" }{ "cryptoUnitPrice": 67420.12, "fiatUnitPrice": 1.0, "pageSize": 20.0, "statisticsInfo": { "totalValue": 12850.4, "totalValueChange24h": -210.3, "totalValueChangePercentage24h": -1.61, "hasPortfolio": true }, "holdingList": [ { "cryptocurrencyId": 1, "name": "Bitcoin", "symbol": "BTC", "balance": 0.15, "currentPrice": 67420.12, "value": 10113.02, "valueChange24h": -186.4, "valueChangePercentage24h": -1.81, "holdingsPercent": 78.7, "contractAddress": "", "platformName": "Bitcoin", "platformId": 1 } ] }组合汇总统计
POST
/v1/portfolios/totalsopenfinance读取账本汇总:currentTotalHoldings、changeValue24h、plValue、totalBuySpent、realizedProfit 与 unrealizedProfit。
认证方式: 已登录会话的 Authorization Bearer access_token。请求同时附带客户端平台与应用版本头。
- portfolioStatistics
- cryptoUnitPrice
- fiatUnitPrice
- currentTotalHoldings
- preTotalHoldings
- changeValue24h
- changePercent24h
- plValue
- plPercentValue
- totalBuySpent
- realizedProfit
- unrealizedProfit
- walletAddress
- lastUpdated
POST /v1/portfolios/totals HTTP/1.1 Accept: application/json Authorization: Bearer <access_token> Content-Type: application/json { "convertFiatId": 2781, "convertCryptoId": 1 }{ "portfolioStatistics": { "cryptoUnitPrice": 67420.12, "fiatUnitPrice": 1.0, "currentTotalHoldings": 12850.4, "preTotalHoldings": 13060.7, "changeValue24h": -210.3, "changePercent24h": -1.61, "plValue": 1840.2, "plPercentValue": 16.7, "totalBuySpent": 11010.2, "realizedProfit": 120.0, "unrealizedProfit": 1720.2, "walletAddress": "", "lastUpdated": "2026-10-17T12:00:00.000Z" } }用户资料
POST
/v1/account/profile/lookuposint读取已登录 UserInfoData:id/uid、email、username、displayFiatCurrencyId 与 emailVerified。
认证方式: 已登录会话的 Authorization Bearer access_token。请求同时附带客户端平台与应用版本头。
- platform
- id
- uid
- username
- nickname
- emailVerified
- authType
- accountType
- avatarId
- displayCryptoCurrencyId
- displayFiatCurrencyId
- isActive
- hasPasswordSet
- roles
- localTimeZoneName
POST /v1/account/profile/lookup HTTP/1.1 Accept: application/json Authorization: Bearer <access_token> Content-Type: application/json { "platform": "android" }{ "id": "u_88001122", "uid": "88001122", "username": "alexrivera", "nickname": "Alex", "email": "[email protected]", "emailVerified": true, "authType": 1, "accountType": 0, "avatarId": "av_12", "displayCryptoCurrencyId": 1, "displayFiatCurrencyId": 2781, "isActive": true, "hasPasswordSet": true, "roles": ["user"], "localTimeZoneName": "America/New_York" }价格预警列表
GET
/v1/alerts/priceopenfinance列出已保存 priceAlerts:coinId、coinSymbol、targetPrice、targetIsGreaterThan、isEnabled 与 syncId。
认证方式: 已登录会话的 Authorization Bearer access_token。请求同时附带客户端平台与应用版本头。
- priceAlerts
- syncId
- alertType
- coinId
- coinName
- coinSymbol
- targetPrice
- targetIsGreaterThan
- targetPercent
- isEnabled
- isRecurring
- timeCreated
- timeTriggered
- timeUpdated
GET /v1/alerts/price HTTP/1.1 Accept: application/json Authorization: Bearer <access_token>{ "priceAlerts": [ { "syncId": "pa_99102", "alertType": "price", "coinId": 1, "coinName": "Bitcoin", "coinSymbol": "BTC", "targetPrice": 70000.0, "targetIsGreaterThan": true, "targetPercent": "", "isEnabled": true, "isRecurring": false, "timeCreated": "2026-09-01T08:11:00.000Z", "timeTriggered": "", "timeUpdated": "2026-09-01T08:11:00.000Z" } ] }
数据类别
- 市场排行
- 币种报价
- 全球指标
- 自选
- 组合持仓
- 价格预警
- 用户资料
数据使用场景与案例
排行行情分发
投研机器人把排行 cmcRank 与 symbol 对到实时 Quote 的 price / percentChange24h,在 BTC 及同业的 marketCap 或 dominance 越过台桌区间时发提醒。
持仓盈亏对账
PMS 把 holdingList 的 balance、currentPrice、valueChange24h 以及 currentTotalHoldings / plValue / unrealizedProfit 与内部台账比对,让加密账隔夜对齐。
自选行情叠加
财富页把 watchListId 下的 cryptoCurrencies 盖到排行带上,再按 holdingsPercent 与 fearGreed.score、btcDominance 排序。
预警阈值同步
台桌机器人读取 priceAlerts 的 coinId、targetPrice、targetIsGreaterThan,在 isEnabled 为真时把这些区间镜像到内部寻呼。
常见问题
CoinMarketCap 排行与报价有哪些字段?
排行行携带 id、name、symbol、slug、cmcRank、circulatingSupply,以及嵌套 Quote 的 price、percentChange1h/24h/7d、volume24h、marketCap 与 dominance。币种页还有 Statistics 的 marketCapDominance、high24h、low24h、highAllTime 与 watchCount。
除了排行,能否读取自选和持仓?
可以。已登录自选返回 watchListId、name、cryptoSize 与 cryptoCurrencies。持仓行给出 cryptocurrencyId、balance、currentPrice、value 和 valueChange24h,汇总卡片还有 currentTotalHoldings、plValue、totalBuySpent 与 unrealizedProfit。
CoinMarketCap 移动端如何鉴权?
未登录浏览使用匿名访客 Bearer 令牌,已登录调用则把用户访问令牌作为 Bearer 发送;每次请求都附带客户端平台与应用版本头。用户资料随后返回 id、uid、email、username 和 displayFiatCurrencyId。
全球指标与预警有哪些字段?
全球指标包括 metric.volume24、metric.marketCap、fearGreed.score、dominance.btcDominance 与 ethDominance。价格预警列出 coinId、coinSymbol、targetPrice、targetIsGreaterThan、isEnabled 与 syncId。
与 CoinMarketCap: Crypto Tracker 相似的应用
- Investing.com: Stock Market — Investing.com 是 Fusion Media 的行情投研应用,覆盖股票、外汇、加密资产和大宗商品,带自选与纸上组合,不同于 CoinMarketCap 以加密原生排行为主的行情带。
- TradingView: Track All Markets — TradingView 是股票、加密资产、外汇和期货的图表与社交行情应用,以 Supercharts 布局为主,不同于 CoinMarketCap 的排行列表与持仓账本。
- Yahoo Finance — Yahoo Finance 是雅虎的行情应用,覆盖股票、ETF、加密资产和外汇的报价、自选、新闻与组合跟踪。
- Binance — Binance 是与 CoinMarketCap 同一集团的交易所应用,侧重下单与钱包,而非排行与投研屏幕。
- CoinGecko — CoinGecko 是加密行情跟踪器,提供币种排行页、自选与组合跟踪,是最接近 CoinMarketCap 排行带的同行。
- Robinhood — Robinhood 是美股、期权和加密资产经纪商,带资金下单,与 CoinMarketCap 的行情与持仓跟踪器不同。
相关主题
- CoinMarketCap API
- CoinMarketCap cmcRank 行情
- CoinMarketCap 自选 watchListId
- CoinMarketCap 持仓 plValue
- CoinMarketCap btcDominance
- CoinMarketCap fearGreed score
- CoinMarketCap 价格预警 targetPrice
- CoinMarketCap circulatingSupply
需要集成这个 App 的数据 API?
我们可为任意指定 App 交付定制集成——源码交付 USD 500 起,或托管 API 按调用计费。告诉我们您需要的数据即可。
- 每个项目均签 NDA 与 SOW
- 3–7 天交付
- 验收通过后才付款
- 仅在授权范围内作业