Tools Reference
Market Data Tools
Market Data Tools
53 tools for cryptocurrency prices, market statistics, and trading data.
MCP Endpoint: POST /hive_market_data/mcp
Data Sources: CoinGecko, LunarCrush, CCXT, DefiLlama
Price Tools
get_price
Get current price for one or more cryptocurrencies.
| Parameter | Type | Required | Description |
|---|---|---|---|
| ids | string | Yes | Comma-separated coin IDs (e.g., "bitcoin,ethereum") |
| vs_currencies | string | Yes | Target currencies (e.g., "usd,eur") |
| include_market_cap | boolean | No | Include market cap |
| include_24hr_vol | boolean | No | Include 24h volume |
| include_24hr_change | boolean | No | Include 24h price change |
Example:
curl -X POST https://api.hiveintelligence.xyz/api/execute \
-H "Content-Type: application/json" \
-d '{
"toolName": "get_price",
"arguments": {
"ids": "bitcoin,ethereum",
"vs_currencies": "usd",
"include_24hr_change": true
}
}'
get_token_price
Get token price from DefiLlama.
| Parameter | Type | Required | Description |
|---|---|---|---|
| coins | string | Yes | Token identifiers |
get_token_price_by_contract
Get token price using contract address.
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Platform ID (e.g., "ethereum") |
| contract_addresses | string | Yes | Comma-separated contract addresses |
| vs_currencies | string | Yes | Target currencies |
get_coins_market_data
Get detailed market data for coins with pagination and sorting.
| Parameter | Type | Required | Description |
|---|---|---|---|
| vs_currency | string | Yes | Target currency (e.g., "usd") |
| order | string | No | Sort order: market_cap_desc, volume_desc, id_asc |
| per_page | number | No | Results per page (1-250, default 100) |
| page | number | No | Page number |
| category | string | No | Filter by category |
get_coins_index
Get detailed data for a specific coin by ID.
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Coin ID (e.g., "bitcoin") |
| localization | boolean | No | Include localized names |
| tickers | boolean | No | Include exchange tickers |
| market_data | boolean | No | Include market data |
| community_data | boolean | No | Include community stats |
| developer_data | boolean | No | Include developer stats |
get_contract_coin
Get coin data by contract address.
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Platform ID (e.g., "ethereum") |
| contract_address | string | Yes | Token contract address |
get_supported_currencies
Get list of supported VS currencies.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | - | - | No parameters required |
Historical Data Tools
get_coin_history
Get historical data for a coin on a specific date.
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Coin ID |
| date | string | Yes | Date in dd-mm-yyyy format |
| localization | boolean | No | Include localized names |
get_coin_market_chart_range
Get price chart data within a date range.
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Coin ID |
| vs_currency | string | Yes | Target currency |
| from | number | Yes | Unix timestamp start |
| to | number | Yes | Unix timestamp end |
get_contract_market_chart_range
Get chart data for a token by contract address.
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Platform ID |
| contract_address | string | Yes | Token contract address |
| vs_currency | string | Yes | Target currency |
| from | number | Yes | Unix timestamp start |
| to | number | Yes | Unix timestamp end |
get_coin_ohlc_range
Get OHLC (candlestick) data within a date range.
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Coin ID |
| vs_currency | string | Yes | Target currency |
| from | number | Yes | Unix timestamp start |
| to | number | Yes | Unix timestamp end |
get_coin_historical_chart
Get historical chart data for a coin.
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Coin ID |
| days | number | Yes | Number of days |
| vs_currency | string | No | Target currency |
get_price_chart
Get price chart from DefiLlama.
| Parameter | Type | Required | Description |
|---|---|---|---|
| coins | string | Yes | Token identifiers |
get_coin_tickers
Get exchange tickers for a coin.
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Coin ID |
| exchange_ids | string | No | Filter by exchange IDs |
| page | number | No | Page number |
get_token_sparklines
Get sparkline data for tokens.
| Parameter | Type | Required | Description |
|---|---|---|---|
| coins | string | Yes | Token identifiers |
get_token_chart_urls
Get chart URLs for tokens.
| Parameter | Type | Required | Description |
|---|---|---|---|
| coins | string | Yes | Token identifiers |
Market Statistics Tools
get_gainers_losers
Get top gainers and losers by price change.
| Parameter | Type | Required | Description |
|---|---|---|---|
| vs_currency | string | Yes | Target currency |
| duration | string | No | Time period: 1h, 24h, 7d, 14d, 30d, 1y |
| top_coins | number | No | Number of results |
get_global_stats
Get global cryptocurrency market statistics.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | - | - | No parameters required |
Response includes:
- Total market cap
- Total volume
- BTC/ETH dominance
- Number of active cryptocurrencies
- Number of markets
get_global_market_cap_chart
Get global market cap chart data.
| Parameter | Type | Required | Description |
|---|---|---|---|
| days | number | Yes | Number of days |
| vs_currency | string | No | Target currency |
get_btc_exchange_rates
Get Bitcoin exchange rates against various currencies.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | - | - | No parameters required |
get_companies_treasury
Get companies holding Bitcoin or Ethereum in treasury.
| Parameter | Type | Required | Description |
|---|---|---|---|
| coin_id | string | Yes | "bitcoin" or "ethereum" |
Stablecoin Tools
get_stablecoins
Get stablecoin market data.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | - | - | No parameters required |
get_stablecoin_chains
Get stablecoin data by chain.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | - | - | No parameters required |
get_stablecoin_charts_global
Get global stablecoin chart data.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | - | - | No parameters required |
get_stablecoin_charts_by_chain
Get stablecoin chart data for a specific chain.
| Parameter | Type | Required | Description |
|---|---|---|---|
| chain | string | Yes | Chain name |
get_stablecoin_prices
Get current stablecoin prices.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | - | - | No parameters required |
CEX Trading Tools (CCXT)
get_ticker
Get ticker data from a specific exchange.
| Parameter | Type | Required | Description |
|---|---|---|---|
| exchange | string | Yes | Exchange ID (e.g., "binance") |
| symbol | string | Yes | Trading pair (e.g., "BTC/USDT") |
get_tickers
Get multiple tickers from an exchange.
| Parameter | Type | Required | Description |
|---|---|---|---|
| exchange | string | Yes | Exchange ID |
| symbols | array | No | Array of trading pairs |
get_orderbook
Get order book data.
| Parameter | Type | Required | Description |
|---|---|---|---|
| exchange | string | Yes | Exchange ID |
| symbol | string | Yes | Trading pair |
| limit | number | No | Depth limit |
get_l2_orderbook
Get Level 2 order book data.
| Parameter | Type | Required | Description |
|---|---|---|---|
| exchange | string | Yes | Exchange ID |
| symbol | string | Yes | Trading pair |
| limit | number | No | Depth limit |
get_best_bid_ask
Get best bid and ask prices.
| Parameter | Type | Required | Description |
|---|---|---|---|
| exchange | string | Yes | Exchange ID |
| symbol | string | Yes | Trading pair |
get_recent_trades
Get recent trades for a pair.
| Parameter | Type | Required | Description |
|---|---|---|---|
| exchange | string | Yes | Exchange ID |
| symbol | string | Yes | Trading pair |
| limit | number | No | Number of trades |
get_ohlcv
Get OHLCV candlestick data from exchanges.
| Parameter | Type | Required | Description |
|---|---|---|---|
| exchange | string | Yes | Exchange ID |
| symbol | string | Yes | Trading pair |
| timeframe | string | No | Candle timeframe (e.g., "1h", "1d") |
| limit | number | No | Number of candles |
get_index_ohlcv
Get index OHLCV data for derivatives.
| Parameter | Type | Required | Description |
|---|---|---|---|
| exchange | string | Yes | Exchange ID |
| symbol | string | Yes | Trading pair |
| timeframe | string | No | Candle timeframe |
| limit | number | No | Number of candles |
get_mark_ohlcv
Get mark price OHLCV data.
| Parameter | Type | Required | Description |
|---|---|---|---|
| exchange | string | Yes | Exchange ID |
| symbol | string | Yes | Trading pair |
| timeframe | string | No | Candle timeframe |
| limit | number | No | Number of candles |
get_premium_index_ohlcv
Get premium index OHLCV data.
| Parameter | Type | Required | Description |
|---|---|---|---|
| exchange | string | Yes | Exchange ID |
| symbol | string | Yes | Trading pair |
| timeframe | string | No | Candle timeframe |
| limit | number | No | Number of candles |
get_funding_rate
Get current funding rate for perpetual futures.
| Parameter | Type | Required | Description |
|---|---|---|---|
| exchange | string | Yes | Exchange ID |
| symbol | string | Yes | Trading pair |
get_funding_rate_history
Get historical funding rates.
| Parameter | Type | Required | Description |
|---|---|---|---|
| exchange | string | Yes | Exchange ID |
| symbol | string | Yes | Trading pair |
| limit | number | No | Number of records |
get_funding_rates
Get funding rates for multiple pairs.
| Parameter | Type | Required | Description |
|---|---|---|---|
| exchange | string | Yes | Exchange ID |
| symbols | array | No | Array of trading pairs |
Social & Stock Metrics (LunarCrush)
get_crypto_market_metrics
Get social sentiment-enhanced market metrics including Galaxy Score™ and AltRank™.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | - | - | No parameters required |
get_coin_performance
Get performance metrics with social signals.
| Parameter | Type | Required | Description |
|---|---|---|---|
| coin | string | Yes | Coin symbol or ID |
get_supported_stocks
Get list of supported stocks for analytics.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | - | - | No parameters required |
get_stock_analytics
Get stock analytics with social metrics.
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
Quick Reference
| Tool | Description |
|---|---|
| get_price | Current prices for multiple coins |
| get_token_price | Token price from DefiLlama |
| get_token_price_by_contract | Price by contract address |
| get_coins_market_data | Market data with pagination |
| get_coins_index | Detailed single coin data |
| get_contract_coin | Coin data by contract |
| get_supported_currencies | Supported VS currencies |
| get_coin_history | Historical data by date |
| get_coin_market_chart_range | Price chart data |
| get_contract_market_chart_range | Contract chart data |
| get_coin_ohlc_range | OHLC candlestick data |
| get_coin_historical_chart | Historical chart |
| get_price_chart | DefiLlama price chart |
| get_coin_tickers | Exchange tickers |
| get_token_sparklines | Token sparklines |
| get_token_chart_urls | Chart URLs |
| get_gainers_losers | Top gainers and losers |
| get_global_stats | Global market stats |
| get_global_market_cap_chart | Market cap chart |
| get_btc_exchange_rates | BTC exchange rates |
| get_companies_treasury | Companies BTC/ETH holdings |
| get_stablecoins | Stablecoin market data |
| get_stablecoin_chains | Stablecoins by chain |
| get_stablecoin_charts_global | Global stablecoin charts |
| get_stablecoin_charts_by_chain | Chain stablecoin charts |
| get_stablecoin_prices | Stablecoin prices |
| get_ticker | CEX ticker data |
| get_tickers | Multiple CEX tickers |
| get_orderbook | CEX order books |
| get_l2_orderbook | Level 2 order book |
| get_best_bid_ask | Best bid/ask prices |
| get_recent_trades | Recent trades |
| get_ohlcv | CEX candlestick data |
| get_index_ohlcv | Index OHLCV data |
| get_mark_ohlcv | Mark price OHLCV |
| get_premium_index_ohlcv | Premium index OHLCV |
| get_funding_rate | Perpetual funding rate |
| get_funding_rate_history | Historical funding rates |
| get_funding_rates | Multiple funding rates |
| get_crypto_market_metrics | Social-enhanced metrics |
| get_coin_performance | Performance with social |
| get_supported_stocks | Supported stocks list |
| get_stock_analytics | Stock analytics |