API Documentation

Base URL

https://aipricepredict.com/api/v1
GET/health

Health check endpoint

curl https://aipricepredict.com/api/v1/health
Response:
{
  "success": true,
  "status": "healthy",
  "database": "connected",
  "total_predictions": 15144
}
GET/stats

Get overall statistics for dual threshold predictions

curl https://aipricepredict.com/api/v1/stats
Response:
{
  "success": true,
  "data": {
    "total_predictions": 15144,
    "unique_symbols": 14656,
    "asset_classes": 4,
    "threshold_5pct": {
      "up": 1234,
      "down": 1567,
      "flat": 5432,
      "avg_confidence": "0.8217"
    },
    "threshold_7pct": {
      "up": 987,
      "down": 1123,
      "flat": 6123,
      "avg_confidence": "0.8975"
    }
  }
}
GET/symbols

Get list of available symbols

Query Parameters:
  • asset_class - Filter by asset class (crypto, equity, forex, index)
curl https://aipricepredict.com/api/v1/symbols?asset_class=crypto
GET/predictions

Get batch predictions with dual thresholds

Query Parameters:
  • symbols - Comma-separated symbol list (e.g., BTC-USD,ETH-USD)
  • asset_class - Filter by asset class
  • threshold - Filter by threshold (5 or 7)
  • limit - Max results (default: 100)
curl https://aipricepredict.com/api/v1/predictions?asset_class=crypto&limit=10
GET/predictions/:symbol

Get detailed prediction for a specific symbol with dynamic thresholds based on asset volatility

curl https://aipricepredict.com/api/v1/predictions/BTC-USD
Response:
{
  "success": true,
  "data": {
    "symbol": "BTC-USD",
    "asset_class": "crypto",
    "price": 50000,
    "signal_5pct": {
      "direction": "FLAT",
      "threshold": "dynamic",
      "confidence": 0.88,
      "accuracy_historical": "61.90%"
    },
    "signal_7pct": {
      "direction": "FLAT",
      "threshold_pct": 3.0,
      "confidence": 0.92,
      "accuracy_historical": "73.75%"
    },
    "quantiles": {
      "q10": 40550,
      "q25": 44150,
      "q50": 50000,
      "q75": 55850,
      "q90": 59450
    },
    "ranges": {
      "lower_bound": 40550,
      "upper_bound": 59450,
      "containment_probability": 0.9226
    },
    "risk_metrics": {
      "value_at_risk": -2500,
      "volatility": 0.3125,
      "risk_grade": "B+"
    }
  }
}

Rate Limits

  • General API: 60 requests/minute
  • Prediction endpoints: 30 requests/minute
  • • Rate limit headers included in response