Signals

Signal History

Get historical signals and sentiment for a ticker. If no date range is provided, returns the last 7 calendar days by default.

get/signals-history/{ticker}

Request

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

Path parameters

tickerstring required

Query parameters

periodstring

Signal horizon: 5d, 15d, or 2m

regimestring

Market regime: neutral, bear, or bull

include_sentimentboolean

Include sentiment enrichment from daily sentiment data. Defaults to false; set to true to include sentiment lookups.

include_qualityboolean

Include signal quality metrics (Sharpe/Sortino/IIS). Defaults to false; when true the quality field is populated (individual metrics may still be null).

include_performanceboolean

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_datestring 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 365 days; larger ranges are rejected with HTTP 400.

end_datestring 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 365 days; larger ranges are rejected with HTTP 400.

Response

Successful Response

tickerstring required
regimestring required
periodstring required

Example response

{
  "predictions": [
    {
      "quality": {
        "iis_score": 0.18,
        "normalized_iis": 0.55,
        "percent_positive_pnl": 0.57,
        "sharpe_ratio": 0.42,
        "sortino_ratio": 0.61
      },
      "performance": {
        "index_return": 0.012,
        "pnl": 0.0123,
        "release_date": "2026-05-18T00:00:00",
        "ticker_return": 0.031
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.