A position's label track

One position's label minute by minute over the hour up to t.

GET/api/positions/track

Plan ORDERSKey scope ordersLimit 20,000 calls a day on Orders API, 100,000 on Orders Team, per accountVersion 1.0.0Since 2026-10-05

This endpoint serves

ORDERS: Label track

Plan: ORDERS. Free on every finished session. Today's ledger, live, and the live POSITIONS check are the ORDERS plan. Pricing.

Parameters

Name	What it does	Default
idrequiredquery · string	The position.
dayquery · string	`YYYY-MM-DD`.	today
tquery · string	`HH:MM` ET.

Response

{ day, t, id, from, points }.

Field	Meaning	Unit
daystring	The day.
tstring \| null	The last minute.
idstring	The position.
fromstring \| null	The first minute.
pointsarray	One point a minute.

Errors

Status	Code	What to do
401	`no_key`	No key, or a revoked one. Send `Authorization: Bearer <key>` with a key of the product's scope.
403	`plan`	The account is not on the Orders API or Team plan. Move to the Orders API or Team plan.
429	`rate`	The day's calls are spent. Wait for midnight ET, when the count resets.

Every code: Errors.

Changes

2026-10-05 Added.

OpenAPI operation positionsTrack in /docs/developers/openapi.json.

Request

curlPythonNode

curl \
  -H "Authorization: Bearer $FIRMTAPE_ORDERS_KEY" \
  "https://firmtape.com/api/positions/track?id=p_4f2a9c"

import os, requests

H = {"Authorization": f"Bearer {os.environ['FIRMTAPE_ORDERS_KEY']}"}
r = requests.get("https://firmtape.com/api/positions/track?id=p_4f2a9c", headers=H)
print(r.status_code, r.text[:500])

const r = await fetch("https://firmtape.com/api/positions/track?id=p_4f2a9c", {
  method: "GET",
  headers: { Authorization: `Bearer ${process.env.FIRMTAPE_ORDERS_KEY}` },
});
console.log(r.status, await r.text());

Response

401403429

{
  "error": {
    "code": "no_key",
    "message": "No key was sent (Orders: no key, or one that is unknown or revoked)."
  }
}

{
  "error": {
    "code": "plan",
    "message": "The key is real; the account is not on the Orders API or Team plan."
  }
}

{
  "error": {
    "code": "rate",
    "message": "The account's calls for the day are spent."
  }
}

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/positions-track.md.