Core Endpoints
GETGet QuoteGETHealth Check
Pro Endpoints
🔒Get Signal (Action Card)Pro🔒Get OHLCV HistoryPro🔒Multi-Symbol ScannerPro🔒ScreenerPro🔒Extended AnalysisPro
Enterprise
🔒Backtesting APIEnt.🔒Signa Signal IndexEnt.🔒A2A RoutingEnt.
Unlock full docs
Sign up free to access all endpoint documentation.
Sign Up Free
API/Reference

API Reference

All endpoints use the base URL https://getsigna.ai. Authenticate with Authorization: Bearer YOUR_API_KEY.

Authentication
Authorization: Bearer cmts_a1b2c3d4e5f6...

Get your API key at Dashboard → API Keys. The /health endpoint does not require authentication.

GET/api/v1/quote/:symbolFree

Returns a real-time price quote for any stock, ETF, or crypto symbol.

Parameters
NameInRequiredTypeDescription
symbolpathrequiredstringTicker symbol (e.g. AAPL, QQQ, BTC/USD)
Response
{
  "ok": true,
  "symbol": "AAPL",
  "data": {
    "price": 178.23,
    "change": 2.45,
    "changePercent": 1.39,
    "volume": 54382910,
    "high": 179.10,
    "low": 176.80,
    "open": 177.00,
    "source": "signa",
    "timestamp": "2026-03-31T16:00:00Z"
  }
}
GET/api/v1/healthFree

Returns the health status of all data providers. No authentication required.

Response
{
  "ok": true,
  "status": "healthy",
  "providers": [
    { "name": "Signa Market Data", "healthy": true, "latency_ms": 42 }
  ],
  "meta": {
    "api_version": "v1",
    "engine_version": "2.0",
    "checked_at": "2026-03-31T16:00:00Z"
  }
}
GET/api/v1/signal?sym=:symbolPro

Returns the full Signa Action Card for a symbol — bias, Weinstein stage, confidence, triggers, entry/stop/target, and all technical indicator values.

// Full documentation available with Pro plan // - Request parameters // - Response schema // - Code examples (cURL, JS, Python) // - Error handling // - Rate limit headers
🔒
Requires Pro Plan
GET/api/v1/history/:symbolPro

Returns historical OHLCV candle data. Supports daily, 4h, 1h, and intraday timeframes. Up to 500 bars.

// Full documentation available with Pro plan // - Request parameters // - Response schema // - Code examples (cURL, JS, Python) // - Error handling // - Rate limit headers
🔒
Requires Pro Plan
POST/api/v1/scanPro

Scan multiple symbols simultaneously and return results ranked by signal score. Filter by tier (HOT/WATCH/NEUTRAL) and minimum score.

// Full documentation available with Pro plan // - Request parameters // - Response schema // - Code examples (cURL, JS, Python) // - Error handling // - Rate limit headers
🔒
Requires Pro Plan
POST/api/v1/screenerPro

Advanced screener with full Action Card data for each symbol. Returns a ranked list sorted by overall score.

// Full documentation available with Pro plan // - Request parameters // - Response schema // - Code examples (cURL, JS, Python) // - Error handling // - Rate limit headers
🔒
Requires Pro Plan
GET/api/v1/analysis?sym=:symbolPro

Returns extended analysis including chart patterns, market opportunities, sentiment context, and full technical data.

// Full documentation available with Pro plan // - Request parameters // - Response schema // - Code examples (cURL, JS, Python) // - Error handling // - Rate limit headers
🔒
Requires Pro Plan
POST/api/v1/backtestEnterprise

Run Monte Carlo backtests on any strategy using historical Signa signals. Returns probability of ruin, expected return, and outcome distribution.

// Full documentation available with Enterprise plan // - Request parameters // - Response schema // - Code examples (cURL, JS, Python) // - Error handling // - Rate limit headers
🔒
Requires Enterprise Plan
GET/api/v1/index/signaEnterprise

The Signa Signal Index — a composite market-wide sentiment and signal strength score updated in real-time.

// Full documentation available with Enterprise plan // - Request parameters // - Response schema // - Code examples (cURL, JS, Python) // - Error handling // - Rate limit headers
🔒
Requires Enterprise Plan
POST/api/v1/a2a/routeEnterprise

Agent-to-Agent routing endpoint. Allows AI agents to request signals, analysis, and execution recommendations in a structured agent protocol format.

// Full documentation available with Enterprise plan // - Request parameters // - Response schema // - Code examples (cURL, JS, Python) // - Error handling // - Rate limit headers
🔒
Requires Enterprise Plan