API Reference
Quick reference
Every public Orakle endpoint on one screen.
Base URL: https://api.orakle.xyz. Auth header: X-Orakle-API-Key.
Endpoints
| Method | Path | Auth | Purpose |
|---|---|---|---|
POST | /v1/jobs | Yes | Submit a pricing job. Returns 202 with job_id, poll_url, stream_url. |
GET | /v1/jobs/{id} | Yes | Read job status and result. 404 if not found or not yours. |
GET | /v1/jobs/{id}/stream | Yes | SSE stream of progress and the final result. |
GET | /v1/health | No | Service health: { "status": "healthy", "version": "..." }. |
GET | /.well-known/oauth-protected-resource | No | RFC 9728 metadata for MCP OAuth. |
There is no public OpenAPI document. Details: Jobs, Streaming, Events, Errors.