View as markdown
Endpoints · Signals

Update a custom signal

PATCHhttps://api.tickerbot.io/v2/signals/{name}

Partial update — supply expr, description, or both. Providing expr recompiles against the live column whitelist (same validator as create). Built-in signals are read-only — only custom signals you own can be patched. Write access requires Pro or above; Free/Hobby return 403 custom_signals_tier_required.

Existing subscriptions do not change. Scan/signal/ticker subscribe endpoints freeze a custom signal's SQL into the webhook at creation time, so editing the signal here updates ad-hoc reads and *new* subscriptions but leaves already-created webhooks firing on the old definition. Re-subscribe to apply the change.

Plan access

Pro and above. Free/Hobby can read the catalog but create/update/delete + consume return 403 custom_signals_tier_required.

Rate limit

Hobby 600/min · Pro 6,000/min · Scale 60,000/min.

Capacity

Up to 10 custom signals on Pro; unlimited on Scale and Enterprise.

Body parameters

stringrequired

Custom signal slug.

string

New SQL expression. Re-validated and re-inlined against your other custom signals.

string

New description.

Status codes

200
{ as_of, signal: {...} } — the updated signal.
400
compile_failed on bad expression, bad_request on shape failure.
403
custom_signals_tier_required — Hobby/Pro can read but not write custom signals.
404
not_found — no custom signal with that name on this account (built-ins are not patchable).