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.
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
| Field | Description |
|---|---|
| API Credential | NickAI (default, free) or your own CoinGlass API key from coinglass.com/account ↗. |
| Category → Lens | The dataset to fetch (see the catalog below). |
| Symbol | A 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. |
| Exchange | Shown when the lens has an exchange dimension. All (Aggregated) uses CoinGlass's cross-exchange aggregate where one exists; per-exchange lenses default to Binance. |
| Interval | Candle size for history lenses: 1m … 12h, 1d, 1w. |
| Window | Lookback for snapshot lenses: last 1h / 4h / 12h / 24h. |
| Data Points / Row Limit | Candles 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 Size | Lens-specific options for market-wide funding, ETF flows, and funding arbitrage. |
Lens Catalog
| Category | Lens | What it returns | Symbol | Exchange |
|---|---|---|---|---|
| Derivatives | open-interest | OI OHLC in USD, aggregated or per exchange | coin | optional |
| Derivatives | open-interest-by-exchange | Current OI per venue with 1h/4h/24h change | coin | — |
| Derivatives | funding-rate | Funding OHLC for one pair on one exchange | coin → pair | required (Binance default) |
| Derivatives | funding-rate-aggregated | Market-wide funding OHLC, OI- or volume-weighted | coin | — |
| Derivatives | funding-by-exchange | Funding, next funding, OI, volume, liquidations on every venue | coin | — |
| Derivatives | funding-arbitrage | Cross-venue funding spreads ranked by APR | optional filter | — |
| Positioning | long-short-accounts | Share of accounts long vs short | coin → pair | required |
| Positioning | top-trader-positions | Top traders' long/short position ratio | coin → pair | required |
| Positioning | taker-buy-sell | Aggressive buy vs sell volume, market-wide and per venue | coin | — |
| Liquidations | liquidations | Long/short liquidations per candle, aggregated (Binance, OKX, Bybit, Bitget) or per exchange | coin | optional |
| Liquidations | liquidations-by-exchange | Liquidation totals per venue over the window | coin | — |
| Hyperliquid | hl-whale-alerts | Position opens/closes over $1M with entry and liquidation price | optional filter | — |
| Hyperliquid | hl-whale-positions | Open whale positions: size, leverage, entry, mark, liq, PnL | optional filter | — |
| Market Screener | coins-markets | Every coin's price, OI, OI/mcap, funding, L/S, volume, liquidations | optional filter | — |
| Market Screener | rsi-screener | RSI for every coin across 15m → 1w | optional filter | — |
| Options | options-open-interest | Options OI and 24h volume per venue | coin | — |
| Options | options-max-pain | Max pain price and call/put OI per expiry | coin | required (Deribit default) |
| ETF | etf-flows | Daily net spot-ETF flows with per-ticker breakdown (BTC, ETH, SOL, XRP) | — | — |
| On-chain | exchange-reserves | Balance held by each exchange with 1d/7d/30d change | coin | — |
| On-chain | whale-transfers | On-chain transfers over $10M with labelled counterparties | optional filter | — |
| Macro | fear-greed | Daily Fear & Greed score (0–100) with BTC price | — | — |
| Macro | bitcoin-dominance | BTC share of total market cap | — | — |
| Macro | altcoin-season | Altcoin Season Index (75+ = altcoin season) | — | — |
| Macro | bull-market-peak | 30 cycle-top indicators with hit status | — | — |
openInterest, fundingRates, liquidations, longShortRatio, fearGreedIndex, optionsData) still work as aliases of their lens, so existing workflows keep running. A saved 7d timeframe now returns real weekly candles; 30d returns daily candles.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.
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
The liquidations lens already sums the candle into {coinglass.latest.totalLiquidationUsd}, so no Function node is needed before the Conditional.
Cross-Venue Funding Arbitrage
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
| Path | Description |
|---|---|
| {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 }
}
data[0].c, data[0].t) should switch to latest.close / series, or to the v4 names in data (close, time in milliseconds).Next Steps
- LLM Node — Feed
summaryandseriesinto an LLM for analysis and trade recommendations. - Conditional Node — Route on
latest.close,latest.totalLiquidationUsd, orlatest.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.