Crypto Market Data Tools for AI Agents

This scoped endpoint exposes the current Market Data & Price tool set.

Category Endpoint: POST /hive_market_data/mcp

Providers represented here: CoinGecko, Codex, DeFiLlama, CCXT

Scope

This page documents the tools exposed by the category-scoped MCP endpoint above.

tools/list on this category endpoint returns the current scoped tool set directly.
The full Hive server also exposes the complete wrapped provider catalog through root invoke_api_endpoint, category endpoints, and the REST catalog.
For the complete wrapped provider catalog, including tools outside this category page, see Live Catalog.

Included tools

Tool	Provider	Summary
`get_coins_index`	CoinGecko	Query all the metadata (image, websites, socials, description, contract address, etc.) and market data (price, ATH, exchange tickers, etc.) of a coin from the CoinGecko coin page based on a particular coin ID
`get_coins_market_data`	CoinGecko	Query all the supported coins with price, market cap, volume and market related data
`get_coin_history`	CoinGecko	Query the historical data (price, market cap, 24hrs volume, .) at a given date for a coin based on a particular coin ID
`get_coin_market_chart_range`	CoinGecko	Get the historical chart data of a coin within certain time range in UNIX along with price, market cap and 24hr volume based on particular coin ID
`get_price`	CoinGecko	Query the prices of one or more coins by using their unique Coin API IDs
`get_gainers_losers`	CoinGecko	Query the top 30 coins with largest price gain and loss by a specific time duration
`get_contract_coin`	CoinGecko	Query CoinGecko coin metadata and market data for a token contract on a supported asset platform.
`get_contract_market_chart`	CoinGecko	Query historical price, market cap, and volume for a token contract over a rolling day range.
`get_contract_market_chart_range`	CoinGecko	Get the historical chart data within certain time range in UNIX along with price, market cap and 24hr volume based on asset platform and particular token contract address
`get_token_price_by_contract`	CoinGecko	Query one or more token prices using their token contract addresses
`get_global_stats`	CoinGecko	This endpoint allows you query cryptocurrency global data including active cryptocurrencies, markets, total crypto market cap and etc
`get_supported_currencies`	CoinGecko	Query all the supported currencies on CoinGecko
`get_token_price`	Codex	Get real-time or historical prices for a list of tokens
`get_price_chart`	DeFiLlama	Get price chart data for a token over a time range
`get_token_sparklines`	Codex	Get a list of token simple chart data (sparklines) for the given tokens
`get_token_chart_urls`	Codex	Chart images for token pairs
`get_coin_tickers`	CoinGecko	Query the coin tickers on both centralized exchange (CEX) and decentralized exchange (DEX) based on a particular coin ID
`get_coin_historical_chart`	CoinGecko	Get the historical chart data of a coin including time in UNIX, price, market cap and 24hr volume based on particular coin ID
`get_btc_exchange_rates`	CoinGecko	Query BTC exchange rates with other currencies
`get_global_market_cap_chart`	CoinGecko	Query global market cap chart data
`get_coin_ohlc`	CoinGecko	Query OHLC candle data for a CoinGecko coin ID in a target currency and day range.
`get_stablecoins`	DeFiLlama	Get all stablecoins with their market cap and chain distribution
`get_stablecoin_chains`	DeFiLlama	Get list of all chains with stablecoin data and their TVL.
`get_stablecoin_charts_global`	DeFiLlama	Get historical chart data for all stablecoins showing market cap over time
`get_stablecoin_charts_by_chain`	DeFiLlama	Get historical chart data for stablecoins on a specific blockchain
`get_stablecoin_prices`	DeFiLlama	Get current prices of stablecoins
`stablecoin_data_by_id`	DeFiLlama	Get stablecoin data (DISABLED for MCP: 14MB response causes timeouts)
`get_current_prices`	DeFiLlama	Get current token prices from DeFiLlama
`get_historical_prices`	DeFiLlama	Get historical token prices at a specific timestamp from DeFiLlama
`get_batch_historical_prices`	DeFiLlama	Get historical prices for multiple tokens at multiple timestamps in a single request
`get_price_percentage_change`	DeFiLlama	Get percentage price change for tokens over specified time periods
`get_first_prices`	DeFiLlama	Get the earliest recorded price for tokens
`get_ticker`	CCXT	Fetch ticker data (price, volume, etc.) for a specific trading pair
`get_tickers`	CCXT	Fetch ticker data for multiple trading pairs
`get_orderbook`	CCXT	Fetch order book (bids and asks) for a trading pair
`get_recent_trades`	CCXT	Fetch recent trades for a trading pair
`get_ohlcv`	CCXT	Fetch OHLCV (candlestick) data for a trading pair
`get_best_bid_ask`	CCXT	Fetch best bid/ask prices for multiple trading pairs
`get_l2_orderbook`	CCXT	Fetch level 2 (aggregated) order book for faster performance
`get_index_ohlcv`	CCXT	Fetch index price OHLCV data for derivatives
`get_mark_ohlcv`	CCXT	Fetch mark price OHLCV data for derivatives
`get_premium_index_ohlcv`	CCXT	Fetch premium index OHLCV data for perpetual contracts
`get_funding_rate`	CCXT	Fetch current funding rate for a perpetual futures contract
`get_funding_rate_history`	CCXT	Fetch funding rate history for perpetual futures contracts
`get_funding_rates`	CCXT	Fetch funding rates for multiple or all perpetual futures contracts
`get_trading_fees`	CCXT	Fetch trading fee structure (maker/taker fees) for an exchange
`get_open_interest`	CCXT	Fetch current open interest for a derivatives contract
`get_open_interest_history`	CCXT	Fetch historical open interest data for a derivatives contract
`get_long_short_ratio`	CCXT	Fetch long/short ratio for a derivatives contract (market sentiment)
`get_liquidations`	CCXT	Fetch recent liquidation events for a derivatives contract
`get_borrow_rates`	CCXT	Fetch cross-margin borrow rates for all currencies on an exchange
`get_stablecoin_dominance`	DeFiLlama	Get stablecoin dominance metrics showing market share and distribution across chains and stablecoin types.
`get_leverage_tiers`	CCXT	Fetch leverage tier information for trading pairs showing max leverage, maintenance margin rates, and notional value brackets
`get_exchanges`	CoinGecko	Query all the supported exchanges with exchanges' data (ID, name, country, .) that have active trading volumes on CoinGecko
`get_exchange`	CoinGecko	Query exchange's data (name, year established, country, .), exchange volume in BTC and top 100 tickers based on exchange's ID
`get_exchange_tickers`	CoinGecko	Query exchange's tickers based on exchange's ID
`get_exchange_volume_chart`	CoinGecko	Query the historical volume chart data with time in UNIX and trading volume data in BTC based on exchange's ID
`get_exchange_volume_chart_range`	CoinGecko	Query the historical volume chart data within a specific time range with time in UNIX and trading volume data in BTC based on exchange's ID
`get_derivatives_tickers`	CoinGecko	Query all the tickers from derivatives exchanges on CoinGecko
`get_derivatives_exchanges`	CoinGecko	Query all the derivatives exchanges with related data (ID, name, open interest, .) on CoinGecko
`get_derivatives_exchange`	CoinGecko	Query the derivatives exchange's related data (ID, name, open interest, .) based on the exchanges' ID
`filter_exchanges`	Codex	Get a list of exchanges based on various filters like volume, transactions, active users, etc.
`get_options_overview`	DeFiLlama	Get options trading overview data across all chains and protocols with historical charts
`get_options_by_chain`	DeFiLlama	Get options trading data for a specific blockchain
`get_options_protocol`	DeFiLlama	Get detailed summary for a specific options trading protocol
`get_exchange_markets`	CCXT	Fetch all available markets/trading pairs from an exchange
`get_exchange_currencies`	CCXT	Fetch all available currencies from an exchange

Example response shapes

Values below are illustrative response shapes, not live market data. Run the request against the live runtime for current prices, addresses, IDs, timestamps, and volumes.

get_price

Request:

json

{"tool": "get_price", "args": {"ids": "bitcoin,ethereum", "vs_currencies": "usd"}}

Example response shape:

json

{
  "bitcoin": {
    "usd": 84521.0,
    "usd_24h_change": 2.5,
    "usd_24h_vol": 32000000000,
    "usd_market_cap": 1650000000000
  },
  "ethereum": {
    "usd": 3412.18,
    "usd_24h_change": -1.2,
    "usd_24h_vol": 18000000000,
    "usd_market_cap": 410000000000
  }
}

get_gainers_losers

Example response shape:

json

{
  "top_gainers": [
    {
      "id": "dogecoin",
      "symbol": "doge",
      "name": "Dogecoin",
      "current_price": 0.25,
      "price_change_percentage_24h": 25.0,
      "market_cap": 35000000000
    }
  ],
  "top_losers": [...]
}

Discovery

Use these discovery surfaces when you need the current live catalog:

GET https://mcp.hiveintelligence.xyz/api/v1/tools
resources/read hive://tools
get_api_endpoint_schema on the root /mcp endpoint