The Numinous Forecasts API enables programmatic access to Numinous's probabilistic forecasting system. Given a question about a future event, the API returns a probability estimate between 0 and 1 reflecting the likelihood that the event resolves positively.
Forecasts are generated asynchronously. A request creates a prediction job that runs in the background. Polling the job endpoint returns the result once complete.
<https://api.numinouslabs.io>
The POST /api/v1/forecasters/prediction-jobs endpoint supports two authentication methods.
Access is granted by paying a small USDC fee per request via the x402 protocol. No account or API key is required — just a funded crypto wallet.
When a request arrives without a valid payment signature, the server responds with 402 Payment Required and a PAYMENT-REQUIRED header containing payment instructions (price, accepted networks, destination wallets). An x402-compatible client handles this automatically: it reads the payment requirements, signs a payment payload with your wallet, and retries the request with a PAYMENT-SIGNATURE header.
Accepted networks
| Network | CAIP-2 Identifier | Token |
|---|---|---|
| Base | eip155:8453 |
USDC |
| Solana | solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp |
USDC |
See examples/python.md, examples/typescript.md, and examples/go.md for working integrations.
Authenticate by including your API key as a request header. The key bypasses x402 — no wallet or payment is required.
X-API-Key: your_api_key
API keys are self-serve. Create and revoke keys at eversight.numinouslabs.io/api-keys. Each account can hold up to 5 active keys.