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/signal?sym=AAPL200 OK
direction: LONG
confidence: 87%
tier: HOT
// INSTITUTIONAL CONVICTION SCORE
ics.score: 78/100
ics.conviction: HIGH
// WYCKOFF PHASE
wyckoff.phase: Markup
wyckoff.narrative: "Institutional accumulation complete. Price is in confirmed markup phase — buyers in control."
// ELLIOTT WAVE
wave.label: Wave 3 of 5
wave.target: 192.4
wave.invalidation: 174.8
// ACTION CARD
entry: 178.23
stop: 174.8
target: 185.9
rr: 2.2:1
# Get a live signal with ICS + Wyckoff + Elliott Wave
curl https://getsigna.ai/api/v1/signal?sym=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 (Unusual Whales)

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

5-wave impulse and ABC correction counting. Validates Wave 3 extension ratios, computes Wave 5 targets, and returns the exact price that invalidates the count.

🔍

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 + Backtesting

200+ days of candles with multi-source failover. Backtesting engine with Sharpe ratio, max drawdown, and win rate. Founding tier.

10 ENDPOINTS

Complete API Reference

Base URL: https://getsigna.ai/api/v1

METHOD
ENDPOINT
PLAN
DESCRIPTION
GET
/api/v1/health
Free
Data provider health check
GET
/api/v1/quote/:symbol
Free
Real-time quote with price, change, volume
GET
/api/v1/signal
Pro
29-Driver Action Card with ICS, Wyckoff, Elliott Wave, grade
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
POST
/api/v1/backtest
Founding
Backtesting engine with Sharpe, drawdown, win rate
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
Pro
Live options flow — whale sweeps, blocks, unusual activity (Unusual Whales)
GET
/api/options-flow/dark-pool
Pro
Dark pool prints — institutional off-exchange block trades
GET
/api/options-flow/congress
Pro
Congressional trades — US Congress buy/sell disclosures
GET
/api/options-flow/tide
Pro
Market tide — put/call ratio trend and flow direction
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 →
LIVE DEMO — REAL MARKET DATA

See a Real Action Card Fire

This is a live call to GET /api/v1/signal?sym=AAPL — not a mock. Switch symbols to watch the engine run on real data.

THE API CALL THAT PRODUCED THIS
curl https://getsigna.ai/api/v1/signal?sym=AAPL   -H "Authorization: Bearer cmts_your_key"
RESPONSE SHAPE (abbreviated)
{
  "ok": true,
  "symbol": "AAPL",
  "data": {
    "direction": "LONG",
    "confidence": 87,
    "ics":         { "score": 74, "conviction": "HIGH" },
    "wyckoff":     { "phase": "Markup", "narrative": "..." },
    "elliottWave": { "label": "Wave 3 of 5", "target": 215.00 },
    "entry":  178.23,
    "stop":   172.40,
    "target": 192.90,
    "rr":     2.5
  }
}
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://getsigna.ai/mcp",
      "headers": {
        "Authorization": "Bearer cmts_your_key"
      }
    }
  }
}
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');
console.log(signal.grade);       // "A+"
console.log(signal.score);       // 94
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);
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

FREE
$0
100/day · 2 endpoints
Health Check
Real-time Quote
API Key management
Playground access
Get Free
PRO
$49/mo
1,000/day · 9 endpoints
Everything in Free
10-Driver Action Card
ICS + Wyckoff + Elliott Wave
Multi-symbol Scanner
Natural Language API
Signal Index (SSI)
A2A Agent Routing
OHLCV History
Get Pro
FOUNDING MEMBER
FOUNDING
$29/mo
2,000/hr · 10 endpoints
Everything in Pro
Backtesting Engine
Sharpe + Drawdown + Win Rate
Priority support
Price locked forever
Founding badge #1–1,000
Claim Founding Spot

Start Building on Signa

Free tier. No credit card. API key in 60 seconds. Full docs at getsigna.ai/docs.

Get API Key →Read the Docs