Predictions

Current Predictions

All specialist predictions, Base Consensus and the Meta Agent for the live window of a market, in one call.

Overview

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

Developer PreviewTrader plan and aboveapi.probora.xyz

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.

Parameters

Parameter	In	Type	Description
assetrequired	path	string	Asset symbol. One of BTC, ETH, SOL, XRP, DOGE, HYPE, BNB, GOLD, SILVER, OIL.Example: `BTC`
timeframerequired	path	string	Window length. One of 5m, 15m, 1h, 4h, 1d.Example: `15m`

Request

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

Response

200 OK, returned as application/json. Example:

Response · 200

{
  "asset": "BTC",
  "timeframe": "15m",
  "market_id": "btc-15m-20261114-2000",
  "price_to_beat": 76230,
  "specialists": [
    {
      "agent_slug": "trend",
      "direction": "UP",
      "up_probability": 0.612,
      "confidence": 0.66,
      "status": "published"
    },
    {
      "agent_slug": "order-flow",
      "direction": "UP",
      "up_probability": 0.682,
      "confidence": 0.84,
      "status": "published"
    },
    {
      "agent_slug": "mean-reversion",
      "direction": "DOWN",
      "up_probability": 0.441,
      "confidence": 0.52,
      "status": "published"
    }
  ],
  "consensus": {
    "specialists_up": 7,
    "specialists_down": 2,
    "base_consensus": "UP",
    "agreement": 0.778
  },
  "meta": {
    "direction": "UP",
    "up_probability": 0.671,
    "confidence": 0.79
  },
  "data_mode": "live"
}

Response fields

Field	Type	Description
asset	string	Asset symbol, e.g. BTC.
timeframe	string	Window length: 5m, 15m, 1h, 4h or 1d.
market_id	string	Deterministic market id {asset}-{timeframe}-{YYYYMMDD}-{HHMM} (UTC window start).
price_to_beat	number	Probora Price Index at the window start, rounded to the asset's tick size.
specialists	array	One entry per specialist: direction, up_probability, confidence and status.
consensus	object	Base Consensus for the window.
meta	object	The Meta Agent's direction, probability and confidence for the same window.
data_mode	string	"live" for real price sources, "demo" for the simulated network. The two are never mixed.

Errors

Errors use the standard error envelope. Codes this endpoint can return:

Code	Status	Meaning
invalid_asset	400	Invalid asset. The asset symbol is not supported.
invalid_timeframe	400	Invalid timeframe. The timeframe is not one of 5m, 15m, 1h, 4h, 1d.
unauthorized	401	Unauthorized. The API key is missing, malformed or revoked.
plan_required	403	Plan required. Your plan does not include this endpoint or history depth.
rate_limited	429	Rate limited. Too many requests. Retry after the time in the Retry-After header.
internal_error	500	Internal error. Something went wrong on our side. The request id helps us investigate.

Notes

specialists contains one entry per specialist available for the market, in catalog order. Each entry has its own status: published, insufficient_data (fewer than 100 resolved observations) or unavailable.
Liquidation and OI/Funding require leveraged-derivatives data and are unavailable on GOLD, SILVER and OIL. Base Consensus on those markets is computed over the remaining specialists.
All predictions in the bundle were frozen at the window start and are identical to what the individual endpoints return. They never change during the window.
The bundle includes the Meta Agent, so it requires the Trader plan or above.

Questions or feedback on the API? [email protected]

Overview#

Parameters#

Request#

Response#

Errors#