level_line

Sent when the price crosses a level line, a line that follows the flip, the call wall or the put wall wherever it stands.

POSTyour https addressX-FirmTape-Event: level_line

Plan LIVEPayload version 1Signed HMAC-SHA256Schema level_line.schema.json

This event serves

Plan: LIVE. LIVE: today's session every second, alerts, ASK, the levels API and the platform integrations, and 5 LAB credits a month. Every finished session is free in REPLAY. Pricing. Turn it on: Set the line on the chart or a ladder row; a webhook address on Account, Level alerts.

When it is sent

At the first reading that shows the cross.
The line follows its level at each reading, so a moved wall carries the line with it.

Payload

Field	Meaning	Unit
version1	Payload version, `1`.
idstring	Event id, `evt_` and 24 hex digits. The same on every try and for every account the event goes to: drop one you have seen.
type"level_line"	`level_line`.
symbolstring	SPX, ES, NQ, RTY or a ticker.
levelobject	The level the event is about.
level.kindflip \| call_wall \| put_wall \| net_gamma \| price \| null	`flip`, `call_wall`, `put_wall`, `net_gamma`, or `price` for a price line.
level.valuenumber \| null	Its value at the event.	index points
level.fromnumber \| null	Moves: where it stood before.	index points
pricenumber \| null	The price at the event. Null on a `premarket` event (see `phase`).	index points
bookvolume \| measured	`volume`: the volume book's levels.
tsstring	When it was found, ISO 8601 in New York time.
daystring	The ET trading day.
levelsobject	The volume book's levels at the event.
levels.flipnumber \| null	Flip.	index points
levels.call_wallnumber \| null	Call wall.	index points
levels.put_wallnumber \| null	Put wall.	index points
levels.put_supportdeprecatednumber \| null	The put wall under its first name. Deprecated: read `put_wall`; removed after 2026-11-30.	index points
textstring	The sentence Telegram and push show.
directionabove \| below	Which way the price crossed.
threshold_pointsnumber	Sized events (`flip_move`, `level_near`): the size the account picked, SPX points.	index points
fromstring	ES, NQ, RTY: the index whose book moved by the basis gives the levels.
basisnumber \| null	ES, NQ, RTY: the basis at the event.	index points
levels_asofstring \| null	Symbols on a five-minute book: when that book was built.
phasepremarket	Present only when a price line fired before the bell, from 04:00 ET to the open on a trading day: `premarket`. The line was crossed on the premarket's minute prices; `price` is then null, and `levels` are the previous session's closing levels. Absent on every event in the session.
alertobject	The line that fired.

Delivery


Answer	Any 2xx within 3 seconds. Redirects are not followed.
Retries	No answer, a 429 or a 5xx: tried again after 1 s and 4 s, three tries in all, the same id each time.
Switched off	After 10 failed events in a row; the account page shows why. Saving the address switches it on again.
Volume	Up to 30 events a minute per account; past that they are dropped and counted on the account page.
Test	`type: "test"`, from Send test
Log	The last delivery (time, status, tries) on the account page.

Verify every request before reading it: Webhooks: verify the signature.

flip_cross · wall_break · regime_change · wall_move · flip_move · level_near · price_alert · order · test

Request we send

POST https://your.server/firmtape
Content-Type: application/json
User-Agent: FirmTape-Webhooks/1
X-FirmTape-Event: level_line
X-FirmTape-Event-Id: evt_3f9a0c6e21d4b7a8e5f10c2d
X-FirmTape-Timestamp: 1760034725
X-FirmTape-Signature: sha256=9b1e...

Body

{
  "version": 1,
  "id": "evt_3f9a0c6e21d4b7a8e5f10c2d",
  "type": "level_line",
  "symbol": "SPX",
  "price": 6750.75,
  "book": "volume",
  "ts": "2026-10-09T14:32:05-04:00",
  "day": "2026-10-09",
  "levels": {
    "flip": 6715.5,
    "call_wall": 6750,
    "put_wall": 6700,
    "put_support": 6700
  },
  "level": {
    "kind": "call_wall",
    "value": 6750
  },
  "direction": "above",
  "text": "SPX crossed above the call wall 6,750.00, your level line",
  "alert": {
    "id": "al_6a7b8c9d0e1f",
    "kind": "level",
    "level": "call_wall",
    "price": null,
    "mode": "repeat"
  }
}

Verify

NodePython

const crypto = require("node:crypto");
// rawBody: the request body as received, a Buffer or a string, before any JSON parsing
function verify(rawBody, headers, secret) {
  const t = headers["x-firmtape-timestamp"];
  const got = String(headers["x-firmtape-signature"] || "");
  if (!t || Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const want = "sha256=" + crypto.createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
  return got.length === want.length && crypto.timingSafeEqual(Buffer.from(got), Buffer.from(want));
}

import hmac, hashlib, time

def verify(raw_body: bytes, headers, secret: str) -> bool:
    t = headers.get("X-FirmTape-Timestamp", "")
    got = headers.get("X-FirmTape-Signature", "")
    if not t or abs(time.time() - int(t)) > 300:
        return False
    want = "sha256=" + hmac.new(secret.encode(), t.encode() + b"." + raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(got, want)

Measurements of dealer positioning, never a forecast or a trade call. This page is built from FirmTape's public contract, the same files the OpenAPI document is built from; the tests hold them against the route code. Markdown: /docs/developers/live/events/level_line.md.

level_line

When it is sent

Payload

Delivery

Related events