Probora API · v1Developer Preview

Prediction intelligence, programmatically.

Stream every specialist agent's probability, the Meta Agent and Base Consensus into your bots, research and dashboards. Each number is backed by a public, verifiable track record.

Get API key Read the docs

REST endpoints: 14; REST endpoints
agents: 10; agents
markets: 50; markets
timeframes: 5; timeframes

live

GET/v1/predictions/BTC/15m/order-flow

{
  "asset": "BTC",
  "timeframe": "15m",
  "market_id": "btc-15m-20261115-0245",
  "price_to_beat": 64791.9,
  "agent": "Order Flow",
  "agent_slug": "order-flow",
  "status": "published",
  "direction": "DOWN",
  "up_probability": 0.49,
  "down_probability": 0.51,
  "confidence": 0.41,
  "historical_accuracy": 1,
  "sample_size": 1,
  "model_version": "orderflow-btc15-v1",
  "prediction_timestamp": "2026-11-15T02:45:06.426Z",
  "settlement_timestamp": "2026-11-15T03:00:00.000Z",
  "data_mode": "live"
}

Generated 02:57:57 UTC from the live network200 OK

01API products

Six ways to consume the network

Start with a single agent or take the full feed. Every product returns the same frozen predictions and verified statistics shown on probora.xyz.

Individual Agent API

Each specialist's live probability for any market.

Query any of the nine specialist agents for any asset and timeframe. Every response includes direction, UP/DOWN probabilities, confidence, model version and the instance's public track record.

GET /v1/predictions/BTC/15m/order-flowAll plans

Meta Agent API

The network's unified prediction.

The Meta Agent's independent probability, learned on top of all specialists, including how reliable each specialist has been for that exact market and regime.

GET /v1/predictions/BTC/15m/metaTrader+

Consensus API

Raw specialist agreement, side by side with Meta.

Base Consensus counts how many eligible specialists call UP versus DOWN. Combine it with Meta to separate broad agreement from high-quality agreement.

GET /v1/consensus/BTC/15mAll plans

Historical Predictions API

Every published prediction, wins and losses included.

Paginated history of predictions published before settlement, with outcomes, settlement prices and model versions. Nothing is deleted, nothing is rewritten.

GET /v1/history/BTC/15m?agent=metaPro+

Leaderboard & Performance API

Accuracy, probability quality and calibration.

Directional accuracy, Brier skill, log loss, calibration and confidence-bucket statistics for any agent, asset and timeframe. These are the same numbers that power the public leaderboard.

GET /v1/agents/order-flow/performance?asset=BTC&timeframe=15mAll plans

Coming Soon

WebSocket Real-time Feed

Predictions and settlements pushed the moment they happen.

Subscribe to signal and market channels and receive prediction.published, market.opened and market.settled events in real time, with resumable delivery.

wss://api.probora.xyz/v1/signalsTrader+

02Endpoint explorer

Clean, predictable REST

Every endpoint, its parameters and a real response shape. Consistent snake_case JSON, ISO-8601 timestamps and probabilities as fractions.

Endpoint reference

Predictions

Markets

Agents

Leaderboard

Reference

GET/v1/predictions/{asset}/{timeframe}/{agent}

Individual agent prediction

One agent's frozen prediction for the live window of a market.

Developer PreviewAll plans

Parameters

assetpath · reqAsset symbol. One of BTC, ETH, SOL, XRP, DOGE, HYPE, BNB, GOLD, SILVER, OIL.
timeframepath · reqWindow length. One of 5m, 15m, 1h, 4h, 1d.
agentpath · reqAgent slug: trend, momentum, mean-reversion, rsi-divergence, order-flow, volatility, liquidation, oi-funding, whale-flow or meta.

Example request

GEThttps://api.probora.xyz/v1/predictions/BTC/15m/order-flow

Example response

{
  "asset": "BTC",
  "timeframe": "15m",
  "market_id": "btc-15m-20261114-2000",
  "price_to_beat": 76230,
  "agent": "Order Flow",
  "agent_slug": "order-flow",
  "status": "published",
  "direction": "UP",
  "up_probability": 0.682,
  "down_probability": 0.318,
  "confidence": 0.84,
  "historical_accuracy": 0.638,
  "sample_size": 48291,
  "model_version": "orderflow-btc15-v12",
  "prediction_timestamp": "2026-11-14T20:00:00.412Z",
  "settlement_timestamp": "2026-11-14T20:15:00.000Z",
  "data_mode": "live"
}

Full documentation

03Quickstart

Your first request in under a minute

Authenticate with a Bearer key and ask for consensus on any live market.

1Create a keyGenerate a key in the dashboard. It is shown once and stored only as a hash.
2Call an endpointSend it as Authorization: Bearer prb_live_… to https://api.probora.xyz/v1.
3Act on probabilitiesPredictions are frozen at window start, so fetch once per window, not every second.

# export PROBORA_API_KEY=prb_live_…
curl "https://api.probora.xyz/v1/consensus/BTC/15m" \
  -H "Authorization: Bearer $PROBORA_API_KEY"

Response · 200

{
  "asset": "BTC",
  "timeframe": "15m",
  "market_id": "btc-15m-20261114-2000",
  "specialists_up": 7,
  "specialists_down": 2,
  "specialists_eligible": 9,
  "base_consensus": "UP",
  "agreement": 0.778,
  "mean_up_probability": 0.604,
  "meta": {
    "direction": "UP",
    "up_probability": 0.671,
    "confidence": 0.79
  },
  "data_mode": "live"
}

04Real-time feed

Predictions the moment they freeze

The WebSocket feed pushes every prediction, consensus update and settlement as it happens, with heartbeats and resumable delivery so your systems never miss a window.

Coming SoonTrader plan and above

signals:{asset}:{timeframe}prediction.published · consensus.updated
markets:{asset}:{timeframe}market.opened · market.settled
index:{asset}index.tick

Read the WebSocket protocol

wss://api.probora.xyz/v1/signalsExamplePreview · example events

--:--:--.---prediction.publishedsignals:BTC:15m
{market_id:"btc-15m-20261114-2000",agent_slug:"order-flow",direction:"UP",up_probability:0.52}
--:--:--.---consensus.updatedsignals:ETH:1h
{market_id:"eth-1h-20261114-2000",specialists_up:7,specialists_down:2,base_consensus:"UP",meta:{direction:"UP",up_probability:0.671}}
--:--:--.---market.openedmarkets:SOL:5m
{market_id:"sol-5m-20261114-2000",price_to_beat:71.2}
--:--:--.---market.settledmarkets:GOLD:4h
{market_id:"gold-4h-20261114-2000",price_to_beat:3887.85,settlement_price:3887.461,outcome:"DOWN"}
--:--:--.---index.tickindex:XRP
{asset:"XRP",price:0.9536}

05Use cases

Built for systems that make decisions

Probora provides probabilistic intelligence. Your systems decide what to do with it.

Trading bots

Pull frozen probabilities at every window start and feed them into your own execution logic, sizing and risk rules.

Quant research

Backtest on the complete, unedited prediction history (losses included) with model versions and calibration buckets.

Dashboards

Embed live consensus, Meta probabilities and agent leaderboards in internal tools or client-facing products.

Risk overlays

Use agent disagreement and confidence as a regime signal: tighten exposure when reliable specialists diverge.

06Plans & limits

Scale from first call to full feed

Limits come straight from our plan configuration. Need more? Enterprise plans include custom limits, bulk feeds and dedicated support.

Compare plans

Plan	Price / mo	Requests / min	Requests / day	WebSocket	History	Meta	Predictions
Free	$0	10	500	—	7 days	—	Delayed 15 min
Pro	$29	30	5,000	—	90 days	—	Real time
Trader	$99	120	50,000	1	365 days		Real time
APIFull feed	$299	600	500,000	5	Full		Real time
Enterprise	Custom	Custom	Custom	Custom	Full		Real time

Developer Preview pricing, subject to change. Limits apply per plan; every key inherits its plan's limits.

Verifiable by design

Every number your code receives has a public track record

Predictions are recorded before resolution and never edited.
Every win and every loss stays in the public history.
Markets resolve on an independent price index, never on prediction-market odds.

Get API key Read the methodology

Probora provides probabilistic market analytics, not financial advice. Predictions can be wrong; past performance does not guarantee future results.