Every day with a ledger

Every day an order ledger exists for, oldest first.

GET/orders/api/sessions

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

This endpoint serves

ORDERS: Orders API and MCP

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

Response

Oldest first.

Field	Meaning	Unit
sessionsarray	The days, `YYYY-MM-DD`.
firststring \| null	The oldest.
laststring \| null	The newest.

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-09-24 Added.

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

Request

curlPythonNode

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

import os, requests

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

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

Response

200401403429

{
  "sessions": [
    "2026-08-14",
    "2026-08-17"
  ],
  "first": "2026-08-14",
  "last": "2026-08-17"
}

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