---
title: "Signals"
method: GET
path: "/signals/{ticker}"
tags: ["Signals"]
---

# Signals

`GET /signals/{ticker}`

## Request

- Base URL: `https://api.falpha.ai`
- URL: `https://api.falpha.ai/signals/{ticker}`
- Auth: one of:
  - API key in query parameter `api_key`
  - API key in header `X-API-Key`

Get the latest signal and sentiment for a ticker.

## Path parameters

- `ticker` string, required

## Query parameters

- `period` string: Signal horizon: 5d, 15d, or 2m
- `regime` string: Market regime: neutral, bear, or bull
- `include_sentiment` boolean: Include sentiment enrichment from daily sentiment data. Defaults to false; set to true to include sentiment lookups.
- `include_quality` boolean: Include signal quality metrics (Sharpe/Sortino/IIS). Defaults to false; when true the `quality` field is populated (individual metrics may still be null).
- `include_drivers` boolean: Include the model's top attribution drivers (which named factors moved the signal, as % of total attribution). Defaults to false.

## Response `200`

Successful Response

- Signal
  - `ticker` string, required: Stock ticker symbol
  - `date` union
    - string, date-time
    - string
  - `period` string, required: Signal horizon: 5d, 15d, or 2m
  - `regime` string, required: Market regime: neutral, bear, or bull
  - `signal` string, required: Signal: buy or sell
  - `confidence` number, required: Confidence level
  - `sentiment` number, nullable: Average daily sentiment score (null when unavailable)
  - `quality` QualityMetrics: Signal quality metrics for one signal row. Only populated when the request sets include_quality=true; otherwise the parent `quality` key is null. Individual metrics are null when unavailable for that row.
    - `sharpe_ratio` number, nullable: Risk-adjusted measure of the signal's recent strength (a Sharpe-ratio proxy). Higher is better; can be negative.
    - `sortino_ratio` number, nullable: Downside-risk-adjusted counterpart to the Sharpe ratio.
    - `iis_score` number, nullable: Information-strength score for the signal at this horizon.
    - `normalized_iis` number, nullable: IIS score normalized for cross-ticker comparison.
    - `percent_positive_pnl` number, nullable: Percentage of recent signal-following outcomes with positive PnL (0-100).
  - `drivers` Driver[], nullable: Top attribution drivers (which factors moved the signal). Null unless include_drivers=true is requested.
    - `name` string, required: Human-readable factor name, e.g. Price, Sentiment, Volume, Credit Ratings
    - `weight_pct` number, required: Share of total signal attribution (0-100)
    - `direction` string, required: Which way this factor pushes the signal: buy or sell

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/falpha/apis/falpha-ai-api.md) · [All operations](https://skmtc.dev/falpha/apis/falpha-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/falpha/apis/falpha-ai-api/revisions/d437fee1fac5?raw)