opening_read

Sent once a day per position when its alerts start: both sides' labels at that minute.

POSTyour https addressevent: opening_read

Plan ORDERSPayload unversionedSigned HMAC-SHA256Schema opening_read.schema.json

This event serves

Plan: ORDERS. Free on every finished session. Today's ledger, live, and the live POSITIONS check are the ORDERS plan. Pricing. Turn it on: The POSITIONS editor: Alert, WEBHOOK, an https address. On the Orders API and Team plans.

When it is sent

Once a day per position, at the first minute its alerts are on.

Payload

Field	Meaning	Unit
event"opening_read"	`opening_read`.
position_idstring	The position, `p_...`.
daystring	The ET trading day.
tstring	The minute judged, `HH:MM` ET.
checkobject	The same check `GET /api/positions/check` returns for the position: its phase, the expected move left, and per side the distances, the large orders near the short, the levels around it, the conditions and the label with its reason.

Delivery


Answer	Any 2xx within 3 seconds. Redirects are not followed.
Retries	One try; no retry.
Switched off	Never switched off; a failed send is logged.
Volume	One event per label change per side per day, and one opening read.
Test	`event: "test"`, from Send test in the editor
Log	None yet.

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

label_changed · test

Request we send

POST https://your.server/firmtape
Content-Type: application/json
User-Agent: FirmTape-Positions/1
X-FirmTape-Timestamp: 1760034725
X-FirmTape-Signature: sha256=9b1e...
X-FirmTape-Signature-V0: sha256=9b1e... (deprecated)

Body

{
  "event": "opening_read",
  "position_id": "p_4f2a9c",
  "day": "2026-10-09",
  "t": "13:35",
  "check": {
    "position_id": "p_4f2a9c"
  }
}

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/orders/events/opening_read.md.

opening_read

When it is sent

Payload

Delivery

Related events