List all account recent orders (last 24 hours only) / SnapTrade

Beta endpoint

This endpoint’s request and response schemas and behavior may change without advance notice.

List all account recent orders (last 24 hours only)

BETA

get

https://api.snaptrade.com/accounts/{accountId}/orders/recent

A lightweight endpoint that returns the latest page of orders placed in the last 24 hours in the specified account, in the same kind-discriminated format as /accounts/{accountId}/orders/all. For most brokerages, the default page size is 100 meaning the endpoint will return a max of 100 orders. This endpoint is realtime and can be used to quickly check if account state has recently changed due to an execution, or check status of recently placed orders. Differs from /accounts/{accountId}/orders/all in that it is always realtime, and only checks the last 24 hours as opposed to the last 30 days. By default only returns executed orders, but that can be changed by setting only_executed to false.

Every order carries a legs list with at least one leg; switch on legs[].instrument.kind and order_type.kind to know which fields are present. data_freshness.as_of is the time of this live request.

Beta: this endpoint and its response schema may change.

Because of the cost of realtime requests, each call to this endpoint incurs an additional charge. You can find the exact cost for your API key on the Customer Dashboard billing page

Execute an API Request

Authentication Method

Use commercial authentication when acting on behalf of your application and passing end-user credentials with requests that require them.

Credentials

clientId

consumerKey

userId

userSecret

Path

accountIdstring (format: uuid)required

Unique identifier for the connected brokerage account. This is the UUID used to reference the account in SnapTrade.

Query

only_executedboolean

Defaults to true. Indicates if request should fetch only executed orders. Set to false to retrieve non executed orders as well

Unset

False

True

Request

Installation

GitHub npm

npm install snaptrade-typescript-sdk

1
import {
2
  Snaptrade,
3
  SnaptradeAuth,
4
} from "snaptrade-typescript-sdk";
5

6
const snaptrade = new Snaptrade({
7
  auth: SnaptradeAuth.commercialApiKey({
8
    consumerKey: "CONSUMER_KEY",
9
    clientId: "CLIENT_ID",
10
  }),
11
});
12

13
const response =
14
  await snaptrade.accountInformation.getAllAccountRecentOrders(
15
    {
16
      accountId:
17
        "917c8734-8470-4a3e-a18f-57c3f2ee6631",
18
      userId: "USER_ID",
19
      userSecret: "USER_SECRET",
20
    },
21
  );
22
console.log(response.data);

Response fields

object

A list of account orders together with the freshness of the returned data.

resultsarray of objects

Orders returned for the request.

brokerage_order_idstring

Order ID returned by brokerage. This is the unique identifier for the order in the brokerage system.

statusstring

Indicates the status of an order. SnapTrade does a best effort to map brokerage statuses to statuses in this enum.

order_typeobject

The order type and the prices that belong to it. Use kind to determine which fields are present.

time_in_forcestring

How long the order remains active. Brokerage values that cannot be mapped to this list are returned as OTHER.

DAY - valid only for the trading day on which it is placed.
GTC - Good Til Canceled.
FOK - Fill Or Kill.
IOC - Immediate Or Cancel.
GTD - Good Til Date; see expiry_date.
MOO - Market On Open.
EHP - Extended Hours P.M.
EHA - Extended Hours A.M.
OTHER - the brokerage reported a value outside this list.

expiry_datestring (format: date-time) or null

When the order expires, for orders with a time_in_force of GTD.

priced_inobject or null

The asset the order prices (execution_price and the prices inside order_type) are denominated in. Use kind to determine which schema is present.

cash - a fiat currency identified by its ISO-4217 code. This is the case for equities, options, futures, forex and crypto pairs quoted in fiat (for example USD for BTC-USD).
crypto - a crypto asset, for crypto pairs quoted in another crypto asset, including stablecoins (for example USDC for ETH-USDC or BTC for ETH-BTC). null when the quote asset could not be determined.

price_effectstring or null

Direction of the net order price. CREDIT means cash is received, DEBIT means cash is paid, EVEN means the net price is zero, and UNKNOWN means the direction could not be determined. Null when not applicable, for example for orders containing an outright futures leg (instrument.kind of future). A futures price is a contract quote, not an upfront cash flow. Futures options retain their price effect.

total_quantitystring (format: decimal) or null

Total quantity requested. For multi-leg orders this is the number of spreads, not the sum of leg quantities.

filled_quantitystring (format: decimal) or null

Quantity filled so far.

canceled_quantitystring (format: decimal) or null

Quantity canceled.

open_quantitystring (format: decimal) or null

Quantity still open (not yet filled or canceled).

execution_pricestring (format: decimal) or null

Average execution price. Per unit for single-leg orders; net price per spread for multi-leg orders.

time_placedstring (format: date-time) or null

The time the order was submitted to the brokerage, when the brokerage reports it.

time_updatedstring (format: date-time) or null

The time the order was last updated at the brokerage, when available.

time_executedstring (format: date-time) or null

The time the order was executed, when available.

groupobject or null

Set when this order belongs to a complex order group (OCO, OTO, OTOCO). Null otherwise.

legsarray of objects

The legs that make up the order. Always has at least one entry.

data_freshnessobject

Metadata describing freshness of the returned orders data.

1
{
2
  "results": [
3
    {
4
      "brokerage_order_id": "66a033fa-da74-4fcf-b527-feefdec9257e",
5
      "status": "PENDING",
6
      "order_type": {
7
        "kind": "market"
8
      },
9
      "time_in_force": "DAY",
10
      "expiry_date": "2026-07-30T22:51:49Z",
11
      "priced_in": {
12
        "kind": "cash",
13
        "code": "EUR"
14
      },
15
      "price_effect": "CREDIT",
16
      "total_quantity": "10",
17
      "filled_quantity": "9",
18
      "canceled_quantity": "1",
19
      "open_quantity": "0",
20
      "execution_price": "12.34",
21
      "time_placed": "2026-07-30T22:51:49Z",
22
      "time_updated": "2026-07-30T22:52:10Z",
23
      "time_executed": "2026-08-05T00:05:57Z",
24
      "group": {
25
        "id": "1234567890",
26
        "role": "TRIGGER"
27
      },
28
      "legs": [
29
        {
30
          "leg_id": "string",
31
          "instrument": {
32
            "kind": "stock",
33
            "id": "1ef3a5d3-4a9b-40b2-b8d1-cc35f74d6324",
34
            "symbol": "AAPL",
35
            "raw_symbol": "AAPL",
36
            "description": "Apple Inc.",
37
            "currency": "USD",
38
            "exchange": "XNAS",
39
            "figi_instrument": {
40
              "figi_code": "BBG000B9Y5X2",
41
              "figi_share_class": "BBG001S5N8V8"
42
            }
43
          },
44
          "action": "string",
45
          "total_quantity": "10",
46
          "filled_quantity": "9",
47
          "canceled_quantity": "1",
48
          "execution_price": "12.34",
49
          "status": "PENDING"
50
        }
51
      ]
52
    }
53
  ],
54
  "data_freshness": {
55
    "as_of": "2026-06-02T14:30:00Z"
56
  }
57
}