API Integration Documentation

Overview

Hive Intelligence provides a comprehensive API for integrating blockchain intelligence into your applications.

API Details

• Base URL: https://api.hiveintelligence.xyz
• Authentication: Bearer token required
• Rate Limits: 20 requests per minute
• Free Tier: 10 API calls/day with development key

Quickstart Examples

cURL

curl -X POST https://api.hiveintelligence.xyz/v1/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"prompt": "How much $HINT do I hold in my wallet 0x...?"}'

Python

import requests

API_URL = "https://api.hiveintelligence.xyz/v1/search"
API_KEY = "your_api_key_here"

def fetch_hive_results(query):
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    payload = {
        "prompt": query,
        "temperature": 0.5,
        "include_data_sources": True
    }    

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

    if response.status_code == 200:
        return response.json()
    else:
        return {"error": f"API request failed with status code {response.status_code}"}

JavaScript

const API_URL = "https://api.hiveintelligence.xyz/v1/search";
const API_KEY = "your_api_key_here";

async function fetchHiveResults(prompt) {
    const response = await fetch(API_URL, {
        method: "POST",
        headers: {
            "Authorization": `Bearer ${API_KEY}`,
            "Content-Type": "application/json"
        },
        body: JSON.stringify({ prompt })
    });

    if (!response.ok) {
        return { error: `API request failed with status code ${response.status}` };
    }

    return response.json();
}

API Endpoint

/v1/search

• Method: POST
• Purpose: Execute Web3/Blockchain search queries
• Parameters:
  • prompt (string, required): Natural language search query
  • temperature (number, optional): Controls response randomness (0.0-1.0)
  • top_p (number, optional): Controls response diversity
  • top_k (number, optional): Limits token selection for response generation
  • include_data_sources (boolean, optional): Include data source information in response

Credit Consumption

• Basic Queries: 5-25 credits
• Medium Complexity: 25-50 credits
• Advanced Queries: 50-100 credits

MCP Integration

For AI agent integration, connect to the MCP server at:

• Remote Endpoint: https://hiveintelligence.xyz/mcp

No local installation required - simply add the connector URL to your AI client settings.