coinglass — Claude Code skill: crypto derivatives data
A script skill that hands your agent 37 CoinGlass API v4 functions for funding rates, open interest, liquidations and ETF flows.
npx skills add Starchild-ai-agent/official-skills --skill coinglass -a claude-codeWhat coinglass does
This one is a script skill. The agent reads SKILL.md, then pulls functions out of exports.py and runs them from a bash block with python3. Altogether 37 tools sit on top of CoinGlass API v4. Coin, exchange and pair lookups come from the same package, so tickers are never a blocker.
Watch the plan tier. The platform key is Startup, and the liquidation heatmap, the all-coin market summary, single liquidation orders and Hyperliquid positions all return 401 “Upgrade plan” on it. Bringing a Basic key or higher does work, with a caveat: point requests straight at https://open-api-v4.coinglass.com, since the proxy overwrites that header.
Nothing runs without COINGLASS_API_KEY in the environment. A market-wide open interest total is out of reach on this tier, so take the per-coin figure from the exchangeName=="All" row, or add up perpetuals through the coingecko skill and label the source on the chart. Never mix two sources in one comparison line.
What it helps with
- check perp funding before sizing a position
- sum open interest for a few coins at one timestamp
- pull liquidation history for BTCUSDT
- compare inflows into BTC and ETH ETFs over a week
- track large wallet transfers
Example prompts for the agent
- Pull ETH funding and its open interest over the last day
- Compare BTC ETF and ETH ETF flows for this week
- Get liquidation history for BTCUSDT over 24 hours
How to install coinglass
1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill coinglass -a claude-code2Manually: put the files in place
~/.claude/skills/coinglass/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/coinglass/
1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill coinglass -a codex2Manually: put the files in place
.agents/skills/coinglass/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill coinglass -a cursor2Manually: put the files in place
.cursor/skills/coinglass/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Starchild-ai-agent/official-skills coinglass2Manually: put the files in place
.github/skills/coinglass/SKILL.md1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill coinglass -a gemini-cli2Platform CLI
gemini skills install https://github.com/Starchild-ai-agent/official-skills --path coinglassManually: put the files in place
.devin/skills/coinglass/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill coinglass -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about coinglass
How do I install coinglass in Claude Code?
Run npx skills add Starchild-ai-agent/official-skills --skill coinglass -a claude-code. The skill lands at ~/.claude/skills/coinglass/SKILL.md.
What does the coinglass skill do?
It gives the agent CoinGlass API v4 functions covering perp funding, open interest, liquidations, net positions, ETF flows and whale transfers, and the agent calls them from inside a script.
Do I need my own API key?
The skill reads COINGLASS_API_KEY from the environment. The platform key on Startup covers most endpoints; a user-owned Basic key or higher opens the rest, but only when calling https://open-api-v4.coinglass.com directly.
