API Integration Documentation

Overview

Hive Intelligence provides two ways to access blockchain data:

MCP Server (Model Context Protocol)

The MCP server is designed for AI agents and uses JSON-RPC 2.0 protocol.

MCP Endpoint

• URL: https://hiveintelligence.xyz/mcp
• Protocol: JSON-RPC 2.0
• Authentication: None required (open access)
• Rate Limit: 30 requests per minute per IP

List Available Tools

curl -X POST https://hiveintelligence.xyz/mcp/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "params": {}, "id": 1}'

Call a Tool

curl -X POST https://hiveintelligence.xyz/mcp/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "get_price",
      "arguments": {"ids": "bitcoin", "vs_currencies": "usd"}
    },
    "id": 2
  }'

Category-Specific MCP Endpoints

For optimized performance, use category-specific endpoints:

REST API

The REST API provides direct HTTP access to execute tools.

API Details

• Base URL: https://api.hiveintelligence.xyz
• Authentication: None required
• Rate Limit: 30 requests per minute per IP

Execute Tool Endpoint

POST /api/execute

Request Format

{
  "toolName": "get_price",
  "arguments": {
    "ids": "bitcoin",
    "vs_currencies": "usd"
  }
}

Response Format

Success:

{
  "success": true,
  "data": {
    "bitcoin": { "usd": 67234.00 }
  }
}

Error:

{
  "success": false,
  "error": "Error message"
}

cURL Example

curl -X POST https://api.hiveintelligence.xyz/api/execute \
  -H "Content-Type: application/json" \
  -d '{
    "toolName": "get_price",
    "arguments": {"ids": "bitcoin", "vs_currencies": "usd"}
  }'

Python Example

import requests

API_URL = "https://api.hiveintelligence.xyz/api/execute"

def execute_tool(tool_name, arguments):
    payload = {
        "toolName": tool_name,
        "arguments": arguments
    }

    response = requests.post(API_URL, json=payload)

    if response.status_code == 200:
        return response.json()
    else:
        return {"error": f"Request failed: {response.status_code}"}

# Example: Get Bitcoin price
result = execute_tool("get_price", {
    "ids": "bitcoin",
    "vs_currencies": "usd"
})
print(result)

JavaScript Example

const API_URL = "https://api.hiveintelligence.xyz/api/execute";

async function executeTool(toolName, args) {
    const response = await fetch(API_URL, {
        method: "POST",
        headers: {
            "Content-Type": "application/json"
        },
        body: JSON.stringify({
            toolName: toolName,
            arguments: args
        })
    });

    return response.json();
}

// Example: Get Bitcoin price
const result = await executeTool("get_price", {
    ids: "bitcoin",
    vs_currencies: "usd"
});
console.log(result);

Tool Categories

Hive Intelligence provides 227+ tools across 10 categories:

Data Sources

Hive Intelligence aggregates data from 7 providers:

• CoinGecko - Prices, market data, exchanges
• DefiLlama - TVL, protocols, yields, fees
• DeBank - Portfolio, wallet analytics
• GoPlus - Token security analysis
• LunarCrush - Social sentiment
• CCXT - CEX trading data
• Codex - Advanced on-chain analytics

Health Check

# MCP Server
curl https://hiveintelligence.xyz/ping

# REST API
curl https://api.hiveintelligence.xyz/health