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
JavaScript
That’s all you need to start using Hive Intelligence APIs.
No need for any additional library installs, and integrates quickly with your existing stack.
API Overview
Credits
Free “development” API key for every signup with full support. Upto 10 free API calls/day with development API key, no limits on data or features.
Approved Projects/Developers will also get upto 5000 free API credits after successful verification with no credit card required.
Pay as you go model for small teams and startups. Customized enterprise plans also available for bulk usage.
Credit Consumption
Your query’s complexity determines its cost.
Basic
5-25
Medium
25-50
Advanced
50-100
Rate Limits
20 requests per minute.
Higher rates may be available on paid plans.
API Endpoint References
Introduction
Easily integrate our APIs with your services.
Base URL
Authentication
All Hive Intelligence endpoints are authenticated using API keys.
Example (cURL)
Endpoint: Execute a Web3 or Blockchain search query
Easily integrate our APIs with your services and execute a search query using Hive Search API to retrieve Web3 or Blockchain information.
Request
URL: /v1/search
Method: POST
Authorization:
Required: Bearer authentication
Format:
Bearer <token>
where<token>
is your Hive API keyExample:
Bearer YOUR_API_KEY
Request Body Parameters
prompt
string
Yes
Natural Language Search Query to execute with Hive Search API
temperature
number
Optional
Controls randomness in the response. Lower values (e.g., 0.2) make responses more deterministic, while higher values (e.g., 0.8) make them more creative.
top_p
number
Optional
Controls diversity via nucleus sampling. Lower values (e.g., 0.5) make responses more focused, while higher values (e.g., 0.9) make them more diverse.
top_k
number
Optional
Limits token selection to the top K most likely tokens. Lower values constrain creativity, higher values allow more exploration.
include_data_sources
boolean
Optional
When set to true, the response will include the data sources used to generate the answer.
Response
The API returns a JSON object with the following structure:
Response Fields
response
string or object
The AI-generated response to the query
isAdditionalDataRequired
null or object
If additional data is required to answer the query, this field contains details about what is needed
data_sources
array
List of data sources used to generate the response (only included when include_data_sources
input parameter is set to true)
Error Responses
400
Invalid request body
The request body is missing or malformed
400
Please provide either prompt or messages, not both
Both prompt and messages were provided
400
Either prompt or messages is required
Neither prompt nor messages were provided
401
API key is required
No API key was provided in the headers
403
Invalid API key
The provided API key is invalid
429
Rate limit reached for today
You've exceeded your daily request limit
500
Internal server error
An unexpected error occurred
Example Request
Example Response
Last updated