View as markdown
Endpoints · Tickers

Subscribe to a ticker

POSThttps://api.tickerbot.io/v2/tickers/{ticker}/subscribe

Subscribes a single ticker. `condition` is a WHERE-clause fragment evaluated when this ticker is matched — you do not need to add `ticker = '…'` yourself; the endpoint scopes the predicate to the path ticker automatically. Plan-gated by webhook tier; counts against your account-wide webhook cap. Returns the same shape as `GET /v2/webhooks/{id}`.

Plan access

Included on every plan.

Cadence

Hobby 5m · Pro 1m · Scale 1m · Enterprise 1m.

Capacity

Unlimited on every paid plan.

Body parameters

stringrequired

Ticker symbol (case-insensitive).

Status codes

200
Webhook subscription created.
400
bad_request — missing condition, invalid ticker, malformed target_url, or cadence faster than plan allows.
403
webhook_tier_required, webhook_limit_reached, or cadence_above_plan_max.
404
not_found — ticker is not tracked.