Coinglass
Wire crypto derivatives market data—funding, open interest, liquidations, and futures metrics—into agent workflows via Coinglass API tools.
Overview
Coinglass is an agent skill for the Build phase that registers Coinglass API tools for funding rates, positioning ratios, liquidations, and futures market data.
Install
npx skills add https://github.com/starchild-ai-agent/official-skills --skill coinglassWhat is this skill?
- Funding rates, open interest, and long/short ratios via Coinglass V2 APIs
- Liquidation data across V2 and V4 API surfaces
- Futures market suite: supported coins/exchanges, pair metrics, and OHLC price history (V4)
- Extension entry point registers FundingRate, LongShortRatio, GlobalAccountRatio, TopAccountRatio, TopPositionRatio, and
- Requires COINGLASS_API_KEY environment variable for agent use
- V2 and V4 Coinglass API surfaces referenced for liquidations and futures data
- Multiple registered tool types including funding, ratios, liquidations, and taker buy/sell
Adoption & trust: 10k installs on skills.sh; 13 GitHub stars; 3/3 security scanners passed (skills.sh audits); trending (+100% hot-view momentum).
Who is it for?
Indie builders running Starchild-style agents who analyze perp funding, positioning, and liquidation risk for crypto strategies or content.
Skip if: Builders without a Coinglass API key or those who only need spot CEX prices without derivatives coverage.
When should I use this skill?
Agents need Coinglass derivatives data and are configured with COINGLASS_API_KEY and tools in agents.yaml.
What do I get? / Deliverables
After registration, configured agents call named Coinglass tools with your API key and return structured derivatives market data inside the agent workflow.
- Registered Coinglass tool names on the agent registry
- Agent-callable responses for funding, OI, ratios, liquidations, and futures metrics
Recommended Skills
Journey fit
Build → Integrations is the canonical shelf because the skill registers external API tools for agents rather than validating ideas or operating production monitors. Integrations subphase matches ExtensionLoader registration, COINGLASS_API_KEY setup, and multi-tool market data access.
How it compares
Agent extension with discrete market-data tools—not a hosted MCP server or a backtesting engine.
Common Questions / FAQ
Who is coinglass for?
Developers wiring official Starchild agent extensions who want derivatives data callable from agents.yaml without writing raw HTTP clients.
When should I use coinglass?
During Build when integrating market-data tools into agents—for example before shipping a research bot, risk alert workflow, or internal trading assistant.
Is coinglass safe to install?
It requires a paid/third-party API key and network access; review the Security Audits panel on this page and scope the key with least privilege in Coinglass.
SKILL.md
READMESKILL.md - Coinglass
""" Coinglass Extension - Crypto Derivatives Data Tools Provides crypto derivatives market data including: - Funding rates (V2 API) - Open interest (V2 API) - Long/Short ratios (V2 API) - Liquidations (V2/V4 API) - Futures market data (V4 API) - Supported coins and exchanges - Comprehensive market data for all coins - Pair-specific market metrics - OHLC price history Environment Variables Required: - COINGLASS_API_KEY: Coinglass API key Usage: This extension is auto-loaded by the ExtensionLoader. Tools are available to agents configured with these tools in agents.yaml. """ import os import sys import logging from typing import List try: from core.tool import ToolRegistry except Exception: ToolRegistry = None # Standalone script usage logger = logging.getLogger(__name__) # Add local tools directory to path for imports TOOLS_DIR = os.path.join(os.path.dirname(__file__), 'tools') if TOOLS_DIR not in sys.path: sys.path.insert(0, TOOLS_DIR) def register(api) -> List[str]: """ Extension entry point - register all Coinglass tools. Args: api: ExtensionApi instance with registry and config Returns: List of registered tool names """ registered = [] try: from .coinglass import ( FundingRateTool, LongShortRatioTool, GlobalAccountRatioTool, TopAccountRatioTool, TopPositionRatioTool, TakerBuySellExchangesTool, NetPositionTool, OpenInterestTool, LiquidationsTool, LiquidationAnalysisTool, CoinLiquidationHistoryTool, PairLiquidationHistoryTool, LiquidationCoinListTool, LiquidationOrdersTool, HyperliquidWhaleAlertsTool, HyperliquidWhalePositionsTool, HyperliquidPositionsByCoinTool, HyperliquidPositionDistributionTool, SupportedCoinsTool, SupportedExchangesTool, CoinsMarketDataTool, PairMarketDataTool, OHLCHistoryTool, TakerVolumeHistoryTool, AggregatedTakerVolumeTool, CumulativeVolumeDeltaTool, CoinNetflowTool, WhaleTransferTool, BTCETFFlowsTool, BTCETFPremiumDiscountTool, BTCETFHistoryTool, BTCETFListTool, HKBTCETFFlowsTool, ETHETFFlowsTool, ETHETFListTool, SOLETFFlowsTool, XRPETFFlowsTool, ) # Register existing V2 tools api.register_tool(FundingRateTool()) api.register_tool(LongShortRatioTool()) # Register advanced long/short ratio tools api.register_tool(GlobalAccountRatioTool()) api.register_tool(TopAccountRatioTool()) api.register_tool(TopPositionRatioTool()) api.register_tool(TakerBuySellExchangesTool()) api.register_tool(NetPositionTool()) api.register_tool(OpenInterestTool()) api.register_tool(LiquidationsTool()) api.register_tool(LiquidationAnalysisTool()) # Register advanced liquidation tools api.register_tool(CoinLiquidationHistoryTool()) api.register_tool(PairLiquidationHistoryTool()) api.register_tool(LiquidationCoinListTool()) api.register_tool(LiquidationOrdersTool()) # Register Hyperliquid tools api.register_tool(HyperliquidWhaleAlertsTool()) api.register_tool(HyperliquidWhalePositionsTool()) api.register_tool(HyperliquidPositionsByCoinTool()) api.register_tool(HyperliquidPositionDistributionTool()) # Register new V4 futures market tools api.register_tool(SupportedCoinsTool()) api.register_tool(SupportedExchangesTool()) api.register_tool(CoinsMarketDataTool()) api.register_tool(PairMarketDataTool()) api.register_tool(OHLCHistoryTool()) # Register Volume & Flow t