# CoinGecko Solana API 开发指南有关为 Solana 集成 CoinGecko 链上 API 的综合指南。访问 1,700 多个去中心化交易所的实时代币价格、DEX 池数据、OHLCV 图表、交易历史和市场分析。 ## 概述 CoinGecko 的 Solana API 提供： * **代币价格** ：按合约地址（单个或批量）的实时价格 * **矿池数据** : 流动性矿池信息、趋势矿池、热门矿池 * **OHLCV 图表**：用于技术分析的烛台数据 * **交易历史**：任何池的最近交易 * **DEX Discovery** ：列出在 Solana 上运行的所有 DEX * **搜索** ：按代币名称、符号或地址查找矿池 * **Megafilter** ：跨池、代币和 DEX 的高级过滤 ### 主要特点特色|描述 ---|--- **250+ 网络** |多链支持，包括 Solana **1,700+ DEX** | Raydium、Orca、Jupiter、Meteora、Pump.fun 等 **15M+ 代币** |全面的代币覆盖 **实时数据** |每 10-30 秒更新一次 **历史数据** | OHLCV 图表和交易历史 ** ** ## 快速入门 ### 获取您的 API 密钥 1. **演示 API（免费）** ：访问 [coingecko.com/en/api]() 2. **Pro API（付费）**：访问 [coingecko.com/en/api/pricing]() ### 环境设置 # .env 文件 COINGECKO_API_KEY=your_api_key_here COINGECKO_API_TYPE=演示 # 或 'pro' ### API配置 // 演示版和专业版 API 的配置常量配置 = { 演示：{ baseUrl: 'https://api.coingecko.com/api/v3/onchain', headerKey: 'x-cg-demo-api-key', rateLimit: 30, // 每分钟调用次数 }, 亲：{ baseUrl: 'https://pro-api.coingecko.com/api/v3/onchain', headerKey: 'x-cg-pro-api-key', rateLimit: 500, // 每分钟调用次数（因计划而异） }, }; const apiType = process.env.COINGECKO_API_TYPE || '演示'； const apiKey = process.env.COINGECKO_API_KEY; const BASE_URL = CONFIG[apiType].baseUrl; const HEADER_KEY = CONFIG[apiType].headerKey; // Solana 网络标识符 const 网络 = 'solana'; ### 基本代币价格获取异步函数 getTokenPrice(tokenAddress: string): Promise { const url = `${BASE_URL}/simple/networks/${NETWORK}/token_price/${tokenAddress}`; const 响应 = 等待获取（url，{ 标题：{ [HEADER_KEY]：apiKey， '接受': '应用程序/json', }, }); 如果（！response.ok）{ 抛出新的错误（`API错误：$ {response.status}`）； } const data =等待response.json(); 返回 data.data?.attributes?.token_prices?.[tokenAddress] ??无效的; } // 用法 const USDC = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'; const 价格 = 等待 getTokenPrice(USDC); console.log(`USDC 价格：$${price}`); ** ** ## API 端点参考 ### 简单代币价格通过合约地址获取代币价格。 **端点**：`GET /simple/networks/{network}/token_price/{addresses}` **参数**：参数|类型 |必填|描述 ---|---|---|--- `网络` |字符串|是的 |网络 ID (`solana`) `地址` |字符串|是的 |以逗号分隔的代币地址（最多 30 个演示版，100 个专业版） `include_market_cap` |布尔 |没有 |包括市值数据 `include_24hr_vol` |布尔 |没有 |包括24小时体积 `include_24hr_price_change` |布尔 |没有 |包括 24 小时价格变化 % 异步函数 getTokenPrices(addresses: string[]): Promise> { const 地址列表 = 地址.join(','); const url = `${BASE_URL}/simple/networks/${NETWORK}/token_price/${addressList}`; const params = new URLSearchParams({ include_market_cap: 'true', include_24hr_vol: '真实', include_24hr_price_change: 'true', }); const 响应 = 等待 fetch(`${url}?${params}`, { 标头：{ [HEADER_KEY]：apiKey }， }); const data =等待response.json(); 返回 data.data?.attributes || {}； } ** ** ### 按地址划分的令牌数据获取详细的代币信息。 **端点**：`GET /networks/{network}/tokens/{address}` **参数**：参数|类型 |必填|描述 ---|---|---|--- `网络` |字符串|是的 |网络ID `地址` |字符串|是的 |代币合约地址 `包括` |字符串|没有 |包括流动性数据的“top_pools” 接口令牌数据{ 地址：字符串；名称：字符串；符号：字符串；小数：数字；图片网址：字符串； Price_usd：字符串； fdv_usd：字符串； market_cap_usd：字符串；总供应量：字符串；成交量_美元：{ h24：字符串； }; 价格变化百分比：{ h24：字符串； }; } 异步函数 getTokenData(地址: string): Promise { const url = `${BASE_URL}/networks/${NETWORK}/tokens/${address}?include=top_pools`; const 响应 = 等待获取（url，{ 标头：{ [HEADER_KEY]：apiKey }， }); const data =等待response.json(); 返回数据.数据？.属性； } ** ** ### 多令牌数据批量获取多个令牌。 **端点**：`GET /networks/{network}/tokens/multi/{addresses}` 异步函数 getMultipleTokens(addresses: string[]): Promise { const 地址列表 = 地址.join(','); const url = `${BASE_URL}/networks/${NETWORK}/tokens/multi/${addressList}`; const 响应 = 等待获取（url，{ 标头：{ [HEADER_KEY]：apiKey }， }); const data =等待response.json(); return data.data?.map((item: any) => item.attributes) || []； } ** ** ### 按地址池数据获取详细的池信息。 **端点**：`GET /networks/{network}/pools/{address}` **参数**：参数|类型 |必填 |描述 ---|---|---|--- `包括` |字符串|没有 | `base_token`、`quote_token`、`dex` `include_volume_breakdown` |布尔 |没有 |按时间范围划分的交易量细分接口池数据{ 地址：字符串；名称：字符串； pool_created_at：字符串； base_token_price_usd：字符串； quote_token_price_usd：字符串； base_token_price_native_currency：字符串； fdv_usd：字符串； market_cap_usd：字符串； Reserve_in_usd：字符串；价格变化百分比：{ m5：字符串； h1：字符串； h6：字符串； h24：字符串； }; 交易：{ m5: { 购买: 数量;销售：数量}； h1: { 购买: 数量;销售：数量}； h24: { 购买：数量；销售：数量}； }; 成交量_美元：{ m5：字符串； h1：字符串； h6：字符串； h24：字符串； }; } 异步函数 getPoolData(poolAddress: string): Promise { const url = `${BASE_URL}/networks/${NETWORK}/pools/${poolAddress}`; const params = new URLSearchParams({ 包括：'base_token，quote_token，dex'， }); const 响应 = 等待 fetch(`${url}?${params}`, { 标头：{ [HEADER_KEY]：apiKey }， }); const data =等待response.json(); 返回数据.数据？.属性； } ** ** ### 热门泳池获取所有网络的趋势池或按网络过滤。 **端点**：`GET /networks/trending_pools` **参数**：参数|类型 |默认 |描述 ---|---|---|--- `包括` |字符串| `base_token` |要包含的属性 `页面` |整数 | 1 |页码 `持续时间` |字符串| `24 小时` | `5m`、`1h`、`6h`、`24h` 异步函数 getTrendingPools(duration: '5m' | '1h' | '6h' | '24h' = '24h'): Promise { const url = `${BASE_URL}/networks/trending_pools`; const params = new URLSearchParams({ 包括：'base_token，quote_token，dex，网络'，持续时间，页：“1”， }); const 响应 = 等待 fetch(`${url}?${params}`, { 标头：{ [HEADER_KEY]：apiKey }， }); const data =等待response.json(); return data.data?.map((item: any) => item.attributes) || []； } // 过滤 Solana 池异步函数 getSolanaTrendingPools(): Promise { const allPools = 等待 getTrendingPools(); return allPools.filter(pool => pool.network === 'solana'); } ** ** ### 网络上的热门矿池按容量获取 Solana 上的顶级池。 **端点**：`GET /networks/{network}/pools` 异步函数 getTopPools(page: number = 1): Promise { const url = `${BASE_URL}/networks/${NETWORK}/pools`; const params = new URLSearchParams({ 包括：'base_token，quote_token，dex'，页面：page.toString(), }); const 响应 = 等待 fetch(`${url}?${params}`, { 标头：{ [HEADER_KEY]：apiKey }， }); const data =等待response.json(); return data.data?.map((item: any) => item.attributes) || []； } ** ** ### 搜索池按代币名称、符号或地址搜索矿池。 **端点**：`GET /搜索/池` **参数**：参数|类型 |描述 ---|---|--- `查询` |字符串|搜索词（名称、符号、地址） `网络` |字符串|按网络过滤 `页面` |整数 |页码异步函数 searchPools(query: string): Promise { const url = `${BASE_URL}/search/pools`; const params = new URLSearchParams({ 查询，网络：网络，包括：'base_token，quote_token，dex'， }); const 响应 = 等待 fetch(`${url}?${params}`, { 标头：{ [HEADER_KEY]：apiKey }， }); const data =等待response.json(); return data.data?.map((item: any) => item.attributes) || []； } // 搜索 SOL 池 const solPools = 等待 searchPools('SOL'); ** ** ### 矿池 OHLCV 图表获取烛台数据以进行技术分析。 **端点**：`GET /networks/{network}/pools/{pool_address}/ohlcv/{timeframe}` **时间范围**：“天”、“小时”、“分钟” **参数**：参数|类型 |描述 ---|---|--- `聚合` |整数 |蜡烛聚合（1、5、15 为分钟；1、4、12 为小时） `before_timestamp` |整数 |用于分页的 Unix 时间戳 `限制` |整数 |蜡烛数量（最多 1000 支） `货币` |字符串| “美元”或“代币” 接口 OHLCVData { 时间戳：数字；打开：数量；高：数量；低：数量；关闭：数字；体积：数量； } 异步函数 getPoolOHLCV( 池地址：字符串，时间范围：“天” | '小时' | '分钟' = '小时', 合计：数量 = 1，限制：数量 = 100 ): 承诺 { const url = `${BASE_URL}/networks/${NETWORK}/pools/${poolAddress}/ohlcv/${timeframe}`; const params = new URLSearchParams({ 聚合：aggregate.toString(), 限制：limit.toString(), 货币：'美元'， }); const 响应 = 等待 fetch(`${url}?${params}`, { 标头：{ [HEADER_KEY]：apiKey }， }); const data =等待response.json(); 返回 data.data?.attributes?.ohlcv_list?.map((蜡烛: number[]) => ({ 时间戳：蜡烛[0]，开盘：蜡烛[1]，高：蜡烛[2]，低：蜡烛[3]，关闭：蜡烛[4]，体积：蜡烛[5]， })) || []； } // 获取每小时蜡烛图 const hourlyCandles =等待 getPoolOHLCV(poolAddress, '小时', 1, 24); // 获取 5 分钟蜡烛 const FiveMinCandles = 等待 getPoolOHLCV(poolAddress, '分钟', 5, 100); ** ** ### 最近交易获取池的最近交易。 **端点**：`GET /networks/{network}/pools/{pool_address}/trades` 接口贸易数据{ 块号：数量；块时间戳：字符串； tx_hash：字符串； tx_from_address：字符串； from_token_amount：字符串； to_token_amount：字符串； Price_from_in_currency_token：字符串； Price_to_in_currency_token：字符串；美元价格：字符串；美元价格：字符串；种类：“购买”| '卖'; 美元成交量：字符串； } 异步函数 getRecentTrades(poolAddress: string): Promise { const url = `${BASE_URL}/networks/${NETWORK}/pools/${poolAddress}/trades`; const 响应 = 等待获取（url，{ 标头：{ [HEADER_KEY]：apiKey }， }); const data =等待response.json(); return data.data?.map((item: any) => item.attributes) || []； } ** ** ### 列出 Solana 上的 DEX 获取 Solana 上的所有去中心化交易所。 **端点**：`GET /networks/{network}/dexes` 接口 DexData { id：字符串；名称：字符串； } 异步函数 getSolanaDexes(): Promise { const url = `${BASE_URL}/networks/${NETWORK}/dexes`; const 响应 = 等待获取（url，{ 标头：{ [HEADER_KEY]：apiKey }， }); const data =等待response.json(); 返回 data.data?.map((item: 任意) => ({ id: 项目.id, 名称：项目.属性.名称， })) || []； } ** ** ### 巨型过滤器（高级）对跨网络、DEX 和代币的矿池进行高级过滤。 **端点**：`GET /pools/megafilter` **参数**：参数|类型 |描述 ---|---|--- `网络` |字符串|按网络过滤 `dexes` |字符串|按 DEX 过滤 `排序` |字符串|排序顺序（例如，`pool_created_at_desc`） `最低储备美元` |数量 |最低流动性 `min_h24_volume_usd` |数量 | 24小时最低交易量异步函数 getMegafilterPools(选项: { dexes？：字符串[]；最小流动性？：数字；最小音量？：数字；排序？：字符串； }): Promise { const url = `${BASE_URL}/pools/megafilter`; const params = new URLSearchParams({ 网络：网络，页：“1”， }); if (选项.dexes) { params.set('dexes', options.dexes.join(',')); } if (options.minLiquidity) { params.set('min_reserve_in_usd', options.minLiquidity.toString()); } if (options.minVolume) { params.set('min_h24_volume_usd', options.minVolume.toString()); } if (选项.排序) { params.set('排序', options.sort); } const 响应 = 等待 fetch(`${url}?${params}`, { 标头：{ [HEADER_KEY]：apiKey }， }); const data =等待response.json(); return data.data?.map((item: any) => item.attributes) || []； } // 获取最新的 Pump.fun 池 const PumpfunPools = 等待 getMegafilterPools({ dexes: ['pump-fun'], 排序：'pool_created_at_desc', }); // 获取大容量 Raydium 池 const raydiumPools = 等待 getMegafilterPools({ dexes: ['raydium'], 最小数量：100000，最低流动性：50000， }); ** ** ## 常见 Solana DEX 标识符去中心化交易所 |身份证 |描述 ---|---|--- 镭 | `镭` | Solana 上领先的 AMM 逆戟鲸 | `逆戟鲸` |用户友好的 DEX 木星| `木星` |带池的聚合器迈泰奥拉 | `迈泰奥拉` |动态AMM 泵乐 | `泵的乐趣` | Memecoin 启动板开卷 | `打开书本` |订单簿 DEX 生命力 | `生命力` |主动做市商凤凰城 |凤凰链上订单簿 ** ** ## 通用代币地址代币|地址 ---|--- 美元兑美元 | `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v` 泰达币 | `Es9vMFrzaCERmJfrF4H2FYD4KCoNky11McCe8BenwNYB` SOL（包裹）| `所以11111111111111111111111111111111111111112` 杰普 | `JUPyiwrYJFskUPiHa7hkeR8VUTAeFoSYbKedZNSDvCN` 邦克 | `DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263` 无线网络| `EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm` Python | `HZ1JovNiVvGrGNiiYvEozEVgZ58xaU3RKwX8eACQBCt3` 雷 | `4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R` 逆戟鲸 | `orcaEKTdK7LKz57vaAYr9QeNsVEPfiu6QeMU1kektZE` ** ** ## 速率限制计划|通话/分钟 |最大地址/请求 ---|---|--- 演示（免费）| 30| 30 分析师| 500 | 500 50 精简版 | 500 | 500 50 专业| 1,000 | 100 企业 |定制|定制 ### 速率限制处理类速率限制器 { 私人通话：号码[] = []；私有 maxCalls：数量；私人窗口Ms：数量= 60000； // 1 分钟构造函数（maxCallsPerMinute：数量）{ this.maxCalls = maxCallsPerMinute; } 异步 waitForSlot(): Promise { const now = Date.now(); this.calls = this.calls.filter(t => now - t < this.windowMs); if (this.calls.length >= this.maxCalls) { constoldestCall = this.calls[0]; const waitTime = this.windowMs - (现在 -oldestCall); 等待新的 Promise(resolve => setTimeout(resolve, waitTime)); } this.calls.push(Date.now()); } } // 用法 const 速率限制器 = 新速率限制器(30); // 演示 API 异步函数 fetchWithRateLimit(url: string): Promise { 等待rateLimiter.waitForSlot(); const 响应 = 等待获取（url，{ 标头：{ [HEADER_KEY]：apiKey }， }); 返回response.json(); } ** ** ## 错误处理异步函数 safeApiCall(url: string): Promise { 尝试{ const 响应 = 等待获取（url，{ 标头：{ [HEADER_KEY]：apiKey }， }); if (response.status === 401) { throw new Error('无效的 API 密钥'); } if (response.status === 429) { throw new Error('超出速率限制 - 重试前等待'); } if (response.status === 404) { console.warn('找不到资源'); 返回空值； } 如果（！response.ok）{ 抛出新的错误（`API错误：$ {response.status}`）； } 返回response.json(); } 捕获（错误）{ console.error('CoinGecko API 错误：', error); 抛出错误； } } ### 常见错误代码代码|意义|解决方案 ---|---|--- 401 | 401无效的 API 密钥 |检查您的 API 密钥 429 | 429超出速率限制 |等待并重试，或升级计划 404 | 404找不到资源 |检查地址/网络 ID 500+ |服务器错误 |使用指数退避重试 ** ** ## 最佳实践 ### 安全 * 切勿将 API 密钥提交到 git * 使用环境变量 * 定期轮换密钥 * 开发/生产使用单独的密钥 ### 性能 * 尽可能批量处理令牌请求 * 缓存经常访问的数据 * 对 OHLCV 使用适当的时间范围 * 实施请求排队以进行速率限制 ### 数据质量 * 验证市值数据（如果未经验证可能为空） * 在信任价格之前检查矿池流动性 * 使用多个时间范围进行价格分析 * 监控最后交易时间戳的活动 ** ** ## 资源 * [CoinGecko API 文档]() * [GeckoTerminal]() * [CoinGecko API 定价]() * [API 变更日志]() ** ** ## 技能结构科因杰科/ ├── SKILL.md # 这个文件 ├── 资源/ │ ├── api-reference.md # 完整的API端点参考 │ ├── network-dex-ids.md # Solana 网络和 DEX 标识符 │ └── token-addresses.md # 常用 Solana 代币地址 ├── 例子/ │ ├── 代币价格/ │ │ └── get-token-price.ts # 代币价格示例 │ ├── 泳池/ │ │ └── pool-data.ts # 池数据示例 │ ├── ohlcv/ │ │ └── ohlcv-charts.ts # OHLCV 图表示例 │ ├── 交易/ │ │ └──centre-trades.ts # 交易历史示例 │ └── 整合/ │ └── full-client.ts # 完整的客户端示例 ├── 模板/ │ └── coingecko-client.ts # 生产就绪的客户端模板 └── 文档/ └── Troubleshooting.md # 常见问题及解决方案

科因杰科

包含技能