docs

CoinGlass Node

The CoinGlass node pulls derivatives and market-structure data into your workflow. It is organized as categories and lenses: pick a category (Derivatives, Positioning, Liquidations, Hyperliquid, Market Screener, Options, ETF, On-chain, Macro & Sentiment), then the lens that answers your question. Every lens returns the same envelope — a one-line summary, a latest value, and a normalized series, rows, or snapshot — so downstream nodes learn the shape once.

BTC Derivatives
BTC · Open Interest

Why Derivatives Data Matters

Spot price alone tells you where the market is. Derivatives data tells you where it is going — and who is about to get hurt.

  • Open interest tracks how much money is committed to futures positions. Rising OI into a rally means leveraged longs are piling in — fuel for a liquidation cascade if price reverses.
  • Funding rates show whether longs or shorts are paying to hold. Extreme positive funding means the market is overleveraged long; extreme negative means the opposite. Both are contrarian signals.
  • Positioning (account and top-trader ratios, taker buy/sell) reveals how the crowd and the whales are leaning.
  • Liquidations measure forced position closures. A $500M liquidation event often marks a local top or bottom.
  • Hyperliquid whales, ETF flows, and exchange reserves show where large capital is moving right now.
  • Macro indexes (Fear & Greed, dominance, altcoin season, cycle-top indicators) frame the regime you are trading in.

Configuration

FieldDescription
API CredentialNickAI (default, free) or your own CoinGlass API key from coinglass.com/account ↗.
Category → LensThe dataset to fetch (see the catalog below).
SymbolA coin symbol (BTC). When a specific exchange is selected the node builds that exchange's instrument for you (BTCUSDT on Binance, BTC-USDT-SWAP on OKX, BTC-USD on Hyperliquid). You can also paste a full instrument id. Supports dynamic values via the f(x) toggle. Hidden for market-wide lenses.
ExchangeShown when the lens has an exchange dimension. All (Aggregated) uses CoinGlass's cross-exchange aggregate where one exists; per-exchange lenses default to Binance.
IntervalCandle size for history lenses: 1m … 12h, 1d, 1w.
WindowLookback for snapshot lenses: last 1h / 4h / 12h / 24h.
Data Points / Row LimitCandles or rows to return (1–500). Parameter-less histories (Fear & Greed, ETF flows, dominance…) are cut to the newest N server-side, and whole-market lists to the top N.
Weighting / ETF Family / Position SizeLens-specific options for market-wide funding, ETF flows, and funding arbitrage.

Lens Catalog

CategoryLensWhat it returnsSymbolExchange
Derivativesopen-interestOI OHLC in USD, aggregated or per exchangecoinoptional
Derivativesopen-interest-by-exchangeCurrent OI per venue with 1h/4h/24h changecoin—
Derivativesfunding-rateFunding OHLC for one pair on one exchangecoin → pairrequired (Binance default)
Derivativesfunding-rate-aggregatedMarket-wide funding OHLC, OI- or volume-weightedcoin—
Derivativesfunding-by-exchangeFunding, next funding, OI, volume, liquidations on every venuecoin—
Derivativesfunding-arbitrageCross-venue funding spreads ranked by APRoptional filter—
Positioninglong-short-accountsShare of accounts long vs shortcoin → pairrequired
Positioningtop-trader-positionsTop traders' long/short position ratiocoin → pairrequired
Positioningtaker-buy-sellAggressive buy vs sell volume, market-wide and per venuecoin—
LiquidationsliquidationsLong/short liquidations per candle, aggregated (Binance, OKX, Bybit, Bitget) or per exchangecoinoptional
Liquidationsliquidations-by-exchangeLiquidation totals per venue over the windowcoin—
Hyperliquidhl-whale-alertsPosition opens/closes over $1M with entry and liquidation priceoptional filter—
Hyperliquidhl-whale-positionsOpen whale positions: size, leverage, entry, mark, liq, PnLoptional filter—
Market Screenercoins-marketsEvery coin's price, OI, OI/mcap, funding, L/S, volume, liquidationsoptional filter—
Market Screenerrsi-screenerRSI for every coin across 15m → 1woptional filter—
Optionsoptions-open-interestOptions OI and 24h volume per venuecoin—
Optionsoptions-max-painMax pain price and call/put OI per expirycoinrequired (Deribit default)
ETFetf-flowsDaily net spot-ETF flows with per-ticker breakdown (BTC, ETH, SOL, XRP)——
On-chainexchange-reservesBalance held by each exchange with 1d/7d/30d changecoin—
On-chainwhale-transfersOn-chain transfers over $10M with labelled counterpartiesoptional filter—
Macrofear-greedDaily Fear & Greed score (0–100) with BTC price——
Macrobitcoin-dominanceBTC share of total market cap——
Macroaltcoin-seasonAltcoin Season Index (75+ = altcoin season)——
Macrobull-market-peak30 cycle-top indicators with hit status——

Dynamic Symbols

Toggle the f(x) button next to the symbol field to use a value from an upstream node:

{my_function.symbol}

Workflow Examples

Funding Rate Monitor

Track market-wide funding and alert when it reaches an extreme — a classic contrarian signal.

Funding (market-wide)
BTC
Rate Extreme?
1 rule
Analyze Signal
Claude Sonnet 4.6
Alert Team

Use the funding-rate-aggregated lens and set the Conditional node on {coinglass.latest.close} (for example greater than 0.05 or less than -0.03). When it fires, the LLM interprets the signal and the email node notifies your team.

Liquidation-Based Signals

Liquidations
BTC · 1h
Total > $100M?
1 rule
Place Order
Buy BTC

The liquidations lens already sums the candle into {coinglass.latest.totalLiquidationUsd}, so no Function node is needed before the Conditional.

Cross-Venue Funding Arbitrage

Funding Arbitrage
$10K
Funding by Exchange
BTC
Rank Opportunities
Claude Sonnet 4.6
Send Digest

Pricing & Credits

The CoinGlass node is free on NickAI — every lens costs 0 credits. Results are cached for the endpoint's refresh cadence (15s–6h), so repeated calls inside that window return instantly. The properties panel shows the refresh window for the selected lens.


Output

PathDescription
{coinglass.summary}One-sentence synthesis (e.g. "BTC market-wide funding is +0.0067% (−18% vs prior) per 8h").
{coinglass.lens} / {coinglass.category}The lens and category that ran.
{coinglass.symbol} / {coinglass.exchange}The instrument and venue actually queried (all for aggregates).
{coinglass.interval} / {coinglass.range}Candle interval or lookback window, when the lens has one.
{coinglass.latest}The newest series point — use this in Conditional nodes.
{coinglass.series}Time series, oldest → newest, time in milliseconds. OHLC lenses: open/high/low/close. Liquidations: longLiquidationUsd/shortLiquidationUsd/totalLiquidationUsd. Ratios: longPercent/shortPercent/ratio. Fear & Greed: value/price. ETF flows: flowUsd/priceUsd/flows.
{coinglass.rows}Ranked records for list lenses (CoinGlass field names, e.g. open_interest_usd).
{coinglass.snapshot}The aggregate object where one exists (the "All" row, taker totals).
{coinglass.data}The CoinGlass v4 payload, trimmed to the window actually returned — the same limit and symbol filter the views used, so a screener call does not carry the whole market. Screener lenses reduce it to the reported columns. Each row also carries an ISO datetime beside the provider's unix timestamp.
{coinglass.metadata}dataPoints — always the number of records actually present, never the upstream length. When the agent view was trimmed it also carries dataPointsAvailable and truncated: true, plus units where the provider sends bare numbers (funding is whole percent: 0.01 means 0.01%). Also creditsUsed, cacheHit, rateLimit, requestedAt.

Example Output

{
  "source": "coinglass",
  "category": "derivatives",
  "lens": "funding-rate-aggregated",
  "symbol": "BTC",
  "exchange": "all",
  "interval": "8h",
  "summary": "BTC market-wide funding is +0.0067% (-18.2% vs prior) per 8h.",
  "latest": { "time": 1788307200000, "open": 0.0082, "high": 0.0088, "low": 0.0050, "close": 0.0067 },
  "series": [ { "time": 1788278400000, "open": 0.0064, "close": 0.0082 }, { "time": 1788307200000, "open": 0.0082, "close": 0.0067 } ],
  "data": [ { "time": 1788307200000, "open": "0.008203", "high": "0.008811", "low": "0.004985", "close": "0.006684" } ],
  "metadata": { "source": "coinglass", "apiVersion": "v4", "dataPoints": 2, "creditsUsed": 0, "cacheHit": false }
}

Next Steps

  • LLM Node — Feed summary and series into an LLM for analysis and trade recommendations.
  • Conditional Node — Route on latest.close, latest.totalLiquidationUsd, or latest.value.
  • Function Node — Combine several lenses (e.g. funding vs open interest) into one signal.
  • Price Data Node — Combine spot price with derivatives data for divergence analysis.
  • Credentials — Set up your CoinGlass API key.