One contract,
every endpoint.
REST and gRPC. Authentication, query, manifest export, webhooks, forensics — a stable v1 contract with semantic versioning. Pick an endpoint on the right and send a request to see the exact request/response shape.
A probabilistic forecast for an entity, optionally with the full audit manifest.
{
"entity": "actor:84a2",
"depth": 6,
"include_manifest": true,
"axes": ["credit_risk", "reputational"]
}{
"query_id": "q_8c4d2a1f",
"forecast": {
"distribution": [0.62, 0.28, 0.10],
"confidence": 0.87,
"axes_resolved": { "credit_risk": 0.42 }
},
"manifest": { "signature": "0x7a3f…c41" }
}Live explorer · pick an endpoint, press Send, read the response.
One bearer token.
Every request carries an Authorization header. Get your key at deino.ai/pricing — free tier, no card.
$ curl https://api.deino.ai/v1/oracle/query \ -H "Authorization: Bearer dno_live_…" \ -H "Content-Type: application/json" \ -d '{"entity":"actor:84a2","include_manifest":true}'
Predictable by design.
The boring guarantees that make an API safe to build a business on — versioning, idempotency, signed webhooks, honest deprecation.
Versioning
Major versions in the URL (/v1/). Breaking changes only across majors; deprecations announced 12 months ahead.
Rate limits
Free: 100/mo. Pro: 10K/mo. Enterprise: unlimited. 429 responses carry a Retry-After header.
Errors
HTTP status + structured JSON. Every error carries code, message, and request_id for support.
Idempotency
POST endpoints accept an Idempotency-Key. Same key within 24h returns the cached response.
Pagination
Cursor-based. next_cursor in the response; pass it via ?cursor=. Default 50, max 200.
Webhooks
Signed with HMAC-SHA256. Verify X-Deino-Signature before processing. 5 retries, exponential backoff.
Common questions.
What the API covers, how to authenticate, and the guarantees you can build a business on.
What does the DEINO API do?
It exposes DEINO over REST and gRPC: authenticate, run an Oracle query, export the audit manifest, subscribe to Drift Alerts, traverse Path Queries, and reproduce a past forecast via Forensics. It is a stable v1 contract with semantic versioning.
How do I authenticate?
Every request carries an Authorization: Bearer header with your API key. Get a key from deino.ai/pricing on the free tier — no card required.
How are breaking changes handled?
Major versions live in the URL (for example /v1/). Breaking changes only happen across major versions, and deprecations are announced 12 months ahead. Errors return an HTTP status plus structured JSON carrying code, message, and request_id.
How are webhooks secured?
Webhooks are signed with HMAC-SHA256. Verify the X-Deino-Signature header before processing. Delivery retries up to 5 times with exponential backoff.
API support on every tier.
Free: Discord community. Pro: 24h email. Enterprise: dedicated Slack + 4h SLA, with founder-led escalation for production incidents.