SIGNA API · LIVE · getsigna.ai

Institutional-Grade Signals.
One API Call Away.

10-Driver Action Cards. Institutional Conviction Score. Wyckoff Phase Detection. Elliott Wave counting. Natural language queries. All accessible via a single REST API, MCP server, or A2A agent protocol.

GET /api/v1/signals/AAPL200 OK
success: true
data.signal.symbol: AAPL
data.signal.timeframe: 1d
// data.signal
signal.direction: LONG
signal.confidence: 87
signal.grade: null
signal.score: null
// signal.component_scores
trend: null
momentum: null
volume: null
relative_strength: null
volatility: null
// signal levels
signal.entry_zone: {"low":178.23,"high":178.23}
signal.stop_loss: 174.8
signal.targets: [185.9]
signal.reward_to_risk: 2.2
# GET /api/v1/signals/{symbol}
curl https://app.getsigna.ai/api/v1/signals/AAPL \
  -H "Authorization: Bearer YOUR_API_KEY"
WHAT YOU GET

More Than Indicators.
A Complete Intelligence Layer.

⚡

29-Driver Action Card + Grade

Scores 29 independent drivers simultaneously and produces one verdict: LONG, SHORT, or WAIT — with entry, stop, target, R:R, and a letter grade A+ to F reflecting conviction.

🏦

Institutional Conviction Score (ICS)

Proprietary 0–100 score tracking smart money conviction by testing whether dark pool print levels are holding as support or failing. No other retail API offers this.

🌊

Live Options Flow (Signa Intelligence)

Per-symbol live options flow: whale sweeps, blocks, unusual activity flags, premium, OI, and volume. Dark pool prints and congressional trade disclosures also available.

🏛️

Broker Execution Routes

Connect Alpaca (paper or live), execute trades with Kelly Criterion sizing, sync live positions, and retrieve positions with Signa edge recommendations — all via API.

📊

Wyckoff Phase Detection

All 7 Wyckoff phases detected with plain-English narrative. Auto-detects Spring, UTAD, and Last Point of Support. Returns a story, not just a label.

〰️

Elliott Wave + Fibonacci

Fail-closed OHLC-pivot counting. A 5-wave or ABC path is shown only when hard rules validate; otherwise the wave is unavailable and no path is drawn.

🔍

Multi-Symbol Scanner

Scan dozens of symbols simultaneously, ranked by signal strength. Bullish setups at the top, bearish at the bottom. Includes Signal Index (SSI) 0–100.

🤖

Natural Language API

POST a plain-English query like "best AI stock setups this week" — Claude extracts intent and symbols, then runs live signal analysis on each. Pro tier.

🔗

MCP Server + A2A Routing

Native MCP server for Claude Desktop, Cursor, and Windsurf. A2A agent routing protocol for multi-agent trading workflows. Industry first.

📈

OHLCV History + Strategy Simulation

200+ days of candles with multi-source failover. Strategy simulation tools include Sharpe ratio, max drawdown, and win rate. Founding tier.

10 ENDPOINTS

Complete API Reference

REST base: https://app.getsigna.ai

METHOD
ENDPOINT
PLAN
DESCRIPTION
GET
/api/v1/health
Member
Data provider health check
GET
/api/v1/quote/:symbol
Member
Real-time quote with price, change, volume
GET
/api/v1/signals/{symbol}
Pro
AI consensus signal with component scores, entry, stop, and targets
GET
/api/v1/analysis
Pro
Extended analysis with full technical breakdown
GET
/api/v1/history/:symbol
Pro
OHLCV candle history (up to 500 bars)
POST
/api/v1/scan
Pro
Multi-symbol scanner — up to 20 symbols per request
POST
/api/v1/interpret
Pro
Natural language → structured signals via Claude AI
GET
/api/v1/signal-index
Pro
Signa Signal Index (SSI) — 0–100 market sentiment
POST
/api/v1/a2a
Pro
A2A agent routing — delegate tasks to Signa agents
GET
/api/v1/agents
Pro
Agent SDK — signal, batch, top, news, markets, edge
GET
/api/edge-detection
Pro
Edge detection — mispricing between markets and news
GET
/api/prediction-markets
Pro
Prediction markets — Polymarket, Kalshi, Manifold
GET
/api/v1/enhanced-signal
Pro
Enhanced signal — Technical + Markets + News composite
GET
/api/options-flow/:symbol
Individual
Live options flow — whale sweeps, blocks, unusual activity (Signa Intelligence). Paid Individual / Early / Founding.
GET
/api/darkpool/prints
Individual
Dark pool prints — institutional off-exchange block trades (also: /api/options-flow/darkpool/:symbol). Paid Individual / Early / Founding.
GET
/api/v1/political-trades
Founding
Congressional trades — STOCK Act disclosures with party, chamber, amount range, and net sentiment. Filters: ticker, chamber (house|senate), party (D|R|I), type (buy|sell), limit (max 200).
GET
/api/congress/trades
Founding
Congressional trades — raw STOCK Act disclosures with party/chamber/amount (also: /api/options-flow/congress for aggregated signal)
GET
/api/options-flow/congress
Founding
Congressional trades — aggregated buy/sell signal (BUYING/SELLING/NEUTRAL)
GET
/api/options-flow/tide
Individual
Market tide — put/call ratio trend and flow direction. Paid Individual / Early / Founding.
POST
/api/broker/connect-alpaca
Pro
Connect Alpaca account (paper or live) — encrypted credential storage
POST
/api/broker/execute-trade
Pro
Execute trade from edge signal with Kelly Criterion sizing
GET
/api/broker/positions
Pro
Fetch synced broker positions with Signa edge recommendations
POST
/api/broker/sync-positions
Pro
Pull live positions from Alpaca into Signa database
GET
/api/broker/connections
Pro
List active broker connections (no credentials returned)
Full Reference Docs →Try in Playground →
PUBLIC DEMO WIDGET

See a Real Action Card Fire

This widget calls GET /api/v1/demo (no auth). The documented Signal path is GET /api/v1/signals/{symbol}.

DOCUMENTED SIGNAL CALL
curl https://app.getsigna.ai/api/v1/signals/AAPL   -H "Authorization: Bearer YOUR_API_KEY"
RESPONSE SHAPE (abbreviated)
{
  "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"
    }
  }
}
Auto-refreshes every 60 seconds. No key required to view this demo — sign up free to call it from your own code.
MCP · A2A · AGENT READY

The Only Trading API
Built for AI Agents.

Connect Claude Desktop, Cursor, or any MCP-compatible AI assistant directly to live signals, screener results, and full analysis. Ask "What are the best setups right now?" and get a real answer — not a hallucination.

The A2A routing protocol lets you build multi-agent trading workflows — route tasks to purpose-built Signa agents or register your own external agents into the network.

CLAUDE DESKTOP · claude_desktop_config.json
{
  "mcpServers": {
    "signa": {
      "url": "https://app.getsigna.ai/api/mcp/sse"
    }
  }
}
A2A AGENT ROUTING
POST /api/v1/a2a
{
  "task": "signal_analysis",
  "symbols": ["NVDA", "AAPL"],
  "context": { "timeframe": "1d" }
}
// Routes to Signa Signal Agent
// Returns: Action Cards + ICS + Wyckoff
AGENT SDK

Build AI Trading Agents

Combine Technical Analysis + Prediction Markets + News Sentiment in one API call. Three pre-built agent templates included.

⚡

Momentum Agent

Buys A/A+ grade signals, sells D/F. Simple, fast, effective.

🎯

Prediction + News Agent

Requires multi-source confirmation: Technical ≥85 + Markets ≥70% + 3 bullish news.

🔍

Edge Detection

Finds mispricings between prediction market probability and news sentiment.

AGENT SDK — QUICK START
import { SignaAgentSDK } from '@signa/agent-sdk';

const signa = new SignaAgentSDK({ apiKey: 'YOUR_TOKEN' });

// Get full multi-source signal
const signal = await signa.getSignal('AAPL');
if (process.env.NODE_ENV !== 'production') console.log(signal.grade);       // "A+"
if (process.env.NODE_ENV !== 'production') console.log(signal.score);       // 94
if (process.env.NODE_ENV !== 'production') console.log(signal.edge.type);   // "UNDERPRICED"

// Batch signals
const signals = await signa.getBatchSignals(
  ['AAPL', 'MSFT', 'NVDA', 'BTC']
);

// Scan for edge opportunities
const edges = await signa.scanEdges(undefined, 40);
if (process.env.NODE_ENV !== 'production') console.log(edges[0].symbol, edges[0].edgeScore);
EDGE DETECTION RESPONSE
// GET /api/edge-detection?sym=AAPL
{
  "type": "UNDERPRICED",
  "score": 72,
  "actionability": "HIGH",
  "marketProbability": 45,
  "newsSentiment": 74,
  "divergence": 29,
  "recommendation": "AAPL market appears
    UNDERPRICED at 45% while news
    sentiment is 74%...",
  "reasoning": [
    "Market probability: 45% (3 markets)",
    "News sentiment: 74% (8 articles)",
    "Divergence: 29 ppts",
    "✅ News more bullish than market"
  ]
}
API ACCESS TIERS

Choose Your Access Level

MEMBER
Included
10/min burst · 100/day · 2 endpoints
✓Health Check
✓Real-time Quote
✓API Key management
✓Playground access
Get Member →
EARLY ADOPTER
$39/mo
60/min burst · 1,000/day · 8 endpoints
✓Price locked forever at $39/mo
✓Options Flow scanner (live unusual activity)
✓Dark pool institutional prints
Get Early Adopter →
INDIVIDUAL / STANDARD
$49/mo
annual $39
60/min burst · 1,000/day · 8 endpoints
✓Everything in Member
✓Options Flow scanner (live unusual activity)
✓Dark pool institutional prints
✓Action Card (29 drivers)
✓Pattern Detection
✓3 custom agent slots
Get Individual / Standard →
ANNUAL ONLY
FOUNDING MEMBER
$276/yr
60/min burst · 1,000/day · 8 endpoints
✓Annual-only — $23 monthly-equivalent
✓Price locked forever at $276/yr
✓Options Flow scanner (live unusual activity)
✓Dark pool institutional prints
Get Founding Member →
FOR DEVELOPERS
PROFESSIONAL
$199/mo
annual $159
300/min burst · 10,000/day · 10 endpoints
✓Everything in Individual (including options flow and dark pool)
✓5 custom agents — full condition library
✓Priority support (4-hour SLA)
✓MCP + A2A access
✓Advanced workflow support
Get Professional →

Start Building on Signa

Included with every plan. API key in 60 seconds. Full docs at getsigna.ai/docs.

Get API Key →Read the Docs
Signa — Professional Trading Tools