The newest session's order ledger

The newest session the ledger has: today's while the market is open, the last finished one after the close.

GET/orders/api/latest

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

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

Response

The ledger.

Field	Meaning	Unit
daystring	The ET trading day.
symstring	`SPX`: an order is placed against the measured book, which only SPX has.
min_premiumnumber	The premium floor the ledger was built at.	USD
asofstring \| null	When the ledger was last rebuilt, ET.
ordersarray	Sorted by what the order did to the book, largest first; unpriced orders after them.
orders[].oidstring	Stable id of the parent order within the session.
orders[].tstring	When the parent order printed, ET (`HH:MM`).
orders[].gnumber \| null	Dealer gamma the order ADDED, $M per index point. Null when it could not be priced (usually inside the last half hour of its own expiry). Null is not zero.	$M per index point
orders[].kindstring	The structure, from package reconstruction rather than leg count: `vertical`, `straddle`, `iron_condor`, `single` and the rest.
orders[].legsstring	The contract, for reading: `7740P/7750P`.
orders[].lgarray	The legs as data: `[strike, "C" \| "P", sign]`. The sign is what the package rule concluded the CUSTOMER did; 0 means it could not tell, never flat.
orders[].expstring \| null	The expiry carrying most of the order's gamma.
orders[].sizeinteger \| null	Contracts in the parent order.
orders[].netnumber \| null	Net premium; a spread at its net.	$M
orders[].flipnumber \| null	Index points from the zero-gamma flip at that minute.	index points
orders[].sideover \| under \| null	Which side of the flip.
statsobject	The whole session's counts, not the page returned.
stats.ninteger	Orders above the floor.
stats.netnumber	Their net premium.	$M
stats.no_sideinteger	Orders the package rule could not orient.
stats.no_gammainteger	Orders it could not price.
stats.gamma_upinteger	Orders that added gamma.
stats.gamma_dninteger	Orders that removed gamma.
notestring	Present when the day has no ledger yet: the list is empty and this says so. Not an error.

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 ordersLatest in /docs/developers/openapi.json.

Request

curlPythonNode

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

import os, requests

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

const r = await fetch("https://firmtape.com/orders/api/latest", {
  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/latest.md.