Gecko Terminal API

Query GeckoTerminal market data - networks, DEXes, pools, tokens, OHLCV, trades, and trending/new pools.

Security Scan

The skill is internally consistent: it runs a bundled Node CLI that only issues read-only HTTPS GETs to GeckoTerminal's public API, asks for no credentials, and does not request elevated persistence or autonomous invocation.

Purpose & Capability

Name/description match the provided code and instructions. The bundled script implements a read-only CLI that queries GeckoTerminal's API v2. Requiring the 'node' binary is appropriate.

Instruction Scope

SKILL.md instructs the agent to run the local CLI script and documents only read-only API calls. The CLI code enforces API path normalization, rejects absolute URLs and path traversal, and restricts outbound requests to the GeckoTerminal API origin. The skill does not instruct reading other files, secrets, wallets, or sending data to unrelated endpoints.

Install Mechanism

There is no external install/download step; the repository includes the CLI script and an instruction-only setup. Nothing is fetched from arbitrary URLs during install, so install risk is low.

Credentials

No required environment variables or credentials are declared. The script reads an optional GECKOTERMINAL_TIMEOUT_MS for request timeout, which is proportionate to network I/O.

Persistence & Privilege

always is false and disable-model-invocation is true (no autonomous invocation). The skill does not request or modify other skills' configs or system-wide settings.

Assessment

This skill appears to do what it says: run the included Node CLI to fetch public, read-only market data from GeckoTerminal. Before installing, ensure you have a trusted Node runtime; verify the skill source if you require provenance (owner ID is present but source is 'unknown'); and remember the script will make outbound HTTPS requests to https://api.geckoterminal.com only. No API keys or wallets are requested and the skill is not allowed to invoke autonomously. If you want extra assurance, inspect the full CLI file (it’s bundled) or run it in a network-restricted environment first.

GeckoTerminal

Query GeckoTerminal via the local CLI script.

Quick Start

# List networks
node {baseDir}/scripts/geckoterminal-cli.mjs get_networks

# Solana trending pools
node {baseDir}/scripts/geckoterminal-cli.mjs get_network_trending_pools --network solana --duration 1h --page 1

# Search pools
node {baseDir}/scripts/geckoterminal-cli.mjs search_pools --query "SOL USDC" --network solana --page 1

---

After Install - Suggested Setup

1. Daily discovery scan

Use in your daily brief:

gecko trending pools + new pools + top pools

2. Track a token across pools

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. Analyze a candidate pool

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

---

Commands

Networks and DEXes

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

Trending / New Pools

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

Pools and Search

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

Tokens

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

Raw API fallback

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

Optional Query Params

Common optional flags supported by the CLI:

# Include related resources where supported
--include "base_token,quote_token,dex"

# Include extra pool/token breakdowns where supported
--include-volume-breakdown true
--include-composition true

# Include inactive-source rows where supported
--include-inactive-source true

# Sort/page where supported
--sort "h24_volume_usd_desc"
--page 1

# Community data toggle (trending/new/top/dex pools endpoints)
--include-gt-community-data false

# Simple token price extras
--include-market-cap true
--mcap-fdv-fallback true
--include-24hr-vol true
--include-24hr-price-change true
--include-total-reserve-in-usd true

---

Output Features

Typical payloads include:

• Pool attributes (network, dex, addresses, links)
• Price, liquidity, volume, and transaction summaries
• Token metadata and linked pools
• OHLCV candles and recent trades

Default output is JSON for easy piping and automation.

---

API

Uses GeckoTerminal public API v2 (read-only):

• Base URL: https://api.geckoterminal.com/api/v2
• api_get --path accepts API-relative paths only (absolute URLs are blocked)

---

Security and Permissions

No API key required.

What this skill does:

• Makes HTTPS GET requests to GeckoTerminal API
• Reads public network/DEX/pool/token/market data

What this skill does not do:

• No wallet connections
• No transactions or trading
• No credential handling
• No autonomous invocation (disable-model-invocation: true)