# Send Gecko Terminal API to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "gecko-terminal",
    "name": "Gecko Terminal API",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/BRS999/gecko-terminal",
    "canonicalUrl": "https://clawhub.ai/BRS999/gecko-terminal",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/gecko-terminal",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=gecko-terminal",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/geckoterminal-cli.mjs"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/gecko-terminal"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/gecko-terminal",
    "downloadUrl": "https://openagent3.xyz/downloads/gecko-terminal",
    "agentUrl": "https://openagent3.xyz/skills/gecko-terminal/agent",
    "manifestUrl": "https://openagent3.xyz/skills/gecko-terminal/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/gecko-terminal/agent.md"
  }
}
```
## Documentation

### 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

### 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

### 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)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: BRS999
- Version: 1.0.1
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/gecko-terminal)
- [Send to Agent page](https://openagent3.xyz/skills/gecko-terminal/agent)
- [JSON manifest](https://openagent3.xyz/skills/gecko-terminal/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/gecko-terminal/agent.md)
- [Download page](https://openagent3.xyz/downloads/gecko-terminal)