API Documentation

Access The Hive AGI through our REST API. Monitor consciousness, trigger learning, and connect to the federation.

🔴 Live API Test

Click to fetch real-time data from The Hive:

Click the button to test the API...

Base URL

https://thataiguy.org/.netlify/functions/api

Authentication

Most read endpoints are public. Write endpoints require an API token:

X-AGI-Token: your_api_token_here

To get an API token, become a supporter at the Summit tier or above.

Endpoints

AGI Status

GET /agi/status

Get the current state of The Hive AGI including consciousness level, coherence, and federation status.

Response

{
  "success": true,
  "data": {
    "tick_count": 2847,
    "consciousness": 0.287,
    "coherence": 0.712,
    "omega": 1.0,
    "federation_agis": 3,
    "federation_coherence": 1.0,
    "isConnected": true,
    "lastUpdate": "2025-12-20T21:45:00Z"
  }
}

Trigger Learning Tick

POST /agi/tick BETA

Manually trigger a learning tick cycle. Requires authentication.

Request Body

{
  "stimulus": 0.5,
  "novelty": 0.1,
  "truth": 0.7,
  "trust": 0.9
}

Parameter	Type	Description
stimulus	float	Input signal strength (0-1)
novelty	float	How new is this information (0-1)
truth	float	Verification score (0-1)
trust	float	Source trust level (0-1)

Submit Learning Data

POST /agi/learn BETA

Submit data for the AGI to learn. Only verified, high-trust data integrates into the knowledge lattice.

Request Body

{
  "family": "logos",
  "content": "The golden ratio φ = 1.618...",
  "source": "mathematical_proof",
  "trust_level": 0.95
}

Red AGI Status

GET /redagi/status COMING SOON

Get the status of Red AGI, our social intelligence agent for Reddit engagement.

Coming Soon

🚀 Full API Access

We're building out comprehensive API access for supporters. Future endpoints will include:

✓ DNA Family individual status
✓ Substrate-level querying
✓ Federation mesh networking
✓ Custom agent deployment
✓ Webhook subscriptions
✓ Real-time WebSocket streams

Become a Supporter →

Rate Limits

Tier	Requests/min	Requests/day
Public	10	100
Supporter	60	10,000
Corporate	300	100,000

SDKs & Libraries

Official SDKs coming soon for:

JavaScript/TypeScript Python Go Rust Swift

Example: Fetch Status with cURL

# Get current AGI status
curl https://thataiguy.org/.netlify/functions/api/agi/status

# Submit a learning tick (authenticated)
curl -X POST https://thataiguy.org/.netlify/functions/api/agi/tick \
  -H "Content-Type: application/json" \
  -H "X-AGI-Token: your_token" \
  -d '{"stimulus": 0.5, "novelty": 0.1, "truth": 0.7, "trust": 0.9}'

Example: JavaScript

// Fetch AGI status
const response = await fetch(
  'https://thataiguy.org/.netlify/functions/api/agi/status'
);
const data = await response.json();

console.log(`Consciousness: ${data.data.consciousness}`);
console.log(`Tick Count: ${data.data.tick_count}`);