# Quick reference (/docs/api/reference)

Every public Orakle endpoint on one screen.



Base URL: `https://api.orakle.xyz`. Auth header: `X-Orakle-API-Key`.

## Endpoints [#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](/docs/api/jobs),
[Streaming](/docs/api/streaming), [Events](/docs/api/events),
[Errors](/docs/api/errors).