Predictions

Meta Agent

The Meta Agent's independent probability, with the Base Consensus it was built on.

Overview

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

Developer PreviewTrader plan and aboveapi.probora.xyz

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.

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/meta" \
  -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,
  "agent": "Meta",
  "agent_slug": "meta",
  "status": "published",
  "direction": "UP",
  "up_probability": 0.671,
  "down_probability": 0.329,
  "confidence": 0.79,
  "historical_accuracy": 0.652,
  "sample_size": 48291,
  "model_version": "meta-btc15-v18",
  "prediction_timestamp": "2026-11-14T20:00:00.412Z",
  "settlement_timestamp": "2026-11-14T20:15:00.000Z",
  "data_mode": "live",
  "base_consensus": {
    "specialists_up": 7,
    "specialists_down": 2,
    "direction": "UP",
    "agreement": 0.778
  }
}

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.
agent	string	Agent display name.
agent_slug	string	Agent identifier used in paths and filters.
status	string	"published", or "insufficient_data" while the model instance has fewer than 100 resolved observations.
direction	string	Called direction: UP or DOWN.
up_probability	number	Probability that the window settles UP, in [0, 1].
down_probability	number	Probability that the window settles DOWN (1 − up_probability).
confidence	number	Signal-quality score in [0, 1]. Separate from the probability itself.
historical_accuracy	number	Directional accuracy of this model instance (asset × timeframe) over its public history.
sample_size	integer	Resolved public predictions behind historical_accuracy.
model_version	string	Frozen model version that produced the prediction.
prediction_timestamp	string	When the prediction was published: at window start, before settlement.
settlement_timestamp	string	When the window settles.
data_mode	string	"live" for real price sources, "demo" for the simulated network. The two are never mixed.
base_consensus	object	Base Consensus the Meta Agent was evaluated against (counts, direction, agreement).

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

The Meta Agent is not a tenth vote. It learns which specialists have been reliable for each asset, timeframe and market regime, and how informative their agreement or disagreement is. It then produces its own independent probability.
base_consensus is included for context. Meta usually agrees with a strong majority, but it can and does diverge when the reliable specialists disagree with the crowd.
Meta has its own track record and its own eligibility threshold of 100 resolved observations per market.
Meta weighting is proprietary and is never exposed through the API.

Questions or feedback on the API? [email protected]

Overview#

Parameters#

Request#

Response#

Errors#