Connector guide8-minute read24 MCP tools7 languages

How to Connect CoinGlass to Gemini via MCP

Crypto derivatives data from CoinGlass: futures open interest across exchanges, funding rates, long/short ratios, liquidations, options max pain, spot bitcoin and ether ETF flows, stablecoin market cap, Coinbase premium and the Fear & Greed Index. Read-only; needs a paid CoinGlass API plan.

HCBy HelpCode teamUpdated 8 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

CoinGlass

CoinGlass

Crypto derivatives data from CoinGlass: futures open interest across exchanges, funding rates (also open-interest weighted), long/short ratios of all and top traders, liquidations, options max pain, spot bitcoin and ether ETF flows, stablecoin market cap, Coinbase premium and the Fear & Greed Index. Read-only; needs a CoinGlass API plan.

tools

24

Region

INTL

Category

Finance

Authentication

API Key

Required env vars

COINGLASS_API_KEY
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Skip the install. Get this working in under 2 minutes.

Start a free trial on cloud.anythingmcp.com, add the CoinGlass in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.

Start free trial

Summary

Crypto derivatives data from CoinGlass: futures open interest across exchanges, funding rates, long/short ratios, liquidations, options max pain, spot bitcoin and ether ETF flows, stablecoin market cap, Coinbase premium and the Fear & Greed Index. Read-only; needs a paid CoinGlass API plan.

Try asking

Example prompts for CoinGlass

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

CoinGlass · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → CoinGlass, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

CoinGlass + Gemini

Crypto derivatives data from CoinGlass: futures open interest across exchanges, funding rates, long/short ratios, liquidations, options max pain, spot bitcoin and ether ETF flows, stablecoin market cap, Coinbase premium and the Fear & Greed Index. Read-only; needs a paid CoinGlass API plan.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

COINGLASS_API_KEY

Step 1 — Get credentials

Setting up takes about 2 minutes. You need a CoinGlass account with a paid API plan (Hobbyist or higher).

  1. Choose an API plan at https://www.coinglass.com/pricing.
  2. Open the API Key page of your account (https://www.coinglass.com/account) and copy the key into COINGLASS_API_KEY. It is sent in the CG-API-KEY header.
  3. Install the connector and run coinglass_get_account_subscription: it shows the plan level (HOBBYIST, STARTUP, STANDARD, PROFESSIONAL), its expiry time and whether it has expired, and confirms the key.

Coin or pair: some tools work on a coin across all exchanges, others on one pair on one exchange. Coin-level tools take a coin as symbol (BTC, ETH); coinglass_list_supported_coins lists them. Pair-level tools take an exchange spelled as coinglass_list_supported_exchanges returns it (Binance, OKX, Bybit) and a pair as symbol (BTCUSDT); coinglass_list_exchange_pairs lists the pairs of an exchange.

What it reads:

  • Open interest of a coin aggregated across exchanges, the current open interest per exchange (USD value, quantity, stablecoin- and coin-margined, change from 5 minutes to 24 hours), and open interest candles of one pair.
  • Funding rates: candles of one perpetual pair, the open-interest-weighted rate of a coin across exchanges, and the current rate of every coin on every exchange with the funding interval and the next funding time.
  • Long/short ratios of one pair on one exchange: all trader accounts (Binance, OKX, Gate, HTX, Bybit), top trader accounts and top trader positions.
  • Liquidations: long and short liquidations in USD per interval, for one pair or summed for a coin over the exchanges you name.
  • A market snapshot of every futures pair of a coin (price, index price, 24 hour change, volume, open interest, funding rate, 24 hour liquidations) and price candles of one pair.
  • Options max pain per expiry for a coin on one options exchange (Deribit, Binance, OKX), with call and put open interest and their market value.
  • Spot ETFs: daily net flows of the US spot bitcoin and ether ETFs, in total and per fund (IBIT, FBTC, ETHA, ...), since launch, and the list of spot bitcoin ETFs with assets under management, fee, BTC holdings, net asset value and premium or discount.
  • Indicators: the stablecoin market cap and the Crypto Fear & Greed Index (0 extreme fear to 100 extreme greed) over time, both with the BTC price alongside, and the Coinbase premium index (BTC on Coinbase in USD against Binance in USDT).

Intervals and history: history tools take interval (1m up to 1w), limit (up to 1000 points, newest last) and optionally start_time / end_time in Unix milliseconds. The AI asks only for what the question needs, for example interval: 1d with limit: 30 for a month of daily points.

Data formats: returned time values are Unix milliseconds, except the Coinbase premium, stablecoin market cap and Fear & Greed lists, which use seconds. Funding rates are in percent per funding interval (0.01 means 0.01%). The Coinbase premium_rate is a fraction (0.0261 = 2.61%). Open interest is in USD unless unit: coin is asked for. ETF flows are in USD; positive means inflow.

Read-only: every tool only reads, so there is nothing to confirm and no tool is switched off at install.

Limits: requests per minute depend on the plan: Hobbyist 30, Startup 80, Standard 300, Professional 1200. Hobbyist allows only intervals of 4h and longer, Startup 30m and longer, Standard and up any interval. How far back each interval reaches also grows with the plan; daily data goes back to the start on every plan.

Common errors: CoinGlass answers HTTP 200 with a code other than "0" when something is wrong. 401 or "Invalid API key" means a missing or wrong key; 429 means the per-minute limit is used up; 400 means a wrong parameter or a call your plan does not include, such as an interval that is too short. In that case the AI switches to a longer interval instead of retrying.

The connector does not place orders, connect to exchange accounts or read your own positions; it reads CoinGlass market data only.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Gemini

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of YOUR_MCP_API_KEY.
  2. Save the file and restart gemini.
  3. Run /mcp inside Gemini CLI (or gemini mcp list in your shell): anythingmcp should show as connected.
  4. Start prompting: Gemini CLI can now call the CoinGlass tools.

Available tools

ToolWhat it does
coinglass_get_account_subscriptionShow the CoinGlass API plan of the key (level such as HOBBYIST, STARTUP, STANDARD, PROFESSIONAL), its expiry time and whether it has expired
coinglass_list_supported_coinsList the coins CoinGlass covers for futures data (BTC, ETH, SOL, ...)
coinglass_list_supported_exchangesList the futures exchanges CoinGlass covers (Binance, OKX, Bybit, Deribit, CME, Hyperliquid, ...), spelled as the exchange parameter expects
coinglass_list_exchange_pairsList the futures trading pairs per exchange: instrument_id (the pair the pair-level tools take as symbol, e.g
coinglass_get_pairs_marketsCurrent market snapshot of every futures pair of a coin across exchanges: price, index price, 24 hour price change, volume, long and short…
coinglass_get_price_historyPrice candles (open, high, low, close, volume_usd) of one futures pair on one exchange
coinglass_get_open_interest_historyOpen interest candles (open, high, low, close) of one futures pair on one exchange
coinglass_get_aggregated_open_interest_historyOpen interest of a coin aggregated across all exchanges, as candles (open, high, low, close in USD)
coinglass_list_open_interest_by_exchangeCurrent open interest of a coin per exchange (the first row, exchange All, is the total): USD value, quantity, split into stablecoin- and…
coinglass_get_funding_rate_historyFunding rate candles (open, high, low, close) of one perpetual pair on one exchange
coinglass_get_oi_weighted_funding_rate_historyFunding rate of a coin across all exchanges, weighted by each exchange's open interest, as candles (open, high, low, close, in percent)
coinglass_list_funding_rates_by_exchangeCurrent funding rate of every coin on every exchange, split into stablecoin-margined and coin-margined contracts, with the funding interval…
coinglass_get_global_long_short_account_ratioLong/short ratio of all trader accounts on one exchange for one pair: percent of accounts long, percent short and the ratio
coinglass_get_top_long_short_account_ratioLong/short ratio of the top trader accounts on one exchange for one pair: percent of top accounts long and short and the ratio
coinglass_get_top_long_short_position_ratioLong/short ratio of the positions of top traders on one exchange for one pair, weighted by position size rather than by account
coinglass_get_liquidation_historyLiquidations of one futures pair on one exchange per interval: long_liquidation_usd and short_liquidation_usd
coinglass_get_aggregated_liquidation_historyLiquidations of a coin summed over the exchanges you name, per interval: aggregated long and short liquidations in USD
coinglass_get_option_max_painOptions max pain per expiry for a coin on one options exchange: max pain price, call and put open interest and their market value
coinglass_get_bitcoin_etf_flowsDaily net flows of the US spot bitcoin ETFs: total flow_usd per day, the BTC price, and the flow of each ETF (IBIT, FBTC, GBTC, ...)
coinglass_get_ethereum_etf_flowsDaily net flows of the US spot ether ETFs: total flow_usd per day, the ETH price, and the flow of each ETF (ETHA, FETH, ...)
coinglass_list_bitcoin_etfsList the spot bitcoin ETFs with ticker, fund name, region, primary exchange, market status, assets under management, management fee…
coinglass_get_stablecoin_market_cap_historyHistory of the total stablecoin market capitalisation with the BTC price alongside: parallel lists data_list (market cap, USD), price_list…
coinglass_get_fear_greed_historyHistory of the Crypto Fear & Greed Index (0 extreme fear to 100 extreme greed) with the BTC price alongside: parallel lists data_list…
coinglass_get_coinbase_premium_indexCoinbase premium index: the gap between the BTC price on Coinbase (USD) and on Binance (USDT), as premium in USD and premium_rate (0.0261 =…

Example prompts

  • "How has bitcoin open interest across all exchanges changed over the last 30 days, and did the price move with it?"
  • "Which exchanges have the highest ETH funding rates right now, and are longs crowded?"
  • "Show the long and short liquidations of BTCUSDT on Binance per 4 hours over the last 3 days."
  • "What were the net flows of the US spot bitcoin ETFs this week, and which fund took in the most?"
  • "Where is the Fear & Greed Index today compared with a month ago, and what is the BTC options max pain on Deribit for the next expiry?"

FAQ

Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.

Next steps

Was this guide helpful?

Your CoinGlass agent is one click away.

Install the connector, paste the key, prompt Gemini. Free for 7 days, no credit card.

Related guides

Connectors

How to Connect CoinGlass to Microsoft Copilot via MCP

Crypto derivatives data from CoinGlass: futures open interest across exchanges, funding rates, long/short ratios, liquidations, options max pain, spot bitcoin and ether ETF flows, stablecoin market cap, Coinbase premium and the Fear & Greed Index. Read-only; needs a paid CoinGlass API plan.

Connectors

CoinGlass to MCP: Open Interest, Funding Rates, Liquidations and ETF Flows in any AI Agent

Crypto derivatives data from CoinGlass: futures open interest across exchanges, funding rates, long/short ratios, liquidations, options max pain, spot bitcoin and ether ETF flows, stablecoin market cap, Coinbase premium and the Fear & Greed Index. Read-only; needs a paid CoinGlass API plan.

Connectors

How to Connect CoinGlass to ChatGPT via MCP

Crypto derivatives data from CoinGlass: futures open interest across exchanges, funding rates, long/short ratios, liquidations, options max pain, spot bitcoin and ether ETF flows, stablecoin market cap, Coinbase premium and the Fear & Greed Index. Read-only; needs a paid CoinGlass API plan.

Connectors

How to Connect CoinGlass to Claude via MCP

Crypto derivatives data from CoinGlass: futures open interest across exchanges, funding rates, long/short ratios, liquidations, options max pain, spot bitcoin and ether ETF flows, stablecoin market cap, Coinbase premium and the Fear & Greed Index. Read-only; needs a paid CoinGlass API plan.

Connectors

How to Connect CoinGlass to Cursor via MCP

Crypto derivatives data from CoinGlass: futures open interest across exchanges, funding rates, long/short ratios, liquidations, options max pain, spot bitcoin and ether ETF flows, stablecoin market cap, Coinbase premium and the Fear & Greed Index. Read-only; needs a paid CoinGlass API plan.

Connectors

How to Connect CoinGlass to Meta Muse via MCP

Crypto derivatives data from CoinGlass: futures open interest across exchanges, funding rates, long/short ratios, liquidations, options max pain, spot bitcoin and ether ETF flows, stablecoin market cap, Coinbase premium and the Fear & Greed Index. Read-only; needs a paid CoinGlass API plan.