Products
Living MapDrift AlertsBacktest ForensicsPath QueriesCustom AxesRisk Maps
Solutions
Compliance OfficersRisk Managers / CROPortfolio ManagersCTOs & Engineering
Developers
DocumentationAPI ReferenceSDKsArchitectureAudit Manifest
Resources
BlogUse CasesCustomer StoriesPressChangelog
Company
AboutFoundersCareersContact
More
PricingTrustEnterprise
API Referencev1 · stable

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.

v1Stable contract
REST·gRPCProtocols
HMACSigned webhooks
12moDeprecation notice
api · v1 · explorerbearer dno_live_…
POST/v1/oracle/query

A probabilistic forecast for an entity, optionally with the full audit manifest.

request
{
  "entity": "actor:84a2",
  "depth": 6,
  "include_manifest": true,
  "axes": ["credit_risk", "reputational"]
}
response 200 OK
{
  "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.

§ 01Authentication

One bearer token.

Every request carries an Authorization header. Get your key at deino.ai/pricing — free tier, no card.

auth.sh
$ 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}'
§ 02Conventions

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.

§ Final

API support on every tier.

Free: Discord community. Pro: 24h email. Enterprise: dedicated Slack + 4h SLA, with founder-led escalation for production incidents.