{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "$id": "https://firmtape.com/contracts/public/events/alerts/interest_near.schema.json",
 "title": "interest_near",
 "description": "Sent when the price comes within your chosen number of points of a level of interest, once per approach.",
 "allOf": [
  {
   "$ref": "envelope.schema.json"
  }
 ],
 "properties": {
  "type": {
   "const": "interest_near",
   "description": "`interest_near`."
  },
  "direction": {
   "enum": [
    "above",
    "below"
   ],
   "description": "The side of the level the price is on."
  },
  "threshold_points": {
   "type": "number",
   "description": "The size you picked."
  }
 },
 "x-when": [
  "The distance has held for twenty seconds.",
  "It re-arms only after the price has been more than twice that distance away."
 ],
 "x-features": [
  "level-alerts",
  "webhooks"
 ],
 "examples": [
  {
   "version": 1,
   "id": "evt_3f9a0c6e21d4b7a8e5f10c2d",
   "type": "interest_near",
   "symbol": "SPX",
   "level": {
    "kind": "level_of_interest",
    "value": 6750,
    "rank": "C1"
   },
   "price": 6741,
   "book": "volume+open_interest",
   "ts": "2026-10-21T10:35:05-04:00",
   "day": "2026-10-21",
   "levels": {
    "flip": 6715.5,
    "call_wall": 6750,
    "put_wall": 6700,
    "put_support": 6700
   },
   "text": "SPX came within 10.00 of C1 6,750.00 · VOL + OI",
   "direction": "below",
   "threshold_points": 10
  }
 ],
 "x-source": "alerts",
 "x-product": "live",
 "x-plan": "live",
 "x-version": 1,
 "x-since": "2026-10-21",
 "x-switch-on": "Account, Level alerts: a webhook address, and the levels of interest card on with the event, the symbol on that card.",
 "required": [
  "threshold_points"
 ]
}