← Back to Skills Marketplace
brs999

Gecko Terminal API

by Ben · GitHub ↗ · v1.0.1
cross-platform ✓ Security Clean
527
Downloads
1
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install gecko-terminal
Description
Query GeckoTerminal market data - networks, DEXes, pools, tokens, OHLCV, trades, and trending/new pools.
README (SKILL.md)

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 "\x3Ctoken_address>" --page 1
node {baseDir}/scripts/geckoterminal-cli.mjs get_simple_token_prices --network solana --token-addresses "\x3Ctoken1>,\x3Ctoken2>"

3. Analyze a candidate pool

node {baseDir}/scripts/geckoterminal-cli.mjs get_pool_info --network solana --pool "\x3Cpool_address>"
node {baseDir}/scripts/geckoterminal-cli.mjs get_pool_trades --network solana --pool "\x3Cpool_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 "\x3Cpool_address>"
node {baseDir}/scripts/geckoterminal-cli.mjs get_multi_pools --network solana --pool-addresses "\x3Cpool1>,\x3Cpool2>"
node {baseDir}/scripts/geckoterminal-cli.mjs get_pool_info --network solana --pool "\x3Cpool_address>"
node {baseDir}/scripts/geckoterminal-cli.mjs get_pool_trades --network solana --pool "\x3Cpool_address>" --page 1

Tokens

node {baseDir}/scripts/geckoterminal-cli.mjs get_token --network solana --token "\x3Ctoken_address>"
node {baseDir}/scripts/geckoterminal-cli.mjs get_multi_tokens --network solana --token-addresses "\x3Ctoken1>,\x3Ctoken2>"
node {baseDir}/scripts/geckoterminal-cli.mjs get_token_info --network solana --token "\x3Ctoken_address>"
node {baseDir}/scripts/geckoterminal-cli.mjs get_token_pools --network solana --token "\x3Ctoken_address>" --page 1
node {baseDir}/scripts/geckoterminal-cli.mjs get_simple_token_prices --network solana --token-addresses "\x3Ctoken1>,\x3Ctoken2>"
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 "\x3Cpool_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)
Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill Name: gecko-terminal Version: 1.0.1 This skill is benign. It is a read-only client for the public GeckoTerminal API, making HTTPS GET requests to a single, hardcoded domain (`https://api.geckoterminal.com`). The `scripts/geckoterminal-cli.mjs` script implements robust security controls, including strict URL validation to prevent SSRF, path traversal, and arbitrary URL fetching. User inputs for path segments are properly `encodeURIComponent`-ed, and query parameters are handled safely. The `SKILL.md` documentation clearly outlines the skill's purpose and limitations, explicitly stating no credential handling, wallet connections, or transactions, and disabling autonomous model invocation. There is no evidence of malicious intent, data exfiltration, or prompt injection attempts.
Capability Assessment
✓ 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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install gecko-terminal
  3. After installation, invoke the skill by name or use /gecko-terminal
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Clarified in the API section that `api_get --path` only allows API-relative paths (absolute URLs are blocked) for improved security documentation. - No functional or command changes; documentation update only.
v1.0.0
- Initial release of the GeckoTerminal skill. - Query live market data from GeckoTerminal including networks, DEXes, pools, tokens, OHLCV, trades, and trending/new pools. - Provides a comprehensive CLI interface for discovering pools, analyzing tokens, and fetching price and liquidity data. - Outputs results in JSON format for easy automation. - No API key required; reads only public market data. - Does not support transactions, wallet access, or autonomous invocation.
Metadata
Slug gecko-terminal
Version 1.0.1
License —
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Gecko Terminal API?

Query GeckoTerminal market data - networks, DEXes, pools, tokens, OHLCV, trades, and trending/new pools. It is an AI Agent Skill for Claude Code / OpenClaw, with 527 downloads so far.

How do I install Gecko Terminal API?

Run "/install gecko-terminal" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Gecko Terminal API free?

Yes, Gecko Terminal API is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Gecko Terminal API support?

Gecko Terminal API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Gecko Terminal API?

It is built and maintained by Ben (@brs999); the current version is v1.0.1.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463815 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259802 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200680 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191345 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190333 · by oswalpalash

💬 Comments