Documentation - Bellatrix Capital

Getting Started

The Bellatrix Capital API provides programmatic access to our AI-powered market predictions, real-time price data, and analysis reports. All API endpoints return JSON responses and are available over HTTPS.

Base URL

                // Production

                https://api.bellatrixcapital.com/v1

                // Data endpoints (static)

                https://bellatrixcapital.com/data

Quick Start

To get started with the API, follow these steps:

Create an account and subscribe to a plan that includes API access (Pro Trader or above).
Generate your API key from the Dashboard settings page.
Include the API key in the Authorization header of all requests.
Start making requests to the endpoints listed below.

API Endpoints

The following endpoints are available for accessing market data and predictions:

Market Data

GET /api/data/prices Live cryptocurrency prices

GET /api/data/stock-prices Live US stock prices

GET /api/data/ticker_data.json Ticker metadata and configuration

Predictions

GET /api/data/latest_predictions.json Latest ML model predictions

GET /api/data/model_performance.json Model accuracy & performance metrics

GET /api/data/breakout_analysis.json Breakout signal analysis

Reports

GET /api/data/reports_index.json Index of all available reports

GET /api/data/historical_performance.json Historical performance data

GET /api/data/pipeline_status.json ML pipeline run status

Authentication

All API requests (except public data endpoints) require authentication via Bearer token. Include your API key in the request header:

                # Using cURL

                curl -H "Authorization: Bearer YOUR_API_KEY" \

                     https://api.bellatrixcapital.com/v1/predictions/latest

                # Using Python (requests)

                import requests

                headers = {

                    "Authorization": "Bearer YOUR_API_KEY",

                    "Content-Type": "application/json"

                }

                response = requests.get(

                    "https://api.bellatrixcapital.com/v1/predictions/latest",

                    headers=headers

                )

                data = response.json()

                // Using JavaScript (fetch)

                const response = await fetch(

                    'https://api.bellatrixcapital.com/v1/predictions/latest',

                    {

                      headers: {

                        'Authorization': `Bearer ${API_KEY}`,

                        'Content-Type': 'application/json'

                      }

                    }

                );

                const data = await response.json();

Prediction Data Format

Prediction responses follow a consistent JSON schema. Here is an example response from the latest predictions endpoint:

                {

                  "timestamp": "2026-03-01T00:00:00Z",

                  "model_version": "v2.5.0",

                  "predictions": [

                    {

                      "symbol": "BTC-USD",

                      "direction": "BULLISH",

                      "confidence": 0.82,

                      "predicted_change": 3.45,

                      "timeframe": "24h",

                      "features_used": 127,

                      "model_type": "ensemble"

                    }

                  ]

                }

Response Fields

Field	Type	Description
`symbol`	string	Trading pair or ticker symbol
`direction`	string	BULLISH, BEARISH, or NEUTRAL
`confidence`	float	Model confidence score (0.0 – 1.0)
`predicted_change`	float	Predicted percentage price change
`timeframe`	string	Prediction window (e.g., 24h, 7d)
`model_type`	string	Model architecture used for prediction

WebSocket Feeds

Real-time price updates and prediction signals are available via WebSocket connections for Pro Trader and Institutional subscribers.

Connection

                // WebSocket connection

                const ws = new WebSocket('wss://ws.bellatrixcapital.com/v1/stream');

                // Authenticate after connection

                ws.onopen = () => {

                  ws.send(JSON.stringify({

                    type: 'auth',

                    api_key: 'YOUR_API_KEY'

                  }));

                };

                // Subscribe to channels

                ws.send(JSON.stringify({

                  type: 'subscribe',

                  channels: ['prices', 'predictions', 'alerts']

                }));

                // Handle incoming messages

                ws.onmessage = (event) => {

                  const data = JSON.parse(event.data);

                  console.log(data);

                };

Available Channels

prices — Real-time price ticks for subscribed symbols.
predictions — New prediction signals as they are generated.
alerts — Custom alert triggers based on your configured thresholds.
pipeline — Model training pipeline status updates.

Rate Limits

API rate limits depend on your subscription tier to ensure fair usage and platform stability:

Plan	Requests / Minute	Requests / Day	WebSocket Connections
Starter (Free)	10	500	—
Pro Trader	60	10,000	3
Institutional	300	100,000	20

Rate limit headers are included in all API responses:

                X-RateLimit-Limit: 60

                X-RateLimit-Remaining: 54

                X-RateLimit-Reset: 1709337600

If you exceed your rate limit, you'll receive a 429 Too Many Requests response. Contact us if you need higher limits.