coinglass skill for Starchild agents: crypto derivatives data from Coinglass

The Starchild team's coinglass skill: lets a Starchild agent read crypto derivatives data from the Coinglass API.

Installs: 11.5K; on skills.sh
Stars: 29; on GitHub
Files: 19; besides SKILL.md
Updated: Oct 2026; last repo commit

coinglass is a Python script skill for Starchild agents. Its functions read funding rates, open interest, long/short ratios, liquidations, taker volume, whale transfers and ETF flows from the Coinglass API. The platform key is on the Startup plan, so SKILL.md says liquidation heatmaps, liquidation orders, all-coin market data and Hyperliquid positions return an upgrade error unless you bring your own higher-plan key. It is built for the Starchild platform.

Good for

Traders and analysts who want funding rates, open interest and liquidations on request
People tracking ETF flows and whale transfers
Starchild users who want to bring their own Coinglass key for higher-plan data

Install coinglass

Any client

Run this in a terminal.

shell

npx skills add Starchild-ai-agent/official-skills --skill coinglass

Requires Node.js.

The README describes these skills as maintained by the Starchild team and installed with the skills CLI. The code imports modules from the Starchild agent platform, so it is built to run there. This page has no Claude Code or Claude app tab for that reason.

Built from the package data we hold. Not yet tested by us. Source.

What's in the skill

When it loads

Crypto derivatives data: funding rates, open interest, liquidations, long/short ratios. Use when researching perp markets or comparing ETF flows (e.g. BTC funding, ETH OI). NOTE: platform API key is Startup tier — liquidation heatmap, coins-markets detail, liquidation order book and Hyperliquid positions require higher plans (see Plan Tiers).

Sections in SKILL.md

Plan Tiers (platform key = Startup, verified 2026-09)
Full-market / multi-coin OI routing (coins-markets unavailable)
Liquidation Heatmap (❌ not available on Startup — archived usage)
Script Usage
Function Reference (full signatures + return shapes)
⚠️ Field naming convention (READ THIS FIRST)
Funding & Open Interest
Long/Short Ratios
Liquidations
Futures Market Data
Hyperliquid Whale Tracking
Volume / Flow
ETF Flows
Sample responses (most-used functions)
Tool Selection Guide
Decision Tree

Key facts

Author: The Starchild team (README: official skills maintained by the Starchild team)
License: No LICENSE file at the repo root or in this skill's folder
Installs on skills.sh: 11,478 as of 2026-11-02
GitHub stars: 29 for the whole official-skills repo, 2026-11-02
What is inside: 20 files including SKILL.md: exports.py, coinglass.py, a leftover coinglass.py.backup2, 14 files in tools/, __init__.py and logo.png
Version: 3.2.0 in the SKILL.md frontmatter; its version history lists 3.1.0 as the latest
Tool count: SKILL.md says 37 tools in 8 categories; the category headings add up to 43
Needs: COINGLASS_API_KEY; the platform injects a Startup-plan key through sc-proxy
Last repo commit: 2026-10-30
Works in: Starchild agents. The README documents the skills CLI and search_skills inside a Starchild conversation, and the code imports Starchild platform modules.

What it includes

Funding rate, long/short ratio, open interest, liquidations, supported coins
Seven functions such as funding_rate, cg_open_interest and cg_liquidations. Funding rates come back as strings with a percent sign.
Try: “What is the BTC funding rate across exchanges?”
Network · Basic derivatives
Global account, top account and top position ratios
Six functions for history and trend of how leveraged traders are positioned.
Network · Advanced long/short ratios
Coin list, per-coin history, orders and heatmap
Four functions. SKILL.md says the heatmap and individual liquidation orders are not available on the platform's Startup plan.
Network · Advanced liquidations
Whale alerts and positions
Four functions. Only the alert feed works on the Startup plan; position data needs a higher plan.
Network · Hyperliquid whale tracking
Supported coins, pairs, exchanges and OHLC price history
Five functions. The all-coin market summary is not available on the Startup plan, so SKILL.md routes full-market open interest to the coingecko skill.
Network · Futures market data
Taker volume, cumulative volume delta, net flow
Four functions for buy and sell pressure over time.
Network · Volume and flow
Bitcoin, Ethereum, Solana, XRP and Hong Kong ETF flows
Thirteen functions in two groups, 5 Bitcoin and 8 other, covering flows, lists and premium or discount.
Try: “Compare BTC and ETH ETF flows for the last day.”
Network · ETF data
COINGLASS_DIRECT=1 skips the platform proxy
With your own COINGLASS_API_KEY from a Basic plan or higher, set COINGLASS_DIRECT=1 and the code calls open-api-v4.coinglass.com directly.
Network · Bring your own key

From the official docs

Permissions

Low risk

The skill sends queries and your API key to Coinglass, and some data needs a higher plan. Keep your key in an environment variable.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Your own key can be used directly
With COINGLASS_DIRECT=1 the code sends your COINGLASS_API_KEY straight to Coinglass. Without it, the platform proxy injects its own key and overwrites any key you supply. github.com
Some data returns an upgrade error
On the platform key, the heatmap, liquidation orders, coins-markets and Hyperliquid position endpoints return 401 Upgrade plan, and the code raises CoinglassPlanError with advice. github.com
A backup file ships with it
The folder includes coinglass.py.backup2 next to coinglass.py. It is not referenced by SKILL.md. github.com

Technical details

Turning on read-only	No setting. SKILL.md describes only data queries.
Talks to	https://open-api-v4.coinglass.com (V4 API). https://open-api.coinglass.com/public/v2 (legacy V2 tools)
Sign-in and keys	The code reads COINGLASS_API_KEY from the environment. The platform proxy injects its own key unless you set COINGLASS_DIRECT=1.
Data retention	SKILL.md mentions a learning_log tool, limited to skill bugs and persistent API errors, and does not say where that log goes.
Scopes	Runs Python functions through bash that call the Coinglass API Reads COINGLASS_API_KEY from the environment

Questions

What does the coinglass skill do?

It lets a Starchild agent pull crypto derivatives data from Coinglass: funding rates, open interest, long/short ratios, liquidations, taker volume, whale transfers and ETF flows.

Can I use it in Claude Code?

It is built for Starchild. SKILL.md calls the Python from a Starchild workspace path, and the code uses Starchild's proxy when it is present. A code comment says the fallback to plain requests is for testing outside the platform, and the README does not document that use.

How do I install coinglass?

Use the install box at the top of this page: the skills CLI, or search_skills inside a Starchild conversation.

Do I need a Coinglass API key?

SKILL.md lists COINGLASS_API_KEY as required. On Starchild the platform injects a Startup-plan key. For heatmaps and other higher-plan data, SKILL.md says to bring your own Basic or higher key and set COINGLASS_DIRECT=1.

Why do I get an 'Upgrade plan' error?

The platform key is on the Startup plan. SKILL.md lists the heatmap, liquidation order, coins-markets and Hyperliquid position endpoints as unavailable there. The code raises CoinglassPlanError with the options: your own key, or the apify skill to scrape the page.

Why does SKILL.md say 37 tools?

The frontmatter and intro say 37 tools in 8 categories, but the category headings add up to 43 (7, 6, 4, 4, 5, 4, 5 and 8). Several of the listed functions are marked unavailable on the Startup plan.

Is coinglass safe to use?

The skill queries a data API and bundles Python files that call it. It sends your key to Coinglass when you use direct mode. Keep the key in an environment variable and out of git.

Is it official?

Yes. It is in the Starchild team's official-skills repo. It is not made by Coinglass, which is the data provider.

Information

updated Nov 2, 2026

Repository: starchild-ai-agent/official-skills
Folder: coinglass

starchild-ai-agent/official-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

README · github.com
CONTRIBUTING.md · github.com
coinglass on skills.sh · skills.sh
coinglass SKILL.md · github.com
coinglass/tools/_api.py · github.com