Integrate Sovereign Intelligence

Independent Developer API Portal

Expose the full computational power of the Aristotelian Deliberation Council directly within your personal dApps, quant trading bots, and analytical dashboards. Run high-fidelity concurrent AI consensus sequences on-chain in under 400ms.

1.System Overview

The Oracle of Agora exposes a standardized developer route to request dynamic decision matrix evaluations for any crypto trend or narrative. The core engine fires parallel LLM requests, evaluates consensus thresholds, commits deliberations to the local sqlite ledger index, and processes spot transaction recommendations in real-time.

Sub-Second Execution

Leverages concurrent process execution threads allowing external systems to extract consensus output in a fraction of a second.

Sovereign Proof Matrix

Every developer query automatically generates simulated settlement indicators (USDC gas, USYC yields) logged to the shared dashboard ledger.

2.Telemetry Credentials & Authentication

All external API operations must declare authorization credentials inside the HTTP transaction headers. Requests missing authentication parameters or presenting invalid keys will be rejected immediately with an HTTP 401 response.

Required Header Parameters

X-Oracle-API-KeyYour private developer integration key. Default: oracle-dev-key-2026

Content-Typeapplication/json

SECURITY PRECAUTION: Never store or transmit your API keys on the client-side of web interfaces (such as static JS files or direct client-side fetch statements). Always wrap queries securely inside your own server-side environment.

3.Endpoint: /api/v1/deliberate

POST/api/v1/deliberate

Submits a topic vector for collective risk analysis. The council returns the full tripartite reasoning payload along with verdict parameters.

Request Payload Schema

{
  "topic": "Arbitrum spot volume surge" // string, required
}

Response Payload Schema (HTTP 200 OK)

{
  "status": "success",
  "topic": "Arbitrum spot volume surge",
  "verdict": "BUY", // BUY | SELL | HOLD
  "confidence_score": 0.84, // float (0.0 to 1.0)
  "skeptic_analysis": "Crucial risk vulnerabilities analyzed...", // string
  "opportunist_analysis": "Premium alpha potential located...", // string
  "strategist_analysis": "Optimal target limit route set...", // string
  "tx_hash": "0x573bacc4ad414d688f5bfd5585c414ec", // string (transaction hash)
  "usyc_yield_earned": 9.80, // float (yield metric)
  "timestamp": "2026-05-24T13:42:33.969978" // string (ISO timestamp)
}

4.Execution Code Playbook

Select your target programming language tab below to copy production-ready code loops directly into your software projects.

curl -X POST http://localhost:8000/api/v1/deliberate \
  -H "Content-Type: application/json" \
  -H "X-Oracle-API-Key: oracle-dev-key-2026" \
  -d '{"topic": "Arbitrum spot volume surge"}'

5.Telemetric Status Code Matrix

The core server utilizes traditional HTTP response codes to denote the telemetric outcome of external operations:

HTTP Code	Core Status	System Rationale Description
200 OK	SUCCESS	The deliberation processed successfully. Tripartite analyses and verdict are returned.
400 Bad Request	BAD PAYLOAD	The request payload was invalid or the topic parameter was missing or empty.
401 Unauthorized	ACCESS DENIED	The X-Oracle-API-Key was missing, unreadable, or did not match the secure environment signature.
500 Server Error	INTERNAL FAILURE	The backend encountered a critical error communicating with Gemini, accessing database layers, or writing consensus results.