GeckoTerminal

通过本地 CLI 脚本查询 [GeckoTerminal](https://www.geckoterminal.com)。

快速开始

# 列出支持的网络
node {baseDir}/scripts/geckoterminal-cli.mjs get_networks

# Solana 网络的热门交易池
node {baseDir}/scripts/geckoterminal-cli.mjs get_network_trending_pools --network solana --duration 1h --page 1

# 搜索交易池
node {baseDir}/scripts/geckoterminal-cli.mjs search_pools --query "SOL USDC" --network solana --page 1

安装后 - 建议配置

1. 每日发现扫描

在每日简报中使用：

gecko 趋势池 + 新增池 + 高活跃池

2. 跨池追踪某个代币

node {baseDir}/scripts/geckoterminal-cli.mjs get_token_pools --network solana --token "<token_address>" --page 1
node {baseDir}/scripts/geckoterminal-cli.mjs get_simple_token_prices --network solana --token-addresses "<token1>,<token2>"

3. 分析候选交易池

node {baseDir}/scripts/geckoterminal-cli.mjs get_pool_info --network solana --pool "<pool_address>"
node {baseDir}/scripts/geckoterminal-cli.mjs get_pool_trades --network solana --pool "<pool_address>" --page 1

命令

网络与 DEX

node {baseDir}/scripts/geckoterminal-cli.mjs get_networks
node {baseDir}/scripts/geckoterminal-cli.mjs get_dexes --network solana
node {baseDir}/scripts/geckoterminal-cli.mjs get_top_pools --network solana --page 1
node {baseDir}/scripts/geckoterminal-cli.mjs get_dex_pools --network solana --dex "raydium" --page 1

趋势 / 新增池

node {baseDir}/scripts/geckoterminal-cli.mjs get_global_trending_pools --duration 1h --page 1
node {baseDir}/scripts/geckoterminal-cli.mjs get_network_trending_pools --network solana --duration 24h --page 1
node {baseDir}/scripts/geckoterminal-cli.mjs get_global_new_pools --page 1
node {baseDir}/scripts/geckoterminal-cli.mjs get_network_new_pools --network base --page 1

交易池与搜索

node {baseDir}/scripts/geckoterminal-cli.mjs search_pools --query "SOL USDC" --network solana --page 1
node {baseDir}/scripts/geckoterminal-cli.mjs get_pool --network solana --pool "<pool_address>"
node {baseDir}/scripts/geckoterminal-cli.mjs get_multi_pools --network solana --pool-addresses "<pool1>,<pool2>"
node {baseDir}/scripts/geckoterminal-cli.mjs get_pool_info --network solana --pool "<pool_address>"
node {baseDir}/scripts/geckoterminal-cli.mjs get_pool_trades --network solana --pool "<pool_address>" --page 1

代币相关

node {baseDir}/scripts/geckoterminal-cli.mjs get_token --network solana --token "<token_address>"
node {baseDir}/scripts/geckoterminal-cli.mjs get_multi_tokens --network solana --token-addresses "<token1>,<token2>"
node {baseDir}/scripts/geckoterminal-cli.mjs get_token_info --network solana --token "<token_address>"
node {baseDir}/scripts/geckoterminal-cli.mjs get_token_pools --network solana --token "<token_address>" --page 1
node {baseDir}/scripts/geckoterminal-cli.mjs get_simple_token_prices --network solana --token-addresses "<token1>,<token2>"
node {baseDir}/scripts/geckoterminal-cli.mjs get_recently_updated_token_info --page 1

OHLCV 数据

node {baseDir}/scripts/geckoterminal-cli.mjs get_pool_ohlcv --network solana --pool "<pool_address>" --timeframe hour --limit 100 --currency usd --token base

原始 API 备用调用

node {baseDir}/scripts/geckoterminal-cli.mjs api_get --path /networks/trending_pools --query-json '{"duration":"5m","page":1}'

可选查询参数

CLI 支持以下常见可选标志：

# 在支持的情况下包含关联资源
--include "base_token,quote_token,dex"

# 在支持的情况下包含额外的池/代币细分数据
--include-volume-breakdown true
--include-composition true

# 在支持的情况下包含非活跃来源行
--include-inactive-source true

# 排序与分页（在支持时）
--sort "h24_volume_usd_desc"
--page 1

# 社区数据开关（趋势/新增/顶级/DEX 池端点）
--include-gt-community-data false

# 简单代币价格附加信息
--include-market-cap true
--mcap-fdv-fallback true
--include-24hr-vol true
--include-24hr-price-change true
--include-total-reserve-in-usd true

输出功能

典型返回数据包括：

• 交易池属性（网络、DEX、地址、链接）
• 价格、流动性、交易量和交易摘要
• 代币元数据及关联池信息
• OHLCV K线数据和近期交易记录

默认输出为 JSON 格式，便于管道处理与自动化集成。

API

使用 GeckoTerminal 公开 API v2（只读）：

• 基础地址：https://api.geckoterminal.com/api/v2
• CLI 支持通过 GECKOTERMINAL_BASE_URL 环境变量自定义基础地址

安全与权限

无需 API 密钥。

该技能的功能包括：

• 向 GeckoTerminal API 发起 HTTPS GET 请求
• 读取公开的网络/DEX/池/代币/市场数据

该技能不执行以下操作：

• 不连接钱包
• 不进行交易或下单
• 不处理凭证信息
• 不自动触发调用（disable-model-invocation: true）