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

List account recent orders (V2, last 24 hours only)

BETA

get

https://api.snaptrade.com/api/v1/accounts/{accountId}/recentOrders/v2

A lightweight endpoint that returns a list of orders executed in the last 24 hours in the specified account using the V2 order format. 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 /orders in that it is 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. 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

Path

accountIdstring (format: uuid)required

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

Query

userIdstringrequired

SnapTrade User ID. This is chosen by the API partner and can be any string that is a) unique to the user, and b) immutable for the user. It is recommended to NOT use email addresses for this property because they are usually not immutable.

userSecretstringrequired

SnapTrade User Secret. This is a randomly generated string and should be stored securely. If compromised, please rotate it via the rotate user secret endpoint.

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

Authorization

clientId

consumerKey

Request

Installation

GitHub npm

npm install snaptrade-typescript-sdk

1
Loading...

Response fields

object

Contains a standardized list of account orders in the V2 format.

ordersarray of objects

List of orders returned by the endpoint.

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. Possible values include:

NONE
PENDING
ACCEPTED
FAILED
REJECTED
CANCELED
PARTIAL_CANCELED
CANCEL_PENDING
EXECUTED
PARTIAL
REPLACE_PENDING
REPLACED
EXPIRED
QUEUED
TRIGGERED
ACTIVATED

order_typestring or null

The type of order placed.

MARKET
LIMIT
STOP
STOP_LIMIT

time_in_forcestring

The Time in Force type for the order. This field indicates how long the order will remain active before it is executed or expires. We try our best to map brokerage time in force values to the following. When mapping fails, we will return the brokerage's time in force value.

DAY - Day. The order is valid only for the trading day on which it is placed.
GTC - Good Til Canceled. The order is valid until it is executed or canceled.
FOK - Fill Or Kill. The order must be executed in its entirety immediately or be canceled completely.
IOC - Immediate Or Cancel. The order must be executed immediately. Any portion of the order that cannot be filled immediately will be canceled.
GTD - Good Til Date. The order is valid until the specified date.
MOO - Market On Open. The order is to be executed at the day's opening price.
EHP - Extended Hours P.M. The order is to be placed during extended hour trading, after markets close.

time_placedstring (format: date-time)

The time the order was placed. This is the time the order was submitted to the brokerage.

time_executedstring (format: date-time) or null

The time the order was executed in the brokerage system. This value is not always available from the brokerage.

quote_currencystring

Quote currency code for the order.

execution_pricenumber or null

The price at which the order was executed.

limit_pricenumber or null

The limit price is maximum price one is willing to pay for a buy order or the minimum price one is willing to accept for a sell order. Should only apply to Limit and StopLimit orders.

stop_pricenumber or null

The stop price is the price at which a stop order is triggered. Should only apply to Stop and StopLimit orders.

legsarray of objects

List of legs that make up the order.

1
{
2
  "orders": [
3
    {
4
      "brokerage_order_id": "66a033fa-da74-4fcf-b527-feefdec9257e",
5
      "status": "NONE",
6
      "order_type": "MARKET",
7
      "time_in_force": "DAY",
8
      "time_placed": "2024-07-30T22:51:49.746Z",
9
      "time_executed": "2024-08-05T00:05:57.409Z",
10
      "quote_currency": "USD",
11
      "execution_price": 12.34,
12
      "limit_price": 12.34,
13
      "stop_price": 12.5,
14
      "legs": [
15
        {
16
          "leg_id": "string",
17
          "instrument": {
18
            "symbol": "AAPL",
19
            "description": "Apple Inc.",
20
            "asset_type": "EQUITY",
21
            "exchange_mic_code": "XNAS",
22
            "figi_code": "BBG000B9XRY4"
23
          },
24
          "action": "string",
25
          "execution_price": 12.34,
26
          "total_quantity": "10",
27
          "canceled_quantity": "1",
28
          "filled_quantity": "9",
29
          "status": "PENDING"
30
        }
31
      ]
32
    }
33
  ]
34
}

Made with Konfig