Skip to main content
The Price Prediction endpoint returns deterministic consensus directional scores for curated cached coins and on-demand market asset pages. Each score aggregates derivatives, flow, technical, and regime signals (funding rate, open interest change, perp basis, CVD, long/short ratio, liquidation bias, RSI, EMA cross, positioning pressure, momentum exhaustion, and squeeze risk) into a directional verdict plus optional 7D/30D heuristic scenarios. This is not a trained machine-learning model or a calibrated probability forecast. The number of available signals per coin (signalsAvailable) varies based on data coverage.

List all predictions

GET /v1/price-prediction/data Returns directional scores for all supported coins. Omit the coin parameter to get the full list.

Query parameters

string
Ticker or asset ID/slug (e.g., BTC, bitcoin, ethereum, solana); a curated coin’s ticker resolves to its slug. When omitted, returns cached scores for the curated list. When provided, returns the detailed signal breakdown for that coin, computing on demand when it is not in the cached list.

Response fields (list mode)

array
Array of coin score objects, each with coin, displayName, slug, consensusScore, direction, signals, spotPrice, marketCap, return24h, modelConfidence, forecasts, and scoredAt. Every return is a decimal fraction; see detail mode below.
string
ISO 8601 timestamp for the complete cached list. A partial half-sync preserves the prior aggregate timestamp while refreshed coins expose newer scoredAt values. null if no complete snapshot exists.
Response (signals[] truncated to one entry; list mode returns the same per-coin shape as detail mode below)

Get single coin

GET /v1/price-prediction/data?coin=bitcoin Pass a ticker or coin slug to get the full signal breakdown for a specific asset. Returns a 404 resource_not_found error, whose detail lists valid slugs, when the coin is not recognized or has no publishable score, and 503 service_unavailable with Retry-After when its live score cannot be computed.

Response fields (detail mode)

object
Full coin score object with all signal details, or null if not found.
number
Final consensus score. Range: 0 (strong bearish) to 100 (strong bullish), with 40-60 treated as neutral.
string
One of strong_bullish, bullish, neutral, bearish, strong_bearish, or insufficient_data.
array
Array of signal objects, each with name, label, rawValue, rawDisplay, subScore, conviction, bias, and tooltip.
array
List of exchange identifiers that contributed data to this score.
number
24-hour price return as a decimal fraction: 0.0215 means +2.15%. Taken from the CoinGecko snapshot when the coin was scored. null when unavailable.
number
7-day price return as a decimal fraction: 0.0875 means +8.75%. Computed from hourly closes.
number
30-day price return as a decimal fraction: 0.0564 means +5.64%. Computed from hourly closes, like return7d.
number
Latest close relative to the highest hourly close of the last 7 days, as a decimal fraction: -0.0426 means 4.26% below that high. Zero or negative.
number
Latest close relative to the lowest hourly close of the last 7 days, as a decimal fraction: 0.1245 means 12.45% above that low. Zero or positive.
number
Legacy field name for signal breadth, conviction, and agreement from 0 to 100. It is not a probability or statistical model confidence. Conflicting signals reduce the value even when the direction is non-neutral.
array
Optional 7D and 30D deterministic heuristic scenarios. expectedPrice (legacy name) is a signal-weighted midpoint, not a price target; expectedReturn is that midpoint as a return from the spot price, a decimal fraction (0.038 means +3.8%). lowPrice and highPrice are an 80% range: the 10th and 90th percentiles of a lognormal centred on expectedPrice at the coin’s 30-day realized daily volatility (expectedPrice × exp(∓1.2816 × volatility × √days)). The range assumes lognormal moves and is not backtested; fat tails leave it more often than one time in five. confidence is the coin’s modelConfidence (signal breadth and agreement), not a probability. The array is empty unless a current spot price, at least two signals, and observed realized volatility are available.
string
ISO 8601 timestamp of the last scoring run.
Response
Read the error reference