Skip to main content
The setups endpoint returns the currently active setup records — the same data that populates the Setups Table in the StratAlerts UI. Each item represents one setup on one timeframe for one symbol, and includes candle state, in-force status, P3 and PMG indicators, setup shape, and sector classification. You can scope the results to specific symbols or timeframes, or omit filters to retrieve the full active universe up to your limit. GET https://app.stratalerts.com/api/market/v1/setups/current
Requires scope: states:read

​
Request parameters

​
symbols
string
Comma-separated list of ticker symbols to filter by (e.g., AAPL,MSFT,SPY). When provided, only setups for those symbols are returned. Symbols are normalized to uppercase. Maximum 250.
​
timeframes
string
Comma-separated list of timeframe codes to filter by (e.g., D,W,M). When provided, only setups on those timeframes are returned. Valid timeframe codes: 15, 30, 60, 4H, D, W, M, Q, Y.
​
limit
number
default:"100"
Maximum number of setup rows to return. Results are ordered by symbol then timeframe before the limit is applied.

​
Response fields

​
items
object[]
required
Array of setup objects.
Results are ordered alphabetically by symbol, then by timeframe, before the limit is applied. If you need a specific subset, always pass symbols and/or timeframes to avoid truncation.

​
Code examples

curl -G "https://app.stratalerts.com/api/market/v1/setups/current" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "symbols=AAPL,MSFT" \
  --data-urlencode "timeframes=D,W" \
  --data-urlencode "limit=50"

​
Example response

{
  "items": [
    {
      "symbol": "AAPL",
      "timeframe": "D",
      "shape": "1-2U",
      "in_force": true,
      "p3": false,
      "pmg": null,
      "continuation": false,
      "sector": "Information Technology"
    },
    {
      "symbol": "AAPL",
      "timeframe": "W",
      "shape": "1-2D",
      "in_force": false,
      "p3": true,
      "pmg": 210.00,
      "continuation": false,
      "sector": "Information Technology"
    },
    {
      "symbol": "MSFT",
      "timeframe": "D",
      "shape": "2U-2U",
      "in_force": false,
      "p3": false,
      "pmg": null,
      "continuation": true,
      "sector": "Information Technology"
    }
  ]
}

​
Error codes

HTTP statusError codeMeaning
401missing_api_keyNo API key was provided or the key format is invalid.
403inactive_entitlementYour account does not have an active API entitlement.
403missing_scopeYour API key does not have the states:read scope.
Error responses use the following shape: 
{
  "error": {
    "code": "missing_scope",
    "message": "missing scope"
  }
}