wehub-resource-sync
9b395f5cc3
E2E Headed Chrome / e2e-headed (macos-15) (push) Has been cancelled
E2E Headed Chrome / e2e-headed (ubuntu-latest) (push) Has been cancelled
E2E Headed Chrome / e2e-headed (windows-latest) (push) Has been cancelled
CI / build (macos-latest) (push) Has been cancelled
CI / build (ubuntu-latest) (push) Has been cancelled
CI / build (windows-latest) (push) Has been cancelled
CI / unit-test (push) Has been cancelled
CI / bun-test (push) Has been cancelled
CI / adapter-test (push) Has been cancelled
CI / smoke-test (macos-latest) (push) Has been cancelled
CI / smoke-test (ubuntu-latest) (push) Has been cancelled
Security Audit / audit (push) Has been cancelled
Build Chrome Extension / build (push) Has been cancelled
Trigger Website Rebuild (Docs Updated) / dispatch (push) Has been cancelled
127 lines
4.7 KiB
Markdown
127 lines
4.7 KiB
Markdown
# CoinGecko
|
||
|
||
Access **CoinGecko** crypto market data from the terminal via the public API (no authentication required).
|
||
|
||
**Mode**: 🌐 Public · **Domain**: `api.coingecko.com`
|
||
|
||
## Commands
|
||
|
||
| Command | Description |
|
||
|---------|-------------|
|
||
| `opencli coingecko top` | Top coins by market cap |
|
||
| `opencli coingecko coin <id>` | Single coin's market detail (price / supply / ATH / homepage) |
|
||
| `opencli coingecko trending` | Top trending coins on CoinGecko in the last 24h |
|
||
| `opencli coingecko exchanges` | Top exchanges ranked by trust score / 24h BTC volume |
|
||
| `opencli coingecko categories` | Crypto sector categories (DeFi / Layer1 / Memes / …) with market cap |
|
||
| `opencli coingecko derivatives` | Top crypto derivative (perpetual / futures) markets by 24h volume |
|
||
| `opencli coingecko global` | Aggregate market totals: total cap, volume, BTC/ETH dominance |
|
||
|
||
## Usage Examples
|
||
|
||
```bash
|
||
# Top 10 coins in USD (default)
|
||
opencli coingecko top
|
||
|
||
# Top 5 coins priced in CNY
|
||
opencli coingecko top --currency cny --limit 5
|
||
|
||
# Top 50 coins in EUR
|
||
opencli coingecko top --currency eur --limit 50
|
||
|
||
# Single coin detail (slug from `top` or coingecko URL)
|
||
opencli coingecko coin bitcoin
|
||
opencli coingecko coin ethereum --currency cny
|
||
|
||
# Trending in the last 24h (search-volume based)
|
||
opencli coingecko trending
|
||
|
||
# Top exchanges (trust score, 24h BTC volume)
|
||
opencli coingecko exchanges --limit 20
|
||
|
||
# Crypto sector categories (default sort: market_cap_desc)
|
||
opencli coingecko categories --limit 10
|
||
opencli coingecko categories --sort market_cap_change_24h_desc --limit 10
|
||
|
||
# Top derivative tickers (perpetuals + futures, sorted by 24h USD volume)
|
||
opencli coingecko derivatives --limit 20
|
||
|
||
# Filter derivatives by symbol substring (BTC pairs only)
|
||
opencli coingecko derivatives --symbol BTC --limit 10
|
||
|
||
# Aggregate market totals (BTC dominance, total cap, etc.)
|
||
opencli coingecko global
|
||
opencli coingecko global --currency cny
|
||
|
||
# JSON output
|
||
opencli coingecko top -f json
|
||
```
|
||
|
||
## Options
|
||
|
||
### `top`
|
||
|
||
| Option | Description |
|
||
|--------|-------------|
|
||
| `--currency` | Quote currency (`usd` / `cny` / `eur` / `jpy` / etc., default: `usd`) |
|
||
| `--limit` | Number of coins to return (1–250, default: 10) |
|
||
|
||
### `coin`
|
||
|
||
| Option | Description |
|
||
|--------|-------------|
|
||
| `id` (positional) | CoinGecko coin slug (lowercase, e.g. `bitcoin`, `ethereum`, `solana`) |
|
||
| `--currency` | Quote currency (default: `usd`) |
|
||
|
||
### `trending`
|
||
|
||
No arguments — returns the current top-7 trending list.
|
||
|
||
### `exchanges`
|
||
|
||
| Option | Description |
|
||
|--------|-------------|
|
||
| `--limit` | Number of exchanges to return (1–250, default: 20) |
|
||
|
||
### `categories`
|
||
|
||
| Option | Description |
|
||
|--------|-------------|
|
||
| `--sort` | One of `market_cap_desc` (default), `market_cap_asc`, `name_desc`, `name_asc`, `market_cap_change_24h_desc`, `market_cap_change_24h_asc` |
|
||
| `--limit` | Number of categories to return (1–100, default: 20) |
|
||
|
||
### `derivatives`
|
||
|
||
| Option | Description |
|
||
|--------|-------------|
|
||
| `--limit` | Max rows to return (1–500, default: 20) |
|
||
| `--symbol` | Optional symbol substring filter (e.g. `BTC`, `ETHUSDT`) — also matches the `index_id` field |
|
||
|
||
### `global`
|
||
|
||
| Option | Description |
|
||
|--------|-------------|
|
||
| `--currency` | Quote currency for total market cap / volume (default: `usd`) |
|
||
|
||
## Output Columns
|
||
|
||
| Command | Columns |
|
||
|---------|---------|
|
||
| `top` | `rank, symbol, name, price, change24hPct, marketCap, volume24h, high24h, low24h` |
|
||
| `coin` | `id, symbol, name, rank, price, marketCap, volume24h, change24hPct, change7dPct, change30dPct, ath, athDate, atl, atlDate, circulatingSupply, totalSupply, maxSupply, genesisDate, homepage` |
|
||
| `trending` | `rank, id, symbol, name, marketCapRank, priceBtc, thumb` |
|
||
| `exchanges` | `rank, id, name, trustScore, volume24hBtc, country, yearEstablished, url` |
|
||
| `categories` | `rank, id, name, marketCap, volume24h, marketCapChange24hPct, top3Coins` |
|
||
| `derivatives` | `rank, market, symbol, indexId, contractType, price, change24hPct, fundingRate, openInterestUsd, volume24hUsd, expired` |
|
||
| `global` | `currency, totalMarketCap, totalVolume24h, marketCapChange24hPct, btcDominancePct, ethDominancePct, activeCryptocurrencies, markets, ongoingIcos, updatedAt` |
|
||
|
||
## Prerequisites
|
||
|
||
- No browser required — uses CoinGecko's public market-data endpoint
|
||
|
||
## Notes
|
||
|
||
- The public endpoint is rate-limited; retry briefly if you hit transient `HTTP 429` responses
|
||
- All numeric values are denominated in the selected `--currency`; `coin` fails fast if CoinGecko returns no market fields for that currency
|
||
- `change24hPct` is a raw percent (e.g. `2.34` means `+2.34%`), not a fraction
|
||
- `--limit` is validated upfront and rejected with `ArgumentError` if non-positive or above 250 (the CoinGecko `per_page` upper bound) — no silent clamp
|