Integration Docs

Hive Intelligence API Docs

Quickstart

Use these simple examples to integrate Hive Intelligence Web3 search into your existing stack—no extra libraries needed.

Python

import requests

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

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

    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}"}

# Example usage
query_text = "What are the holdings in my wallet 0x… on BASE chain?"
results = fetch_hive_results(query_text)
print(results)

JavaScript

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

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

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

  return response.json();
}

// Example usage
const queryText = "What are the holdings in my wallet 0x… on BASE chain?";
fetchHiveResults(queryText)
  .then(results => console.log(results))
  .catch(error => console.error("Error:", error));

---

API Overview

Credits

• You receive 100 free API Credits each month upon signup (no credit card required).

• Purchase additional API Credits if you need more. Flexible plans available.

Credit Consumption

Your query’s complexity determines its cost.

Complexity	Credits Deducted
Basic	1
Medium	3
Advanced	5

Rate Limits

• 20 requests per minute.

• Higher rates may be available on paid plans.

---

API Endpoint References

Base URL

https://api.hiveintelligence.xyz

Authentication

All endpoints use Bearer tokens. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Example (cURL)

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

---

Endpoints

POST /search

Execute a Web3 or blockchain-specific search query.

Headers

• Authorization: Bearer YOUR_API_KEY (required)

Body Parameters

• query (string, required): The natural language query to execute.

Response

• results: JSON with relevant information and answers generated by Hive Intelligence’s LLM-enhanced algorithms.