CoinGecko And GeckoTerminal Skill
Use this skill to run CoinGecko market data and GeckoTerminal onchain DEX operations through uxc + OpenAPI.
Reuse the uxc skill for shared execution, auth, and error-handling guidance.
Prerequisites
- -
uxc is installed and available in PATH. - Network access to
https://api.coingecko.com/api/v3. - Access to the curated OpenAPI schema URL:
-
https://raw.githubusercontent.com/holon-run/uxc/main/skills/coingecko-openapi-skill/references/coingecko-market.openapi.json
- - A CoinGecko Demo API key.
Scope
This skill covers a read-first market data surface:
- - API liveness checks
- spot price lookup
- asset ID discovery
- market screener reads
- trending reads
- GeckoTerminal network discovery
- onchain token price lookup
- trending pool reads
This skill does not cover:
- - paid or enterprise-only method families beyond the selected v1 scope
- historical chart or OHLC families
- portfolio, NFT, or onchain trade execution
- the full CoinGecko or GeckoTerminal API
Authentication
The default host uses CoinGecko Demo auth with x-cg-demo-api-key.
Configure one API-key credential and bind it to api.coingecko.com/api/v3:
CODEBLOCK0
Validate the active mapping when auth looks wrong:
CODEBLOCK1
Pro Host Override
If you have a Pro plan, keep the same curated schema and create a separate credential, binding, and link:
CODEBLOCK2
Core Workflow
- 1. Use the fixed link command by default:
-
command -v coingecko-openapi-cli
- If missing, create it:
uxc link coingecko-openapi-cli https://api.coingecko.com/api/v3 --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/coingecko-openapi-skill/references/coingecko-market.openapi.json
- INLINECODE10
- 2. Inspect operation schema first:
-
coingecko-openapi-cli get:/simple/price -h
-
coingecko-openapi-cli get:/coins/markets -h
- INLINECODE13
- 3. Prefer narrow read validation before broader reads:
-
coingecko-openapi-cli get:/ping
-
coingecko-openapi-cli get:/coins/list include_platform=false
- INLINECODE16
- 4. Execute with key/value parameters:
-
coingecko-openapi-cli get:/simple/price ids=bitcoin,ethereum vs_currencies=usd
-
coingecko-openapi-cli get:/coins/markets vs_currency=usd ids=bitcoin,ethereum order=market_cap_desc per_page=10 page=1
- INLINECODE19
Operation Groups
Market Data
- - INLINECODE20
- INLINECODE21
- INLINECODE22
- INLINECODE23
- INLINECODE24
GeckoTerminal Onchain Data
- - INLINECODE25
- INLINECODE26
- INLINECODE27
Guardrails
- - Keep automation on the JSON output envelope; do not use
--text. - Parse stable fields first:
ok, kind, protocol, data, error. - Treat this v1 skill as read-only. Do not imply wallet, trading, or portfolio mutation support.
- Demo and Pro hosts use different API-key headers. If the default Demo credential fails against the Pro host, create a separate Pro credential rather than reusing the Demo header name.
- The Pro host needs its own auth binding on
pro-api.coingecko.com/api/v3; creating only a credential is not enough for linked calls to send x-cg-pro-api-key. - CoinGecko public and Demo limits are tighter than Pro. Keep default examples narrow and avoid large paginated loops without explicit user intent.
- The GeckoTerminal endpoints in this schema share the same API root and auth flow as the rest of the curated CoinGecko host contract.
- INLINECODE36 is equivalent to
uxc https://api.coingecko.com/api/v3 --schema-url <coingecko_openapi_schema> <operation> ....
References
- - Usage patterns: INLINECODE38
- Curated OpenAPI schema: INLINECODE39
- CoinGecko API docs: https://docs.coingecko.com/reference/endpoint-overview
- Authentication docs: https://docs.coingecko.com/reference/authentication
CoinGecko 和 GeckoTerminal 技能
使用此技能通过 uxc + OpenAPI 运行 CoinGecko 市场数据和 GeckoTerminal 链上 DEX 操作。
复用 uxc 技能以获取共享执行、认证和错误处理指南。
前提条件
- - uxc 已安装并可在 PATH 中使用。
- 可访问 https://api.coingecko.com/api/v3 网络。
- 可访问精选的 OpenAPI 模式 URL：
- https://raw.githubusercontent.com/holon-run/uxc/main/skills/coingecko-openapi-skill/references/coingecko-market.openapi.json
- - 一个 CoinGecko 演示版 API 密钥。
范围
此技能涵盖以读取为主的市场数据面：
- - API 活跃性检查
- 现货价格查询
- 资产 ID 发现
- 市场筛选器读取
- 趋势读取
- GeckoTerminal 网络发现
- 链上代币价格查询
- 趋势池读取
此技能不涵盖：
- - 选定 v1 范围之外的付费或企业专属方法系列
- 历史图表或 OHLC 系列
- 投资组合、NFT 或链上交易执行
- 完整的 CoinGecko 或 GeckoTerminal API
认证
默认主机使用带有 x-cg-demo-api-key 的 CoinGecko 演示版认证。
配置一个 API 密钥凭证并将其绑定到 api.coingecko.com/api/v3：
bash
uxc auth credential set coingecko-demo \
--auth-type api_key \
--api-key-header x-cg-demo-api-key \
--secret-env COINGECKODEMOAPI_KEY
uxc auth binding add \
--id coingecko-demo \
--host api.coingecko.com \
--path-prefix /api/v3 \
--scheme https \
--credential coingecko-demo \
--priority 100
当认证出现问题时，验证活动映射：
bash
uxc auth binding match https://api.coingecko.com/api/v3
专业版主机覆盖
如果您拥有专业版计划，请保留相同的精选模式，并创建单独的凭证、绑定和链接：
bash
uxc auth credential set coingecko-pro \
--auth-type api_key \
--api-key-header x-cg-pro-api-key \
--secret-env COINGECKOPROAPI_KEY
uxc auth binding add \
--id coingecko-pro \
--host pro-api.coingecko.com \
--path-prefix /api/v3 \
--scheme https \
--credential coingecko-pro \
--priority 100
uxc link coingecko-pro-openapi-cli https://pro-api.coingecko.com/api/v3 \
--schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/coingecko-openapi-skill/references/coingecko-market.openapi.json
核心工作流程
- 1. 默认使用固定链接命令：
- command -v coingecko-openapi-cli
- 如果缺失，则创建：
uxc link coingecko-openapi-cli https://api.coingecko.com/api/v3 --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/coingecko-openapi-skill/references/coingecko-market.openapi.json
- coingecko-openapi-cli -h
- 2. 首先检查操作模式：
- coingecko-openapi-cli get:/simple/price -h
- coingecko-openapi-cli get:/coins/markets -h
- coingecko-openapi-cli get:/onchain/simple/networks/{network}/token_price/{addresses} -h
- 3. 在进行更广泛的读取之前，优先进行窄范围读取验证：
- coingecko-openapi-cli get:/ping
- coingecko-openapi-cli get:/coins/list include_platform=false
- coingecko-openapi-cli get:/onchain/networks
- 4. 使用键/值参数执行：
- coingecko-openapi-cli get:/simple/price ids=bitcoin,ethereum vs_currencies=usd
- coingecko-openapi-cli get:/coins/markets vs
currency=usd ids=bitcoin,ethereum order=marketcap
desc perpage=10 page=1
- coingecko-openapi-cli get:/onchain/simple/networks/{network}/token_price/{addresses} network=eth addresses=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
操作组
市场数据
- - get:/ping
- get:/simple/price
- get:/coins/list
- get:/coins/markets
- get:/search/trending
GeckoTerminal 链上数据
- - get:/onchain/networks
- get:/onchain/simple/networks/{network}/tokenprice/{addresses}
- get:/onchain/networks/trendingpools
防护措施
- - 保持自动化在 JSON 输出信封上；不要使用 --text。
- 首先解析稳定字段：ok、kind、protocol、data、error。
- 将此 v1 技能视为只读。不要暗示支持钱包、交易或投资组合变更。
- 演示版和专业版主机使用不同的 API 密钥标头。如果默认的演示版凭证在专业版主机上失败，请创建单独的专业版凭证，而不是重复使用演示版标头名称。
- 专业版主机需要在 pro-api.coingecko.com/api/v3 上拥有自己的认证绑定；仅创建凭证不足以让链接调用发送 x-cg-pro-api-key。
- CoinGecko 公共版和演示版的限制比专业版更严格。保持默认示例范围狭窄，避免在没有明确用户意图的情况下进行大型分页循环。
- 此模式中的 GeckoTerminal 端点与精选的 CoinGecko 主机合约的其余部分共享相同的 API 根和认证流程。
- coingecko-openapi-cli <操作> ... 等同于 uxc https://api.coingecko.com/api/v3 --schema-url openapischema> <操作> ...。
参考
- - 使用模式：references/usage-patterns.md
- 精选的 OpenAPI 模式：references/coingecko-market.openapi.json
- CoinGecko API 文档：https://docs.coingecko.com/reference/endpoint-overview
- 认证文档：https://docs.coingecko.com/reference/authentication
