Skip to content
PROBORA

Developer docs

Build on the Prediction Agent Network

Query every specialist agent, the Meta Agent and Base Consensus for crypto and commodity markets, with the verified track record behind each number.

v1Developer Preview
Base URLhttps://api.probora.xyz/v1

Start here

QuickstartBase URL, conventions and your first request in a minute.AuthenticationBearer keys, key format and security practices.Endpoint referenceEvery v1 endpoint with parameters and examples.WebSocket feedSoonPredictions and settlements pushed in real time.Rate limitsPer-plan limits, headers and backoff.MethodologyPrice index, settlement rules and scoring definitions.

Your first request

Create a key in the dashboard, export it as PROBORA_API_KEY, then ask for the live BTC 15-minute consensus:

# 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"
}

Popular endpoints

GET/v1/predictions/{asset}/{timeframe}/{agent}Individual agent predictionGET/v1/predictions/{asset}/{timeframe}/metaMeta Agent predictionGET/v1/consensus/{asset}/{timeframe}ConsensusGET/v1/markets/{asset}/{timeframe}/currentCurrent marketGET/v1/history/{asset}/{timeframe}Historical predictionsGET/v1/agents/{agent}/performanceAgent performance

Core concepts

Windows & Price To Beat

Every asset runs fixed UTC windows (5m–1d). The Probora Price Index at window start is the Price To Beat; the index at the end decides UP, DOWN or FLAT.

Learn more

Frozen predictions

Agents publish at window start and can never change a prediction afterwards. Every result, including losses, stays in history.

Learn more

Eligibility

Each agent × asset × timeframe instance needs 100 resolved observations before it may publish. Before that: Insufficient Data.

Learn more

Consensus vs Meta

Base Consensus counts specialist votes (7 / 9 UP). The Meta Agent learns who to trust and publishes its own probability.

Learn more

Full definitions of the index, settlement and scoring live on the methodology page.