# 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.

Source: https://firmtape.com/docs/developers/orders/latest

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 ORDERS · Key scope orders · Limit 20,000 calls a day on Orders API, 100,000 on Orders Team, per account · Version 1.0.0 · Since 2026-09-24

**This endpoint serves:** [ORDERS: Orders API and MCP](https://firmtape.com/docs/orders#orders-api), [ORDERS: The order ledger](https://firmtape.com/docs/orders#order-ledger). **Plan:** [ORDERS](https://firmtape.com/features/orders). Free on every finished session. Today's ledger, live, and the live POSITIONS check are the ORDERS plan.

## Response

The ledger.

| Field | Meaning | Unit |
| --- | --- | --- |
| `day` (string) | The ET trading day. |  |
| `sym` (string) | `SPX`: an order is placed against the measured book, which only SPX has. |  |
| `min_premium` (number) | The premium floor the ledger was built at. | USD |
| `asof` (string \| null) | When the ledger was last rebuilt, ET. |  |
| `orders` (array) | Sorted by what the order did to the book, largest first; unpriced orders after them. |  |
| `orders[].oid` (string) | Stable id of the parent order within the session. |  |
| `orders[].t` (string) | When the parent order printed, ET (`HH:MM`). |  |
| `orders[].g` (number \| 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[].kind` (string) | The structure, from package reconstruction rather than leg count: `vertical`, `straddle`, `iron_condor`, `single` and the rest. |  |
| `orders[].legs` (string) | The contract, for reading: `7740P/7750P`. |  |
| `orders[].lg` (array) | 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[].exp` (string \| null) | The expiry carrying most of the order's gamma. |  |
| `orders[].size` (integer \| null) | Contracts in the parent order. |  |
| `orders[].net` (number \| null) | Net premium; a spread at its net. | $M |
| `orders[].flip` (number \| null) | Index points from the zero-gamma flip at that minute. | index points |
| `orders[].side` (over \| under \| null) | Which side of the flip. |  |
| `stats` (object) | The whole session's counts, not the page returned. |  |
| `stats.n` (integer) | Orders above the floor. |  |
| `stats.net` (number) | Their net premium. | $M |
| `stats.no_side` (integer) | Orders the package rule could not orient. |  |
| `stats.no_gamma` (integer) | Orders it could not price. |  |
| `stats.gamma_up` (integer) | Orders that added gamma. |  |
| `stats.gamma_dn` (integer) | Orders that removed gamma. |  |
| `note` (string) | 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. |

## Request

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

```python
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])
```

```js
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());
```

## Example response

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

## Changes

- 2026-09-24: Added.