Batched Signal History

GET /signals-history-batched
Api key query

Get historical daily or monthly signals for one or more tickers (max 1 year).

Query parameters

  • tickers array[string] Required

    List of tickers, e.g. tickers=AAPL&tickers=MSFT

  • period string

    Period: one of 1d–30d or 1m–6m

    Default value is 15d.

  • regime string

    Market regime: neutral, bear, or bull

    Default value is neutral.

  • limit integer

    Maximum number of days to fetch (<= 365)

    Maximum value is 365.0. Default value is 365.

Responses

  • 200 application/json

    Successful Response

    Hide response attribute Show response attribute object
    • * object
      Hide * attributes Show * attributes object
      • ticker string Required
      • regime string Required
      • period string Required
      • predictions array[object] Required
        Hide predictions attributes Show predictions attributes object
        • date string(date-time) Required
        • signal string Required
        • confidence number Required
  • 422 application/json

    Validation Error

    Hide response attribute Show response attribute object
    • detail array[object]
      Hide detail attributes Show detail attributes object
      • loc array[string | integer] Required
      • msg string Required
      • type string Required
GET /signals-history-batched 
curl \
 --request GET 'https://api.falpha.ai/signals-history-batched?tickers=string&api_key=api_token_value'
Response examples (200) 
{
  "AAPL": {
    "items": [
      {
        "date": "2025-02-09T00:00:00",
        "signal": "buy",
        "confidence": 0.5263
      },
      {
        "date": "2025-02-06T00:00:00",
        "signal": "buy",
        "confidence": 0.5026
      },
      {
        "date": "2025-02-05T00:00:00",
        "signal": "buy",
        "confidence": 0.5152
      }
    ],
    "period": "2m",
    "regime": "bull",
    "ticker": "AAPL"
  },
  "MSFT": {
    "items": [
      {
        "date": "2025-02-09T00:00:00",
        "signal": "sell",
        "confidence": 0.481
      },
      {
        "date": "2025-02-08T00:00:00",
        "signal": "sell",
        "confidence": 0.463
      }
    ],
    "period": "15d",
    "regime": "bear",
    "ticker": "MSFT"
  }
}
Response examples (422) 
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}