API Documentation

Integrate ConstantSecurities.AI predictions into your trading systems.

Authentication

All API requests require a Bearer token. Get your API key from the dashboard.

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.constantsecurities.ai/v1/signals/AAPL

Endpoints

Get Signal for Symbol

GET /v1/signals/{symbol}

Get the current trading signal for a specific symbol.

{
  "symbol": "AAPL",
  "signal": "buy",
  "confidence": 0.87,
  "price_target": 195.50,
  "stop_loss": 172.00,
  "oracles": {
    "nebula": "buy",
    "pulsar": "buy", 
    "quasar": "hold",
    "nova": "buy",
    "cosmos": "buy",
    "aure": "buy",
    "stellar": "buy"
  },
  "consensus": 6,
  "reasoning": "Strong momentum with positive sentiment. 6/7 oracles agree on buy signal.",
  "timestamp": "2026-01-25T20:30:00Z"
}

Batch Analysis

POST /v1/analyze

Analyze multiple symbols in a single request.

// Request
{
  "symbols": ["AAPL", "TSLA", "NVDA", "BTC-USD"],
  "include_reasoning": true
}

// Response
{
  "signals": [
    { "symbol": "AAPL", "signal": "buy", "confidence": 0.87 },
    { "symbol": "TSLA", "signal": "hold", "confidence": 0.62 },
    { "symbol": "NVDA", "signal": "buy", "confidence": 0.91 },
    { "symbol": "BTC-USD", "signal": "sell", "confidence": 0.73 }
  ],
  "generated_at": "2026-01-25T20:30:00Z"
}

Daily Digest

GET /v1/predictions/daily

Get the daily prediction summary for all tracked symbols.

Historical Performance

GET /v1/performance

Get historical accuracy metrics for our predictions.

{
  "period": "30d",
  "total_signals": 4521,
  "accuracy": {
    "overall": 0.8544,
    "buy_signals": 0.8721,
    "sell_signals": 0.8234,
    "hold_signals": 0.8612
  },
  "by_oracle": {
    "stellar": 0.944,
    "nova": 0.913,
    "pulsar": 0.891,
    "cosmos": 0.885,
    "nebula": 0.872,
    "aure": 0.869,
    "quasar": 0.858
  }
}

Setup Webhooks

POST /v1/webhooks

Configure real-time signal delivery to your endpoint.

// Request
{
  "url": "https://your-server.com/signals",
  "symbols": ["AAPL", "TSLA"],
  "events": ["signal_change", "price_target_hit"],
  "secret": "your-webhook-secret"
}

Rate Limits

Plan	Requests/min	Requests/month
Signals	10	1,000
Professional	60	10,000
Enterprise	300	Unlimited

Error Codes

Code	Meaning
`401`	Invalid or missing API key
`403`	Subscription tier doesn't include this feature
`404`	Symbol not found
`429`	Rate limit exceeded
`500`	Server error

SDKs

Python

pip install constantsecurities

from constantsecurities import Client

client = Client(api_key="your_api_key")
signal = client.get_signal("AAPL")
print(f"{signal.symbol}: {signal.signal} ({signal.confidence:.0%})")

JavaScript

npm install constantsecurities

import { ConstantSecurities } from 'constantsecurities';

const client = new ConstantSecurities({ apiKey: 'your_api_key' });
const signal = await client.getSignal('AAPL');
console.log(`${signal.symbol}: ${signal.signal}`);