View as markdown
Endpoints · Signals

List signal matches

GEThttps://api.tickerbot.io/v2/signals/{signal}

Return the set of tickers where the named signal is true (for boolean flags) or where the numeric value satisfies a single-bounded condition. Sorted by signal value descending for numerics, alphabetically by ticker for booleans. Pass `?asof=YYYY-MM-DD` to get the match set as it was at the close of that day — sourced from `signal_daily_state`.

Plan access

Included on every plan, Hobby through Enterprise.

Rate limit

Hobby 600/min · Pro 2,000/min · Scale 10,000/min.

Universe

All ~12,000 tracked tickers on every plan.

Query parameters

stringrequired

A column on `ticker`. Boolean flags (e.g. `golden_cross_today`, `above_sma_50`) are detected automatically; numerics (e.g. `rsi_14`, `market_cap`, `pe_ratio`) require a condition.

string

Required for numeric signals. Single bound, format `<op><value>`. Operators: `>`, `>=`, `=`, `!=`, `<`, `<=`. Examples: `>70`, `<=200`, `!=0`. Ignored for boolean flags.

string

Optional. Run the match against historical daily state at the close of the given `YYYY-MM-DD` (or full ISO). All paid plans get full history.

string

Optional. Scope to a system or caller-owned universe slug.

integerdefault 50

Page size. Max 200.

string

Opaque cursor from the previous response.

Status codes

200
Page of matching tickers with as_of, count, next_cursor, and results. When ?asof= is set, response carries _meta.resolution: "daily" and _meta.frozen_fields for static columns.
400
Numeric signal called without condition, malformed condition, malformed asof, or invalid cursor.
404
Signal name does not exist on the schema.