用途:本指南介绍如何集成 CoinGecko 的 Solana 链上 API,获取实时代币价格、DEX 池数据、OHLCV K 线、交易历史与市场分析,覆盖 1700+ 去中心化交易所,可用于构建交易机器人、投资组合等应用。
主要能力:代币价格(按合约地址单个或批量查询)、池数据(流动性池信息、热门池、头部池)、OHLCV K 线(技术分析用蜡烛图)、交易历史(任意池的近期成交)、DEX 发现(列出 Solana 上所有 DEX)、搜索(按名称、符号或地址查找池)、Megafilter(跨池、代币与 DEX 的高级筛选)。数据每 10-30 秒更新,支持 250+ 网络、1500 万+ 代币。
使用方式:先获取 API Key,Demo 免费版访问 coingecko.com/en/api,Pro 付费版访问 coingecko.com/en/api/pricing。在 .env 中配置 COINGECKO_API_KEY 与 COINGECKO_API_TYPE(demo 或 pro)。Demo 基础地址为 https://api.coingecko.com/api/v3/onchain,请求头 x-cg-demo-api-key,限速 30 次/分钟;Pro 基础地址为 https://pro-api.coingecko.com/api/v3/onchain,请求头 x-cg-pro-api-key,限速 500 次/分钟(随套餐变化)。Solana 网络标识为 solana。主要端点包括:GET /simple/networks/{network}/token_price/{addresses}(批量地址 Demo 最多 30 个、Pro 最多 100 个)、GET /networks/{network}/tokens/{address}、GET /networks/{network}/tokens/multi/{addresses}、GET /networks/{network}/pools/{address}、GET /networks/trending_pools、GET /networks/{network}/pools、GET /search/pools、GET /networks/{network}/pools/{pool_address}/ohlcv/{timeframe}(timeframe 为 day、hour、minute,limit 最大 1000)、GET /networks/{network}/pools/{pool_address}/trades、GET /networks/{network}/dexes、GET /pools/megafilter。
适用场景:交易机器人、投资组合追踪、行情看板、DEX 池筛选与代币研究。
限制:需 API Key,Demo 与 Pro 限速及批量地址上限不同;常见错误码 401(密钥无效)、429(超限)、404(资源不存在)、500+(服务端错误,建议指数退避重试)。市场数据可能为 null(未验证),使用价格前应检查池流动性。密钥不应提交到 git,建议使用环境变量并定期轮换。