API Reference
All endpoints use the base URL https://app.getsigna.ai. The MCP SSE URL is https://app.getsigna.ai/api/mcp/sse. Authenticate with Authorization: Bearer YOUR_API_KEY.
Authorization: Bearer cmts_a1b2c3d4e5f6...
Get your API key at Dashboard → API Keys. The /health endpoint does not require authentication.
/api/v1/quote/:symbolFreeReturns a last/spot quote for a stock, ETF, or crypto symbol. Crypto pairs accept slash or dash form (BTC/USD, BTC-USD). Ambiguous bare names such as PUMP, LIT, and VVV resolve as US equities — use PUMP/USD for the token. Responses echo asset_class and venue. Unknown/unavailable quotes return HTTP 422 with ok:false and price:null (never numeric 0).
{
"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"
}
}/api/v1/healthFreeReturns the health status of all data providers. No authentication required.
{
"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"
}
}/api/v1/signals/{symbol}ProAI consensus signal with component scores, entry, stop, and targets. Documented path: GET /api/v1/signals/{symbol}. data.price is live last/spot (price_source=live_quote), never a silent prior close. Nightly engine is omitted and engine_available is false when runAt is stale beyond 1440 minutes. BTC/ETH/SOL are in the nightly universe. Ambiguous bare tickers (PUMP, LIT, VVV) resolve as equities — use PUMP/USD for crypto. Responses echo asset_class and venue.
{
"success": true,
"request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"server_time": "2026-08-05T19:00:00Z",
"data_as_of": "2026-08-05T19:00:00Z",
"data": {
"signal": {
"symbol": "AAPL",
"timeframe": "1d",
"direction": "LONG",
"score": null,
"grade": null,
"confidence": 87,
"entry_zone": { "low": 178.23, "high": 178.23 },
"stop_loss": 174.8,
"targets": [185.9],
"reward_to_risk": 2.2,
"component_scores": {
"trend": null,
"momentum": null,
"volume": null,
"relative_strength": null,
"volatility": null
},
"ics": { "currentScore": 52, "conviction": "NEUTRAL", "source": "synthetic" },
"ics_score": 52,
"model_version": "signa-consensus-v2.1"
}
}
}/api/v1/history/:symbolProReturns historical OHLCV candle data. Supports daily, 4h, 1h, and intraday timeframes. Up to 500 bars.
{
"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
}/api/v1/scanProScan multiple symbols simultaneously and return results ranked by signal score. Filter by tier (HOT/WATCH/NEUTRAL) and minimum score.
{
"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
}/api/v1/screenerProAdvanced screener with full Action Card data for each symbol. Returns a ranked list sorted by overall score.
{
"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"
}/api/v1/analysis?sym=:symbolProReturns extended analysis including chart patterns, market opportunities, sentiment context, and full technical data.
{
"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 }
}
}/api/v1/earnings?symbol=:symbolProReturns 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.
{
"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
}/api/v1/index/signaEnterpriseThe Signa Signal Index — a composite market-wide sentiment and signal strength score updated in real-time.
/api/v1/a2a/routeEnterpriseAgent-to-Agent routing endpoint. Allows AI agents to request signals, analysis, and execution recommendations in a structured agent protocol format.