Core Endpoints
GETGet QuoteGETHealth Check
Pro Endpoints
🔒Get Signal (Action Card)Pro🔒Get OHLCV HistoryPro🔒Multi-Symbol ScannerPro🔒ScreenerPro🔒Extended AnalysisPro🔒Earnings SignalPro
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.

Parameters
NameInRequiredTypeDescription
symqueryrequiredstringTicker symbol (e.g. AAPL, NVDA, BTC/USD)
tfqueryoptionalstringTimeframe: daily (default), 4h, 1h
Response
{
  "ok": true,
  "symbol": "AAPL",
  "result": {
    "bias": "LONG",
    "stage": 2,
    "confidence": 78,
    "tier": "HOT",
    "entry": 178.50,
    "stop": 172.00,
    "target": 192.00,
    "rr": 2.08,
    "rsi": 61.4,
    "macd": { "value": 1.23, "signal": 0.87, "histogram": 0.36 },
    "volume_ratio": 1.42,
    "triggers": ["Stage 2 breakout", "MACD bullish cross", "Volume surge"],
    "updated_at": "2026-03-31T16:00:00Z"
  }
}
GET/api/v1/history/:symbolPro

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

Parameters
NameInRequiredTypeDescription
symbolpathrequiredstringTicker symbol
tfqueryoptionalstringTimeframe: 1day (default), 4h, 1h, 30min, 15min
barsqueryoptionalnumberNumber of bars to return (max 500, default 100)
Response
{
  "ok": true,
  "symbol": "AAPL",
  "tf": "1day",
  "bars": [
    { "datetime": "2026-03-31", "open": 176.20, "high": 179.10, "low": 175.80, "close": 178.23, "volume": 54382910 },
    { "datetime": "2026-03-28", "open": 174.50, "high": 177.00, "low": 173.90, "close": 176.10, "volume": 48291000 }
  ],
  "count": 100
}
POST/api/v1/scanPro

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

Parameters
NameInRequiredTypeDescription
symbolsbodyrequiredstring[]Array of ticker symbols (max 50)
minScorebodyoptionalnumberMinimum confidence score filter (0–100)
tierbodyoptionalstringFilter by tier: HOT, WATCH, NEUTRAL, SKIP
Response
{
  "ok": true,
  "results": [
    { "symbol": "NVDA", "tier": "HOT", "bias": "LONG", "score": 91, "entry": 820.00, "stop": 790.00, "rr": 2.3 },
    { "symbol": "AAPL", "tier": "WATCH", "bias": "LONG", "score": 72, "entry": 178.50, "stop": 172.00, "rr": 2.1 }
  ],
  "count": 2,
  "scanned": 20
}
POST/api/v1/screenerPro

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

Parameters
NameInRequiredTypeDescription
universebodyoptionalstringUniverse preset: sp500, nasdaq100, crypto, etf, or custom
symbolsbodyoptionalstring[]Custom symbol list (used when universe=custom)
filtersbodyoptionalobjectFilter object: { minScore, tier, bias, minVolume }
Response
{
  "ok": true,
  "results": [
    { "symbol": "NVDA", "tier": "HOT", "bias": "LONG", "overallScore": 91, "stage": 2, "actionCard": { "entry": 820, "stop": 790, "target": 890, "rr": 2.3 } }
  ],
  "total": 1,
  "universe": "nasdaq100"
}
GET/api/v1/analysis?sym=:symbolPro

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

Parameters
NameInRequiredTypeDescription
symqueryrequiredstringTicker symbol
Response
{
  "ok": true,
  "symbol": "AAPL",
  "analysis": {
    "summary": "Stage 2 uptrend with strong momentum. Volume confirms breakout above 30-week MA.",
    "patterns": ["Cup and Handle", "Ascending Triangle"],
    "sentiment": "Bullish",
    "catalysts": ["Earnings beat expected", "AI hardware cycle tailwind"],
    "risks": ["Broad market correction risk", "USD strength headwind"],
    "technicals": { "rsi": 61.4, "macd_cross": "bullish", "stage": 2, "above_30wma": true }
  }
}
GET/api/v1/earnings?symbol=:symbolPro

Returns the latest earnings signal for a ticker — EPS and revenue beat/miss vs analyst estimates, segment & KPI deltas QoQ, and a structured STRONG_BEAT → STRONG_MISS score. Data sourced from Fiscal.ai, updated within 1 hour of each earnings release.

Parameters
NameInRequiredTypeDescription
symbolqueryrequiredstringTicker symbol (e.g. AAPL, NVDA, MSFT)
exchangequeryoptionalstringExchange: NASDAQ (default), NYSE, TSX, etc.
Response
{
  "symbol": "AAPL",
  "companyName": "Apple Inc.",
  "period": "Q1 2026",
  "reportDate": "2026-01-30",
  "signal": "STRONG_BEAT",
  "signalScore": 2,
  "eps": {
    "actual": 2.40,
    "estimate": 2.27,
    "surprisePct": 5.73,
    "result": "BEAT"
  },
  "revenue": {
    "actual": 124800000000,
    "estimate": 124000000000,
    "surprisePct": 0.65,
    "result": "IN_LINE"
  },
  "adjustedEBITDA": 43200000000,
  "adjustedFCF": 30100000000,
  "kpiDeltas": [
    { "name": "Services Revenue", "unit": "USD", "current": 26300000000, "prior": 23100000000, "changePct": 13.9, "direction": "UP", "isMateriallyPositive": true, "isMateriallyNegative": false }
  ],
  "segmentDeltas": [],
  "bullishPoints": ["EPS beat analyst estimates", "Services Revenue up 13.9% QoQ"],
  "bearishPoints": [],
  "dataSource": "fiscal_ai",
  "minutesSinceReport": 47,
  "fetchedAt": "2026-01-30T22:47:00Z",
  "cached": false
}
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