CoinGlass Node

The CoinGlass node pulls derivatives market data into your workflow — liquidations, open interest, funding rates, long/short ratios, the Fear & Greed Index, and options data. You can use it to detect leverage build-ups, spot extreme sentiment, and trigger trades based on data that most retail traders never see.

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. Here is what each data type reveals:

• Open Interest tracks how much money is committed to futures positions. A sharp rise in OI during a rally means leveraged longs are piling in — which creates fuel for a liquidation cascade if the price reverses.
• Funding Rates show whether longs or shorts are paying to hold their positions. Extreme positive funding means the market is overleveraged long; extreme negative means the opposite. Both are contrarian signals.
• Liquidations measure forced position closures. A $500M liquidation event tells you a major deleveraging just happened — and often marks a local bottom or top.
• Long/Short Ratio reveals how traders on a given exchange are positioned. When 80% of accounts are long, the crowd is usually wrong.
• Fear & Greed Index is a composite sentiment score. Extreme fear often signals buying opportunities; extreme greed signals caution.
• Options Data provides open interest, volume, and max pain for options markets — useful for identifying key price levels where large options positions cluster.

By feeding derivatives data into an LLM or Function node, you can build workflows that react to leverage dynamics rather than just price action.

Configuration

Data Types

Symbol Format

The symbol format changes based on the data type you select:

• Full trading pair (e.g., BTCUSDT, ETHUSDT, SOLUSDT) — required for Liquidations, Funding Rates, and Long/Short Ratio.
• Base symbol only (e.g., BTC, ETH, SOL) — required for Open Interest and Options Data.
• Not required — Fear & Greed Index is a global metric and ignores the symbol field.

Dynamic Symbols

Toggle the f(x) button next to the symbol field to use a value from an upstream node. For example, you can have a Function node output a symbol and feed it into the CoinGlass node dynamically:

{{my_function.symbol}}

This lets you build workflows that iterate over multiple assets or respond to external signals.

Workflow Examples

Funding Rate Monitor

Track funding rates and alert when they reach extreme levels — a classic contrarian signal.

Set the Conditional node to check if the funding rate exceeds a threshold (e.g., greater than 0.05% or less than -0.03%). When it fires, the LLM interprets the signal in context and the email node notifies your team.

Liquidation-Based Signals

Detect large liquidation events and use them as entry signals — massive liquidations often mark turning points.

The Function node sums the liquidation volume from the raw data. The Conditional node checks if the total exceeds your threshold. If it does, the Exchange node places the trade.

OI Divergence

Compare open interest trends against price to spot divergences — rising OI with falling price often signals an incoming short squeeze.

Both the CoinGlass node and the Price Data node feed into the LLM simultaneously. The LLM compares OI trends against price movement and flags divergences. The Conditional node routes the decision.

Exchange Limitations

Not all exchanges support all assets. Keep these in mind when configuring the node:

Pricing & Credits

Each CoinGlass API call costs a flat 20 credits when using NickAI Credits, regardless of data type or number of data points requested.

Output

The CoinGlass node outputs a structured object with the fetched data and metadata.

Example Output

{
  "symbol": "BTC",
  "dataType": "openInterest",
  "timestamp": 1710835200,
  "exchange": "all",
  "data": [
    { "t": 1710835200, "o": 32500000000, "h": 33100000000, "l": 32200000000, "c": 32800000000 }
  ],
  "metadata": {
    "source": "coinglass",
    "apiVersion": "v3",
    "requestedAt": "2026-03-19T11:46:38Z",
    "dataPoints": 100
  }
}

The data field structure changes depending on the data type. Open Interest returns OHLC-style objects, Liquidations return volume breakdowns, and Fear & Greed Index returns simple score values. Use a Function node to inspect the raw shape if you need to parse specific fields.

Next Steps

• LLM Node — Feed derivatives data into an LLM for analysis and trade recommendations.
• Function Node — Parse, transform, or aggregate raw CoinGlass data with custom JavaScript.
• Conditional Node — Route decisions based on funding rates, OI thresholds, or sentiment scores.
• Price Data Node — Combine spot price with derivatives data for divergence analysis.
• Credentials — Set up your CoinGlass API key.