Signal state

Query parameters

Returns

Status codes

Notes

• Numeric matches come back sorted by signal value descending; boolean matches alphabetically by ticker.
• For the match set as of a past date, add ?asof= — see Ticker matches (as-of).
• Custom signals: {signal} may be one of your custom signals — it resolves as a boolean signal (matches where its predicate is true; condition is ignored). See Create a custom signal.
• For booleans, the response value is true/false. For numerics it's the signal value at the time of the request.
• Pair with asof to ask "who matched as of a past date" — see Ticker matches (as-of). For a per-ticker time series of one signal, see Series.
• Membership: live reads return currently-active tickers only. As-of reads use point-in-time listing instead (was the ticker listed and not yet delisted at that instant), so a since-delisted name can legitimately appear in a historical match set.

More examples

curl "https://api.tickerbot.io/v2/signals/at_52w_high?limit=3" \
  -H "Authorization: Bearer YOUR_KEY"

{
  "as_of": "2026-08-11T21:35:37.719Z",
  "signal": "at_52w_high",
  "condition": null,
  "universe": null,
  "count": 3,
  "next_cursor": "eyJhZnRlcl90aWNrZXIiOiJBQk5HIn0",
  "results": [
    { "ticker": "AAAP", "name": "Pacer Barings CLO Market Flex ETF",              "value": true },
    { "ticker": "ABCS", "name": "Alpha Blue Capital US Small-Mid Cap Dynamic ETF", "value": true },
    { "ticker": "ABNG", "name": "Leverage Shares 2x Long ABNB Daily ETF",          "value": true }
  ]
}

Query parameters

Returns

Status codes

Notes

• This is GET /v2/signals/{signal} with ?asof= — as-of at one-signal scope, the second tense of the same page because point-in-time is its own question. The response envelope matches the live call, plus _meta describing the grain served and why.
• Pass asof as a YYYY-MM-DD date (that day's close) or a full ISO timestamp (that intraday moment), and pick the grain with interval. A match set is a cross-section, so it resolves to ONE grain — and 1m is only servable for a scoped universe, since the minute tier carries ~1,100 of ~13,700 tickers.
• Custom signals: {signal} may be one of your custom signals — it resolves as a boolean signal. See Create a custom signal.
• A match set spans every asset class the signal is defined for, so R: rates and X: FX/crypto instruments appear alongside equities — the example above is topped by Fed funds rates, not stocks. Scope with universe (or filter asset_class via /v2/scan) when you want one class.
• Static fields aren't historized — name, sector, industry, asset_type, and exchange reflect their *current* values. _meta.frozen_fields lists exactly which ones.
• For per-ticker time series of one signal across many bars (not a point-in-time snapshot), use Series — ?ticker={t}&columns={signal}.
• Unlimited depth.
• A date-only asof resolves to the close of that day. A full ISO timestamp (…T15:30:00Z) resolves intraday at the grain you name with interval (1m/1h/1d/auto). _meta.interval reports the grain served and _meta.interval_reason why; tickers with no row at that grain are disclosed in _meta.coverage_gap with a sample. Illiquid instruments (SPAC warrants, units, rights) routinely have no intraday print, so a small coverage_gap at 1m/1h is normal rather than a fault. If there is no state exactly at the requested moment (weekend, holiday, or a gap), the server carries forward the most-recent row within the lookback window (14 days at daily resolution, 5 days for intraday granularities) — a Saturday asof returns Friday's values, not an empty set. Beyond the window you get an empty results array with the echoed asof. (/v2/tickers/{ticker}?asof= applies the identical staleness rule since 2026-07-27, and 404s with last_available when nothing is fresh enough.)
• Membership is point-in-time (survivorship-safe): the as-of set includes tickers that were listed and not yet delisted at that instant, so a since-delisted name can legitimately appear. The live read of this same endpoint returns currently-active tickers only.

More examples

curl "https://api.tickerbot.io/v2/signals/at_52w_high?asof=2024-02-23&limit=3" \
  -H "Authorization: Bearer YOUR_KEY"

{
  "as_of": "2024-02-23",
  "signal": "at_52w_high",
  "condition": null,
  "universe": null,
  "_meta": {
    "interval": "1d",
    "interval_requested": "auto",
    "interval_reason": "date-only asof resolves to the daily close",
    "resolution": "daily",
    "frozen_fields": ["name", "sector", "industry", "asset_type", "exchange", "asset_class", "ticker_category"]
  },
  "count": 3,
  "next_cursor": "eyJhZnRlcl90aWNrZXIiOiJBRkxHIn0",
  "results": [
    { "ticker": "ABEQ", "name": "Absolute Select Value ETF",              "value": true },
    { "ticker": "ACR",  "name": "ACRES Commercial Realty Corp.",          "value": true },
    { "ticker": "AFLG", "name": "First Trust Active Factor Large Cap ETF", "value": true }
  ]
}