oyi77 Overview
gate-info-coinanalysis runs a single-asset deep-dive playbook using only general public APIs — no exchange-specific CLI required. It pulls market data (CoinGecko), supply/structure (CoinGecko + on-chain explorers), and synthesizes a structured thesis. This is the standalone, tool-agnostic rewrite of the upstream gate-info-coinanalysis skill.
When to Use
- "Research BTC" / "analyze ETH" / "look into SOL"
- "Give me a deep dive on [coin]"
- "What's the supply and on-chain picture for [coin]"
- "Is [coin] worth a thesis writeup"
When NOT to Use
- You want to execute a trade — use
gate-exchange-trading(separate skill). - You want to compare several coins — use
gate-info-coincompare. - You only need a live price quote — a single CoinGecko call is enough; do not invoke the full playbook.
- The asset is a DeFi protocol (TVL/yields) — use
gate-info-defianalysis.
Workflow
Step 1 — Resolve the coin id
# Find the CoinGecko id (slug) for a ticker/symbol
curl -s "https://api.coingecko.com/api/v3/search?query=ethereum" \
| jq '.coins[0] | {id, symbol, name}'
# → {"id":"ethereum","symbol":"eth","name":"Ethereum"}
Step 2 — Pull market + supply data
curl -s "https://api.coingecko.com/api/v3/coins/ethereum?localization=false&tickers=false&community_data=false&developer_data=false" \
| jq '{price: .market_data.current_price.usd,
change_24h: .market_data.price_change_percentage_24h,
mcap: .market_data.market_cap.usd,
rank: .market_cap_rank,
circ_supply: .market_data.circulating_supply,
total_supply: .market_data.total_supply,
ath: .market_data.ath.usd,
ath_date: .market_data.ath_date.usd}'
Step 3 — Pull on-chain signals (ERC-20 / EVM tokens)
# Requires a free Etherscan API key (ETHERSCAN_KEY)
curl -s "https://api.etherscan.io/api?module=stats&action=tokenSupply&contractaddress=0xdac17f958d2ee523a2206206994597c13d831ec7&apikey=$ETHERSCAN_KEY" \
| jq '.result'
Step 4 — Synthesize
## Research: [coin] (playbook: single_coin)
### Snapshot
- Price / 24h change / market cap / rank
- Circulating vs total supply, inflation or hard-cap notes
- Key on-chain or supply signals
### Narrative
- 2–4 sentences tying the data to a thesis
### Risks
- What would invalidate the thesis
### Sources
- CoinGecko /coins/{id}, Etherscan tokenSupply (if applicable)
Anti-Rationalization Table
| Rationalization | Reality |
|---|---|
| "No exchange CLI, so research is incomplete" | Public APIs (CoinGecko, DeFiLlama, Etherscan) cover market + on-chain fully. The exchange CLI is optional glue, not the data source. |
| "Missing data = low quality coin" | Absent fields are gaps to flag, not a verdict. Report what's missing. |
| "One price call is enough for a deep dive" | single_coin aggregates market, supply, and on-chain signals; a bare quote is not a research playbook. |
| "I'll pipe the install script to bash to get it working" | Out-of-repo install scripts are a supply-chain risk. Use documented public API endpoints directly. |
Code Example
Run a single-coin research pull and capture structured output:
curl -s "https://api.coingecko.com/api/v3/coins/bitcoin?localization=false&tickers=false&community_data=false&developer_data=false" \
| jq '{price: .market_data.current_price.usd, change_24h: .market_data.price_change_percentage_24h, mcap: .market_data.market_cap.usd, rank: .market_cap_rank}'
# → {"price":64000,"change_24h":-1.2,"mcap":1.26e12,"rank":1}
Verification
- Coin id resolved to exactly one
coins/{id}from the search endpoint. - Market + supply data collected (price, change, mcap, rank, supply).
- If EVM token, on-chain supply/holder signal cited with source.
- Output follows the Synthesis template (Snapshot / Narrative / Risks / Sources).
- Gaps (missing fields) explicitly flagged rather than silently omitted.