Price Prediction

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.

GET/v1/price-prediction/data

List all predictions

Returns directional scores for all supported coins. Omit the coin parameter to get the full list.

Query parameters

Name
coin
Type
string
Description
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)

Name
coins
Type
array
Description
Array of coin score objects, each with coin, displayName, slug, consensusScore, direction, signals, spotPrice, marketCap, priceChange24h, modelConfidence, forecasts, and scoredAt. The price-change fields do not share one unit; see detail mode below.
Name
updatedAt
Type
string
Description
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.

Request

GET

/v1/price-prediction/data

curl -G https://www.sharpe.ai/api/v1/price-prediction/data \
  -H "Authorization: Bearer sk_live_your_key_here"

Response (signals[] truncated to one entry; list mode returns the same per-coin shape as detail mode below)

{
  "data": {
    "coins": [
      {
        "coin": "BTC",
        "displayName": "Bitcoin",
        "slug": "bitcoin",
        "consensusScore": 64,
        "direction": "bullish",
        "signals": [
          {
            "name": "funding",
            "label": "Funding Rate",
            "rawValue": 0.0006,
            "rawDisplay": "0.0600%",
            "subScore": 20,
            "conviction": 20,
            "bias": "bullish",
            "tooltip": "Average funding rate across exchanges"
          }
        ],
        "signalsAvailable": 6,
        "exchangesUsed": ["Binance", "Bybit", "OKX"],
        "spotPrice": 95200,
        "marketCap": 1870000000000,
        "priceChange24h": 2.15,
        "modelConfidence": 67,
        "scoredAt": "2026-03-28T12:00:00Z"
      }
    ],
    "updatedAt": "2026-03-28T12:00:00Z"
  },
  "meta": {
    "request_id": "req_abc123def456ghij",
    "timestamp": "2026-03-28T12:00:05Z",
    "elapsed_ms": 12
  }
}

GET/v1/price-prediction/data?coin=bitcoin

Get single coin

Pass a ticker or coin slug to get the full signal breakdown for a specific asset. Returns a 404 resource_not_found error if the coin is not recognized.

Response fields (detail mode)

Name
coin
Type
object
Description
Full coin score object with all signal details, or null if not found.
Name
coin.consensusScore
Type
number
Description
Final consensus score. Range: 0 (strong bearish) to 100 (strong bullish), with 40-60 treated as neutral.
Name
coin.direction
Type
string
Description
One of strong_bullish, bullish, neutral, bearish, strong_bearish, or insufficient_data.
Name
coin.signals
Type
array
Description
Array of signal objects, each with name, label, rawValue, rawDisplay, subScore, conviction, bias, and tooltip.
Name
coin.exchangesUsed
Type
array
Description
List of exchange identifiers that contributed data to this score.
Name
coin.priceChange24h
Type
number
Description
24-hour price change in percent: 2.15 means +2.15%. Taken from the CoinGecko snapshot when the coin was scored. null when unavailable.
Name
coin.priceChange7d
Type
number
Description
7-day price change as a decimal fraction: 0.0875 means +8.75%. Computed from hourly closes. This is not a percent: multiply by 100 before comparing it with priceChange24h.
Name
coin.priceChange30d
Type
number
Description
30-day price change as a decimal fraction: 0.0564 means +5.64%. Computed from hourly closes, like priceChange7d.
Name
coin.distanceFrom7dHigh
Type
number
Description
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.
Name
coin.distanceFrom7dLow
Type
number
Description
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.
Name
coin.modelConfidence
Type
number
Description
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.
Name
coin.forecasts
Type
array
Description
Optional 7D and 30D deterministic heuristic scenarios. The legacy fields expectedChangePct, expectedPrice, lowPrice, highPrice, and confidence are not calibrated targets, quantiles, or probabilities. The array is empty unless a current spot price, at least two signals, and observed realized volatility are available.
Name
updatedAt
Type
string
Description
ISO 8601 timestamp of the last scoring run.

Request

GET

/v1/price-prediction/data?coin=bitcoin

curl -G https://www.sharpe.ai/api/v1/price-prediction/data \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -d coin=bitcoin

Response

{
  "data": {
    "coin": {
      "coin": "BTC",
      "displayName": "Bitcoin",
      "slug": "bitcoin",
      "consensusScore": 64,
      "direction": "bullish",
      "signals": [
        {
          "name": "funding",
          "label": "Funding Rate",
          "rawValue": 0.0006,
          "rawDisplay": "0.0600%",
          "subScore": 20,
          "conviction": 20,
          "bias": "bullish",
          "tooltip": "Average funding rate across exchanges"
        },
        {
          "name": "oi",
          "label": "Open Interest",
          "rawValue": 0.06,
          "rawDisplay": "+6.0%",
          "subScore": 20,
          "conviction": 20,
          "bias": "bullish",
          "tooltip": "24h change in aggregate open interest"
        },
        {
          "name": "ls",
          "label": "Long/Short Ratio",
          "rawValue": 0.88,
          "rawDisplay": "0.88",
          "subScore": 18,
          "conviction": 18,
          "bias": "bullish",
          "tooltip": "Ratio of long to short positions"
        },
        {
          "name": "liquidation",
          "label": "Liquidations",
          "rawValue": -0.35,
          "rawDisplay": "33% long",
          "subScore": 35,
          "conviction": 35,
          "bias": "bullish",
          "tooltip": "Proportion of long vs short liquidations"
        },
        {
          "name": "rsi",
          "label": "RSI (14)",
          "rawValue": 42,
          "rawDisplay": "42.0",
          "subScore": 16,
          "conviction": 16,
          "bias": "bullish",
          "tooltip": "14-period Relative Strength Index"
        },
        {
          "name": "ema",
          "label": "EMA Cross",
          "rawValue": 1.85,
          "rawDisplay": "+1.85%",
          "subScore": 37,
          "conviction": 37,
          "bias": "bullish",
          "tooltip": "EMA(12) vs EMA(26) crossover signal"
        },
        {
          "name": "positioning",
          "label": "Positioning Pressure",
          "rawValue": 0.62,
          "rawDisplay": "+62%",
          "subScore": 62,
          "conviction": 62,
          "bias": "bullish",
          "tooltip": "Composite read of price direction, open-interest expansion, CVD, basis, and EMA"
        }
      ],
      "signalsAvailable": 7,
      "exchangesUsed": ["Binance", "Bybit", "OKX", "Deribit"],
      "spotPrice": 95200,
      "marketCap": 1870000000000,
      "priceChange24h": 2.15,
      "modelConfidence": 67,
      "forecasts": [
        {
          "days": 7,
          "expectedChangePct": 3.8,
          "expectedPrice": 98817.6,
          "lowPrice": 90144.2,
          "highPrice": 108027.5,
          "confidence": 67
        },
        {
          "days": 30,
          "expectedChangePct": 7.9,
          "expectedPrice": 102720.8,
          "lowPrice": 76891.4,
          "highPrice": 138448.9,
          "confidence": 67
        }
      ],
      "scoredAt": "2026-03-28T12:00:00Z"
    },
    "updatedAt": "2026-03-28T12:00:00Z"
  },
  "meta": {
    "request_id": "req_def456ghi789jklm",
    "timestamp": "2026-03-28T12:00:05Z",
    "elapsed_ms": 12
  }
}

Read the error reference