Skip to content
PROBORA

Getting Started

Probora API

Programmatic access to Probora's prediction intelligence: specialist agents, the Meta Agent, Base Consensus, markets, settlements and verified performance.

Overview

The Probora API gives traders, bots and developers programmatic access to the same intelligence that powers probora.xyz: probabilities from nine specialist agents, the Meta Agent's unified prediction, Base Consensus, independently resolved markets and the public performance record behind every agent.

Every prediction is frozen at window start, before the outcome is known, and later scored against the Probora Price Index. The API returns exactly what was published, wins and losses alike.

Individual Agent APIEach specialist's live probability for any market.Meta Agent APIThe network's unified prediction.Consensus APIRaw specialist agreement, side by side with Meta.Historical Predictions APIEvery published prediction, wins and losses included.Leaderboard & Performance APIAccuracy, probability quality and calibration.WebSocket Real-time FeedPredictions and settlements pushed the moment they happen.

Base URL

All endpoints are served over HTTPS from a single versioned base URL. Plain HTTP requests are rejected.

Base URL
https://api.probora.xyz/v1

Quickstart

  1. Create an API key in the dashboard under API Keys. The full key is shown once, so store it in your secret manager.
  2. Export it as an environment variable: export PROBORA_API_KEY=prb_live_…
  3. Request Base Consensus for the live BTC 15-minute window:
# export PROBORA_API_KEY=prb_live_…
curl "https://api.probora.xyz/v1/consensus/BTC/15m" \
  -H "Authorization: Bearer $PROBORA_API_KEY"

The response contains the specialist vote, the agreement ratio and the Meta Agent's probability:

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

Conventions

TopicConvention
FormatJSON with snake_case keys, UTF-8.
TimestampsISO-8601 in UTC with millisecond precision, e.g. 2026-11-14T20:00:00.412Z.
ProbabilitiesFractions in [0, 1]. 0.682 means 68.2%.
PricesUSD, rounded to each asset's tick size (see Assets).
AssetsUppercase symbols in paths: BTC, ETH, SOL, XRP, DOGE, HYPE, BNB, GOLD, SILVER, OIL.
Timeframes5m, 15m, 1h, 4h and 1d windows aligned to UTC boundaries.
Market idsDeterministic: {asset}-{timeframe}-{YYYYMMDD}-{HHMM}, e.g. btc-15m-20261114-2000.
PaginationCursor-based. Pass next_cursor back as ?cursor= until it is null.
Forward compatibilityNew fields may be added at any time. Ignore fields you do not recognize.

Demo and live data

Every response carries a data_mode field. "live" values are computed from real price sources. "demo" values come from Probora's deterministic simulated network, used in development and sandbox environments.

Never mixed

Demo and live data are never combined in a response, a leaderboard or a performance statistic. Check data_mode before you act on a value.

Versioning & status

The version is part of the path (/v1). Breaking changes ship as a new version; additive changes such as new fields or endpoints can appear within v1. The REST API is in Developer Preview: endpoints are stable in shape but limits and coverage may still evolve. The WebSocket feed is coming soon. Operational status is published on the status page.

Next steps

AuthenticationBearer tokens, key format and security practices.Rate limitsPer-plan limits, headers and graceful backoff.Current predictionsEvery agent, consensus and Meta in one call.Endpoint referenceAll v1 endpoints on a single page.

Questions or feedback on the API? [email protected]