该技能是面向 AI 智能体的 CoinMarketCap 市场级 API 参考,用于获取全市场范围的加密货币数据。所有请求的基础地址为 https://pro-api.coinmarketcap.com,并需在请求头中包含 X-CMC_PRO_API_KEY。
用途上,它覆盖几类数据:全局指标(总市值、BTC 占比)、市场情绪(恐惧与贪婪指数)、市场指数(CMC100 与 CMC20 的最新值及历史)、社区动态(社区热门代币与热门话题)、内容(最新新闻与 Alexandria 文章、社区帖子和评论)、K 线图表(OHLCV 蜡烛图与价格/市值时间序列点),以及工具类端点(法币映射、API 密钥用量与套餐信息、货币换算)。
主要能力通过端点体现,例如:GET /v1/global-metrics/quotes/latest 与 /historical 获取全局指标;GET /v3/fear-and-greed/latest 与 /historical 获取情绪分数与历史;GET /v3/index/cmc100-latest、cmc100-historical、cmc20-latest、cmc20-historical 获取指数数据;GET /v1/community/trending/token 与 /topic 获取社区趋势;GET /v1/content/latest、/posts/comments、/posts/latest、/posts/top 获取内容;GET /v1/k-line/candles 与 /points 获取图表数据;GET /v1/fiat/map、/v1/key/info、/v2/tools/price-conversion 完成工具类操作。响应为 JSON,包含 status(timestamp、error_code、error_message、credit_count)与 data 字段。
使用方式上,建议先通过 /v1/key/info 查看套餐与用量限制;全局指标可适度缓存;恐惧与贪婪指数每日更新,无需频繁轮询;K 线支持多区间参数以适配不同图表周期。错误处理方面,400 检查参数,401 校验密钥,403 表示套餐不支持,429 需退避重试,500 可延迟重试。可通过响应头 X-CMC_PRO_API_KEY_CREDITS_USED、X-CMC_PRO_API_KEY_CREDITS_REMAINING、X-CMC_PRO_API_KEY_RATE_LIMIT 监控用量。
限制方面,资料未提供具体收费价格、各端点配额上限与返回字段细节,需以实际 API 文档和账户套餐为准;本技能仅作为参考指引,不包含执行环境或本地缓存实现。