Check your positions at a minute

Each position judged at one market minute: only what was known at that minute, never anything later in the day.

GET/api/positions/check

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

This endpoint serves

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	Error
dayquery · string	`YYYY-MM-DD`.	today
tquery · string	`HH:MM` ET.	the latest minute
idquery · string	One position; without it, all of them.		`not_found`

Response

One check per position.

Field	Meaning	Unit
daystring	The ET trading day.
tstring \| null	The minute judged.
liveboolean	Whether the day is the live session.
checksarray	One per position.
checks[].position_idstring	The position.
checks[].errorstring	This position could not be checked right now.
notestring	When the day has no market minute yet.

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.
404	`not_found`	No position with this id. Check the path or the id.
429	`rate`	The day's calls are spent. Wait for midnight ET, when the count resets.

Every code: Errors.

Changes

2026-10-04 Added.

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

Request

curlPythonNode

curl \
  -H "Authorization: Bearer $FIRMTAPE_ORDERS_KEY" \
  "https://firmtape.com/api/positions/check"

import os, requests

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

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

Response

401403404429

{
  "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": "not_found",
    "message": "No such endpoint (levels API), or no position with this id on this account (POSITIONS)."
  }
}

{
  "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-check.md.