register_free_watch
Register a free webhook subscription. TensorFeed POSTs HMAC-signed deliveries to your callback_url when the watch spec fires (price drop, status change, leaderboard rank shift, macro indicator threshold crossing, etc). 5 watches per IP, 25 fires per watch, 30-day TTL. Same delivery infrastructure as paid /api/premium/watches. If you omit secret, TensorFeed generates one and returns it; you cannot retrieve it again later. Same IP for management; manage via the REST endpoints under /api/watches/free/{id}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| spec | Yes | Watch spec. Examples: { type: "price", model: "opus-4-7", field: "blended", op: "lt", threshold: 50 }; { type: "status", provider: "openai", op: "becomes", value: "down" }; { type: "leaderboard_rank", provider: "anthropic", op: "drops_below", threshold: 3 }; { type: "macro_indicator", source: "fred", series_id: "T10Y2Y", metric: "value", op: "crosses", threshold: 0 }; { type: "digest", cadence: "daily" }. | |
| secret | No | Optional shared secret for HMAC-SHA256 signing. If omitted, TensorFeed generates a 32-hex secret and returns it once. | |
| fire_cap | No | Optional cap on total fires for this watch. Capped at 25 for free tier; smaller values honored. | |
| callback_url | Yes | HTTPS URL to receive POST deliveries. Must NOT be private/localhost (SSRF guarded). |