| name | coingecko-id-verif |
| description | Verify CoinGecko IDs for tracked stablecoins by cross-referencing our geckoId config against DefiLlama's geckoId and CoinGecko's contract-address lookup. Use when adding new stablecoins, auditing price data accuracy, or investigating missing/wrong prices. |
CoinGecko ID Verification
Verifies that the geckoId in shared/data/stablecoins/coins/*.json is correct by cross-referencing three sources:
- Our config (
geckoId in the stablecoin JSON registry) -> CoinGecko coin endpoint
- DefiLlama's geckoId (
gecko_id from stablecoins.llama.fi) -> CoinGecko coin endpoint
- Contract address (from our
contracts array) -> CoinGecko contract lookup (ground truth)
When to Use
- Adding a new stablecoin to the tracked list
- Investigating missing prices or incorrect depeg detection
- Periodic audit of price data accuracy
- After discovering a geckoId mismatch between our config and DefiLlama
How to Run
Single coin verification
python3 .claude/skills/coingecko-id-verif/verify.py --coin usdt-tether
Mismatch scan (compares our geckoIds against DefiLlama's)
python3 .claude/skills/coingecko-id-verif/verify.py --scan
Full audit of all tracked coins
python3 .claude/skills/coingecko-id-verif/verify.py --all
Requirements
- Optional CoinGecko Pro API key in
worker/.dev.vars as COINGECKO_API_KEY; without it, the script uses the free API and rate limits more aggressively
curl available on PATH- Python 3.10+
How It Works
For each coin, the script:
- Fetches
/coins/{our_geckoId} from CoinGecko and checks the Ethereum contract address
- Fetches
/coins/{dl_geckoId} from CoinGecko (if different from ours) and checks its address
- Fetches
/coins/ethereum/contract/{our_eth_address} as ground truth
- Reports whether our geckoId, DL's geckoId, or neither matches the contract
The contract address lookup is the ground truth -- it tells you exactly which CoinGecko ID maps to a given on-chain token.
This verifies identity only. For active additions and pre-launch promotions, also run stablecoin-runtime-price-marketcap-gate to prove Pharos can fetch both current price and market cap / circulating supply.
Interpreting Results
VERDICT: Our geckoId is CORRECT -- no action neededVERDICT: DL geckoId is correct, ours is WRONG -- update geckoId in the matching shared/data/stablecoins/coins/*.json entryVERDICT: NEITHER (contract=xxx) -- update our geckoId to xxxVERDICT: Token not found on CoinGecko -- token may not be listed on CG (normal for some coins)
