---
title: "Batched Signal History"
method: GET
path: "/signals-history-batched"
tags: ["Signals"]
---

# Batched Signal History

`GET /signals-history-batched`

## Request

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

Get historical signals and sentiment for one or more tickers. If no date range is provided, returns the last 7 calendar days by default.

## Query parameters

- `tickers` string[], required: List of tickers, e.g. tickers=AAPL&tickers=MSFT
- `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_performance` boolean: Include realized performance fields (pnl, ticker_return, index_return, release_date). Defaults to false. Values are backfilled once returns are realized, so recent rows return nulls.
- `start_date` string, nullable: Start date (YYYY-MM-DD, inclusive). If both dates are omitted, history endpoints default to the last 7 calendar days. The maximum allowed range between start_date and end_date for this endpoint is 90 days; larger ranges are rejected with HTTP 400.
- `end_date` string, nullable: End date (YYYY-MM-DD, inclusive). If both dates are omitted, history endpoints default to the last 7 calendar days. The maximum allowed range between start_date and end_date for this endpoint is 90 days; larger ranges are rejected with HTTP 400.

## Response `200`

Successful Response

- BatchedSignalHistory

## 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)