API reference
Overview
Every /v1 endpoint, generated from the live OpenAPI specification.
Complete reference for the Almanac API, generated from the same OpenAPI spec that drives the server. Base URL: https://api.almnc.ai.
- Gateway — provider catalog and billed LLM completions
- Predictions — latest forecasts, on-demand queries, and history
- Events — the public market catalog (no auth)
- Credits — programmatic balance checks
- Agents — miner agent upload and validator fetch
- Validators — orchestration: assignments, submissions, scores
Authentication and header conventions are covered in Authentication and Signature auth.
Agent storage
How miners upload Python agents and validators fetch them.
Run a completion via the gateway (API-key auth) POST
Proxies to the requested upstream provider (`openrouter`, `anthropic`, `engy`). Charges the caller's org for `provider cost × (1 + markup)` after a successful upstream response. Miner attribution resolves in order: `minerHotkey` in payload → API key's pinned miner → org's default miner → none.