alert_link
Destructive
Prepare a price, indicator, chart-drawing, news or calendar alert and get a link that sets it in Basis in one click. Use it whenever the person wants to be told when something happens -- a level breaks, RSI crosses 70, price crosses a trend line, a high-impact ETF headline lands, or an event approaches. Pass exactly one of price, conditions, drawingId or eventTrigger. Give the URL as a link and say in one line what it watches. Nothing is armed until they open it and confirm. Market alerts can run in an open tab; background and event alerts require a signed-in Basis account. The link lasts seven days.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | What the person sees when it fires. Chosen for you if omitted. | |
| when | No | With price. Omit to pick the crossing from where price is now. | |
| match | No | How conditions combine. Default all. | |
| price | No | Shorthand for a price-level alert. | |
| market | No | ||
| symbol | No | e.g. BTCUSDT. Defaults to the chart you are building. | |
| message | No | Optional note carried into the notification. | |
| exchange | No | ||
| drawingId | No | ID returned by drawing_add. Supports horizontalLine, horizontalRay, trendLine, ray and extendedLine. | |
| frequency | No | Default once: fires, then switches itself off. | |
| timeframe | No | Bars the alert is checked on. Free presets: 1m, 3m, 5m, 10m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M. Founder-only custom intervals: 1–1440 minutes (17m), 1–168 hours (7h), 1–365 days (2d). | |
| conditions | No | Instead of price. Each {left, operator, right}. An operand is a number, a price field ("close"), an indicator name ("rsi", "ema50"), or {"type":"indicator","studyId":"macd","plotKey":"histogram","params":{}}. rising and falling need no right; changeUpPercent and changeDownPercent take a percent. | |
| eventTrigger | No | Instead of market conditions. A news or Basis calendar event filter. | |
| cooldownMinutes | No | With frequency cooldown. |