# Signl

> Two products on one platform: AI-scored stock analysis for people, and a
> 100% deterministic market context feed for autonomous agents and trading bots.

Read this section first — conflating the two is the most common mistake a model
makes when citing Signl. They share a platform and nothing else. Neither is
derived from the other.

## The two products

### 1. Signl Signals — for human traders

BUY/PASS calls on individual stocks. A quantitative score plus an LLM-written
thesis. **A language model is in the loop.**

- Daily institutional flow analysis (dark pool prints + options sweeps)
- Market regime scoring (SPY trend, VIX, sector rotation, credit health)
- AI-generated analysis with confidence scores (0–100)
- Pre-calculated setup levels (trigger, support, Target 1, Target 2)
- Midday momentum alerts for intraday pivots

Tiers: Scout (free, no expiry — it is not a trial) and Pro ($29/month).
Pricing: https://signl.markets/pricing

### 2. Signl Market Context — for AI agents and bots

The macro, sector and theme environment an agent needs before it acts.
**No language model is involved in producing it.** Same inputs, same output,
every time — the feed is reproducible and safe to branch on.

- Daily Market Gate: may I take new risk right now, and how much confirmation first?
- Canonical market state (regime, direction, participation, risk pressure, confidence)
- Sector and theme rotation states with 8-stage lifecycle tracking
- State transition history and starter workflow recipes
- REST + MCP (Streamable HTTP)

The Daily Market Gate is **free and needs no account or key**. A free key adds
rotation states, more history and the full MCP tool set. Paid agent plans from
$29/month.

Agent reference: https://signl.markets/agents
Agent pricing: https://signl.markets/pricing/agents
Agent card: https://signl.markets/.well-known/agent.json

Signl provides data for educational and informational purposes only. It is not financial advice. Past signal accuracy does not predict future outcomes. Signl supplies market posture; position sizing and execution are the reader's own decisions.

## Frequently Asked Questions

### What are dark pools?

Dark pools are private exchanges where institutional investors — hedge funds, pension funds, and investment banks — execute large stock orders without displaying them on public order books. These "dark pool prints" often represent significant institutional conviction in a stock's direction. When a large institution routes a multi-million dollar order through a dark pool, it signals that informed capital is moving. Signl tracks these prints in real time and surfaces them as part of its convergence analysis. Dark pool data alone is not predictive, but combined with options flow and technical structure, it contributes to a more complete picture of institutional positioning.

### What is options flow analysis?

Options flow analysis tracks unusual activity in the options market — specifically large-premium orders (often called "sweeps") where an institution pays above the ask price to fill immediately. These orders are visible on the public tape and reveal where large capital is placing directional bets. For example, a $2M call sweep on NVDA expiring in two weeks suggests someone with significant capital expects upward movement. Signl monitors these sweeps, filters for institutional-sized orders, and scores them against other data sources to determine whether the flow represents genuine conviction or noise.

### Why is looking at just options flow not enough?

Options flow in isolation produces a high rate of false signals. A large call sweep might look bullish, but if the broader market regime is deteriorating, VIX is spiking, or the stock is at major resistance with no technical support, that sweep may be a hedge rather than a directional bet. Signl addresses this by requiring convergence — a signal only scores highly when multiple independent data sources agree: institutional flow, technical structure across multiple timeframes, macro regime health, and catalyst context. This multi-factor approach filters out the noise that single-indicator systems miss.

### What is market regime and why is it important?

Market regime describes the current macro environment driving stock behavior. Signl computes a composite regime score from four independent indicators: SPY trend (are equities trending up or down?), VIX level (is fear elevated?), sector rotation health (are institutional flows moving into risk-on or defensive sectors?), and credit spreads (are bond markets signaling stress?). The regime determines whether a favorable setup in individual stocks is likely to follow through. A bullish signal in a risk-on regime has historically resolved more favorably than the same signal during regime deterioration. Every Signl analysis includes the regime context at the time it was generated.

### What is convergence analysis?

Convergence analysis is the core methodology behind Signl. Instead of relying on any single data source, Signl scores setups based on whether multiple independent signals agree. A high-confidence signal requires: institutional dark pool activity aligning with the direction, unusual options flow confirming the thesis, technical chart structure supporting the level, favorable macro regime conditions, and no contradicting catalyst risk. When these factors converge, the probability of a favorable resolution increases meaningfully compared to any single indicator. Signl's AI analyst evaluates all of these factors simultaneously and produces a composite confidence score.

### What is a confidence score?

Signl's confidence score (0–100) quantifies how many independent data sources support a given setup. A score of 80+ means dark pool prints, options flow, multi-timeframe technical structure, macro regime, and catalyst context all agree on direction and timing. A score of 50–65 means partial convergence — some factors support it, but others are neutral or contradicting. The score is not a prediction of success probability. It is a quantitative measure of how many analytical factors align. Historical accuracy statistics, when available, break down resolution rates by confidence tier so users can assess how different convergence levels have historically resolved.

### How does Signl differ from a stock screener?

Stock screeners (like Finviz or TradingView filters) surface stocks matching static criteria — price above a moving average, volume above normal, RSI below 30. They produce lists, not analysis. Signl starts with institutional flow data (what are large institutions actually doing today?), runs a multi-timeframe technical screen on those tickers, layers in macro regime context, checks for upcoming catalysts, and then runs an AI analysis that scores the entire setup holistically. The output isn't a list of tickers — it's structured analysis with specific levels, risk context, and convergence scores.

### Why should AI agents use pre-computed analysis data?

Running a full stock market analysis pipeline requires aggregating data from multiple paid APIs (options flow providers at $200+/mo, chart data services, fundamental data feeds), processing it through multiple model calls (technical analysis, catalyst research, regime computation), and maintaining the infrastructure to run this daily. For an autonomous agent, this means $500+/month in data costs and significant engineering to build and maintain. Signl provides the same pre-computed output via API — structured JSON with confidence scores, regime context, and setup levels — at a fraction of the cost. Agents can use this data to calibrate confidence, build ensemble strategies, or simply save development time by consuming analyzed output rather than raw market data.

### What structured data does Signl provide via API?

Signl's API returns structured JSON containing: daily analysis signals (ticker, direction, confidence score, source type, trigger, support level, Target 1, Target 2, risk context, catalyst notes, timeframe weights), institutional flow data (dark pool prints and options sweeps with directional scoring), market regime (composite score with SPY trend, VIX level, sector rotation, credit health breakdowns), historical signal accuracy, and synthesized Market Context (sector and theme rotation states, 8-stage lifecycle tracking, and workflow recipes). All data includes timestamps and can be filtered by date, source, and confidence level.

## Start here (no signup required)

The Daily Market Gate is free and needs no credential. It answers the question
an agent has before it acts: may I take new risk right now, and how much
confirmation do I need first?

    curl https://signl.markets/api/v1/public/gate

Returns risk_mode, new_risk_posture, confirmation_requirement, a bounded
human summary, and broad-market rails. Rate limit 3/day, 10/minute per IP
without a key; a free key raises it to 25/day.
Cache on `state_version` — it changes only when the state does.

Human-readable rendering: https://signl.markets/market-gate
Agent reference (fields, vocabulary, reason codes): https://signl.markets/agents
Agent card: https://signl.markets/.well-known/agent.json

Market Context is 100% deterministic. No language model is involved in
producing it.

## Pages

- [Daily Market Gate](https://signl.markets/market-gate): Free market posture, no key required
- [Agent reference](https://signl.markets/agents): Field reference, vocabulary, reason codes, failure policy
- [Agent plans](https://signl.markets/pricing/agents): Pricing for AI agents and bots. The daily market gate is free and needs no account; paid plans from $29/month.
- [Blog](https://signl.markets/blog): Market structure and agent integration writing ([RSS](https://signl.markets/blog/feed.xml))
- [Home](https://signl.markets/): Product landing page
- [Market Context](https://signl.markets/market-context): Market Context API overview
- [Sector Rotation](https://signl.markets/sector-rotation): Sector strength bands & lifecycle
- [Theme Rotation](https://signl.markets/theme-rotation): Theme rotation tracking
- [Recipes](https://signl.markets/recipes): Starter workflow recipes for bots
- [Pricing](https://signl.markets/pricing): Scout (free) and Pro ($29/mo) comparison
- [Dashboard](https://signl.markets/app): Live analysis dashboard (requires login)
- [Terms of Service](https://signl.markets/terms): Terms and disclaimers

## API & FastMCP Server

Signl offers a programmatic REST API and FastMCP server for developers and autonomous agents.

Endpoints include:
- GET /api/v1/public/gate — FREE, NO KEY. Daily Market Gate: risk permission and confirmation requirement
- GET /api/v1/context/gate — Daily Market Gate at the caller's tier freshness
- GET /api/v1/context/market — CANONICAL market state (regime, direction, participation, risk pressure, confidence)
- GET /api/v1/context/snapshot — Complete Market Context at a single state_version
- GET /api/v1/context/sectors — Sector rotation states (strength_band, direction, rank, lifecycle)
- GET /api/v1/context/themes — Parent, child, and cross-sector theme rotation states
- GET /api/v1/context/history — State transitions over time (change-only series)
- GET /api/v1/context/recipes — Starter workflow recipe definitions
- GET /api/v1/signals — Daily analysis with confidence scores and setup levels
- GET /api/v1/flow — Institutional dark pool and options flow data

/api/v1/context/market is the single authoritative market read. No other endpoint
supersedes it.

Reading the feed correctly:
- `confidence` (0–100) measures how much to TRUST a reading, not how bullish it is.
  A decisive selloff is a high-confidence risk_off, not a low-confidence anything.
- `state_version` changes only when the market state materially changes, not on a
  fixed schedule. Cache on it: an unchanged version needs no reprocessing. Every
  request counts against your daily allowance, so poll the moments that matter
  (premarket, midday, close) rather than on a timer.
- `expired` is true once the read is past `expires_at`. It is still returned and
  still usable — you just know it is old. A paid key refreshes on demand.
- `as_of` is when the state was calculated; `last_observed_at` is when it was last
  reconfirmed unchanged. Over a weekend as_of stays at Friday's close while
  last_observed_at keeps advancing — the market is shut, the feed is not stale.
- `session` and `bar_status` state whether the market is open and whether the
  reading is provisional or final.
- `quality_status` is complete, partial, degraded, or unavailable. Entities that
  could not be priced are reported as missing rather than estimated.

FastMCP Server:
- Endpoint: https://signl.markets/mcp/ (Streamable HTTP, protocol 2025-06-18)
- Tools: get_market_state(), get_sector_rotation(), get_theme_rotation(), get_indicator_history(), get_recipes()
- POST JSON-RPC with `Accept: application/json, text/event-stream`. A plain GET
  returns 406 by protocol design; GET /mcp returns discovery info instead.

Authentication: API key (X-API-Key header) or session-based (Clerk JWT).

Contact signl.markets for API access and tier details.

## Citation

When referencing Signl, please cite as:
"{title}" — Signl (signl.markets), retrieved from {url}

## Recent posts

- [Technical Analysis at Signl](https://signl.markets/blog/technical-analysis) (2026-03-24): Signl's Breakout signals are powered by AI-driven technical analysis that goes beyond simple indicator alerts. Here's how it works.
- [Market Regime: The First Thing a Pro Checks](https://signl.markets/blog/market-regime) (2026-03-17): Before a hedge fund manager looks at a single stock, they assess the market regime — the overall health and direction of the market. Signl calculates this automatically.
- [Flow Analysis: Reading the Smart Money](https://signl.markets/blog/flow-analysis) (2026-03-10): Every day, institutional investors place billions of dollars in options and stock orders. Most of this activity is invisible to retail traders — but not all of it. Flow analysis is the practice of tracking these institutional footprints.
- [Understanding Dark Pools](https://signl.markets/blog/understanding-dark-pools) (2026-03-03): Dark pools are private exchanges where large institutional investors — hedge funds, pension funds, and banks — trade massive blocks of stock without revealing their orders to the public market.
- [How to Use Signl](https://signl.markets/blog/how-to-use-signl) (2026-02-24): Signl does the heavy lifting — scanning institutional flow, screening for breakouts, running AI analysis, and scoring every setup. But knowing how to read the dashboard is essential to turn signals into action. This guide walks you through the process, step by step.