---
title: "List all account recent orders (last 24 hours only)"
method: GET
path: "/accounts/{accountId}/orders/recent"
tags: ["Account Information"]
---

# List all account recent orders (last 24 hours only)

`GET /accounts/{accountId}/orders/recent`

## Request

- Base URL: `https://api.snaptrade.com`
- URL: `https://api.snaptrade.com/accounts/{accountId}/orders/recent`
- Auth: API key in header `Signature` and API key in query parameter `clientId` and API key in query parameter `timestamp`

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](https://dashboard.snaptrade.com/settings/billing)**

## Path parameters

- `accountId` string, uuid, required: Unique identifier for the connected brokerage account. This is the UUID used to reference the account in SnapTrade.

## Query parameters

- `userId` string, required: 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.
- `userSecret` string, required: 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](/reference/Authentication/Authentication_resetSnapTradeUserSecret).
- `only_executed` boolean

## Response `200`

OK

- AllAccountOrdersResponse: A list of account orders together with the freshness of the returned data.
  - `results` AccountOrder[], required: Orders returned for the request.
    - `brokerage_order_id` string, required: Order ID returned by brokerage. This is the unique identifier for the order in the brokerage system.
    - `status` 'PENDING' | 'REJECTED' | 'CANCELED' | 'CANCEL_PENDING' | 'PARTIAL_CANCELED' | 'EXECUTED' | 'PARTIALLY_EXECUTED' | 'REPLACED' | 'REPLACE_PENDING' | 'EXPIRED', required: Indicates the status of an order. SnapTrade does a best effort to map brokerage statuses to statuses in this enum.
    - `order_type` union, required: The order type and the prices that belong to it. Use `kind` to determine which fields are present.
      - MarketOrderType: A market order. Executes at the best available price.
        - `kind` 'market', required
      - LimitOrderType: A limit order. For multi-leg orders `limit_price` is the net price per spread; see `price_effect` for its direction.
        - `kind` 'limit', required
        - `limit_price` string, decimal, required: The maximum price to pay for a buy, or the minimum price to accept for a sell.
      - StopOrderType: A stop order. Becomes a market order once `stop_price` is reached.
        - `kind` 'stop', required
        - `stop_price` string, decimal, required: The price at which the order is triggered.
      - StopLimitOrderType: A stop-limit order. Becomes a limit order at `limit_price` once `stop_price` is reached.
        - `kind` 'stop_limit', required
        - `stop_price` string, decimal, required: The price at which the order is triggered.
        - `limit_price` string, decimal, required: The limit price that applies once triggered.
      - TrailingStopOrderType: A trailing stop order. The stop price trails the market price by `trail`.
        - `kind` 'trailing_stop', required
        - `trail` TrailingStop, required: Trail configuration for trailing stop orders.
          - `amount` string, required: The trail amount. Interpreted as dollars if `type` is `DOLLAR`, or a percentage if `type` is `PERCENT`.
          - `type` 'DOLLAR' | 'PERCENT', required: Whether the trail `amount` is a dollar amount (`DOLLAR`) or a percentage (`PERCENT`). For example, if `amount` is "0.60" and `type` is `DOLLAR`, the stop price will trail the market price by $0.60. If `amount` is "5" and `type` is `PERCENT`, the stop price will trail the market price by 5%.
        - `stop_price` string, decimal, nullable: The current trigger price, when the brokerage reports it.
      - TrailingStopLimitOrderType: A trailing stop-limit order. The stop price trails the market price by `trail`; once triggered, a limit order at `limit_price` is placed.
        - `kind` 'trailing_stop_limit', required
        - `trail` TrailingStop, required: Trail configuration for trailing stop orders.
          - `amount` string, required: The trail amount. Interpreted as dollars if `type` is `DOLLAR`, or a percentage if `type` is `PERCENT`.
          - `type` 'DOLLAR' | 'PERCENT', required: Whether the trail `amount` is a dollar amount (`DOLLAR`) or a percentage (`PERCENT`). For example, if `amount` is "0.60" and `type` is `DOLLAR`, the stop price will trail the market price by $0.60. If `amount` is "5" and `type` is `PERCENT`, the stop price will trail the market price by 5%.
        - `limit_price` string, decimal, required: The limit price that applies once triggered.
        - `stop_price` string, decimal, nullable: The current trigger price, when the brokerage reports it.
      - OtherOrderType: An order type SnapTrade could not normalize, or a recognized type whose required price the brokerage did not report. The brokerage's own label is in `raw_type`.
        - `kind` 'other', required
        - `raw_type` string, required: The order type label as reported by the brokerage.
        - `limit_price` string, decimal, nullable
        - `stop_price` string, decimal, nullable
    - `time_in_force` 'DAY' | 'GTC' | 'FOK' | 'IOC' | 'GTD' | 'MOO' | 'EHP' | 'EHA' | 'OTHER', required: 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_date` string, date-time, nullable: When the order expires, for orders with a `time_in_force` of `GTD`.
    - `priced_in` union: The asset an order's prices are denominated in. Use `kind` to determine which schema is present.
      - CashInstrument: A fiat currency, identified by its ISO-4217 code.
        - `kind` 'cash', required: Type of security instrument.
        - `code` string, required: ISO-4217 code of the currency.
      - CryptoInstrument: Security instrument metadata for crypto positions.
        - `kind` 'crypto', required: Type of security instrument.
        - `id` string, uuid, required: Unique identifier for the instrument.
        - `symbol` string, required: The formatted trading symbol for the security.
        - `raw_symbol` string, required: The raw symbol without any exchange suffix.
        - `description` string, nullable: Human-readable description of the security.
        - `currency` string, nullable: ISO-4217 currency code for the security listing.
        - `exchange` string, nullable: Deprecated. Crypto instruments are not tied to a listing exchange, so this field is no longer populated and is omitted from responses. It will be removed in a future version.
        - `figi_instrument` FigiInstrument: Financial Instrument Global Identifier (FIGI) information for the security. See [OpenFIGI](https://www.openfigi.com/) for more information.
          - `figi_code` string, nullable: This identifier is unique per security per trading venue. See section 1.4.1 of the [FIGI Standard](https://www.openfigi.com/assets/local/figi-allocation-rules.pdf) for more information.
          - `figi_share_class` string, nullable: This enables users to link multiple FIGIs for the same security in order to obtain an aggregated view across all countries and all exchanges. For example, `AAPL` has a different FIGI for each exchange/trading venue it is traded on. The `figi_share_class` is the same for all of these FIGIs. See section 1.4.3 of the [FIGI Standard](https://www.openfigi.com/assets/local/figi-allocation-rules.pdf) for more information.
    - `price_effect` 'CREDIT' | 'DEBIT' | 'EVEN' | 'UNKNOWN', required: Direction of the net order price when applicable.
    - `total_quantity` string, decimal, nullable: Total quantity requested. For multi-leg orders this is the number of spreads, not the sum of leg quantities.
    - `filled_quantity` string, decimal, nullable: Quantity filled so far.
    - `canceled_quantity` string, decimal, nullable: Quantity canceled.
    - `open_quantity` string, decimal, nullable: Quantity still open (not yet filled or canceled).
    - `execution_price` string, decimal, nullable: Average execution price. Per unit for single-leg orders; net price per spread for multi-leg orders.
    - `time_placed` string, date-time, nullable: The time the order was submitted to the brokerage, when the brokerage reports it.
    - `time_updated` string, date-time, nullable: The time the order was last updated at the brokerage, when available.
    - `time_executed` string, date-time, nullable: The time the order was executed, when available.
    - `group` AccountOrderGroup: Links the orders that make up a complex order (OCO, OTO, OTOCO).
      - `id` string, required: Brokerage-assigned identifier shared by every order in the group.
      - `role` 'TRIGGER' | 'CONDITIONAL' | 'PEER': The role of an order within a complex order group (OCO, OTO, OTOCO).
    - `legs` AccountOrderLeg[], required: The legs that make up the order. Always has at least one entry.
      - `leg_id` string, nullable: Brokerage identifier for this leg, when the brokerage assigns one.
      - `instrument` union, required: Instrument metadata for a V2 position. Use `kind` to determine which schema is present.
        - StockInstrument: Security instrument metadata for stock positions.
          - `kind` 'stock', required: Type of security instrument.
          - `id` string, uuid, required: Unique identifier for the instrument.
          - `symbol` string, required: The formatted trading symbol for the security.
          - `raw_symbol` string, required: The raw symbol without any exchange suffix.
          - `description` string, nullable: Human-readable description of the security.
          - `currency` string, nullable: ISO-4217 currency code for the security listing.
          - `exchange` string, nullable: Exchange MIC code or exchange code for the security.
          - `figi_instrument` FigiInstrument: Financial Instrument Global Identifier (FIGI) information for the security. See [OpenFIGI](https://www.openfigi.com/) for more information.
            - `figi_code` string, nullable: This identifier is unique per security per trading venue. See section 1.4.1 of the [FIGI Standard](https://www.openfigi.com/assets/local/figi-allocation-rules.pdf) for more information.
            - `figi_share_class` string, nullable: This enables users to link multiple FIGIs for the same security in order to obtain an aggregated view across all countries and all exchanges. For example, `AAPL` has a different FIGI for each exchange/trading venue it is traded on. The `figi_share_class` is the same for all of these FIGIs. See section 1.4.3 of the [FIGI Standard](https://www.openfigi.com/assets/local/figi-allocation-rules.pdf) for more information.
        - OptionInstrument: Option instrument metadata for a V2 position.
          - `kind` 'option', required: Type of security instrument.
          - `id` string, uuid, required: Unique identifier for the option instrument.
          - `symbol` string, required: OCC symbol for the option contract.
          - `option_type` 'CALL' | 'PUT', required: Whether the contract is a call or put.
          - `strike_price` string, decimal, required: Strike price for the option contract.
          - `expiration_date` string, date, required: Expiration date of the option contract.
          - `multiplier` string, decimal, required: Number of underlying shares per contract. Standard options are 100, mini options are 10.
          - `description` string, nullable: Human-readable description of the option contract.
          - `underlying` union, required: The underlying instrument for an option.
            - StockInstrument: Security instrument metadata for stock positions.
              - …
            - CryptoInstrument: Security instrument metadata for crypto positions.
              - …
            - EtfInstrument: Security instrument metadata for ETF positions.
              - …
            - MutualFundInstrument: Security instrument metadata for mutual fund positions.
              - …
            - CefInstrument: Security instrument metadata for closed-end fund positions.
              - …
            - AdrInstrument: Security instrument metadata for ADR positions.
              - …
            - OtherInstrument: Security instrument metadata for bonds and other mapped security positions.
              - …
            - PreferredStockInstrument: Security instrument metadata for preferred stock positions. Preferred shares were previously returned with kind `other`.
              - …
        - CryptoInstrument: Security instrument metadata for crypto positions.
          - `kind` 'crypto', required: Type of security instrument.
          - `id` string, uuid, required: Unique identifier for the instrument.
          - `symbol` string, required: The formatted trading symbol for the security.
          - `raw_symbol` string, required: The raw symbol without any exchange suffix.
          - `description` string, nullable: Human-readable description of the security.
          - `currency` string, nullable: ISO-4217 currency code for the security listing.
          - `exchange` string, nullable: Deprecated. Crypto instruments are not tied to a listing exchange, so this field is no longer populated and is omitted from responses. It will be removed in a future version.
          - `figi_instrument` FigiInstrument: Financial Instrument Global Identifier (FIGI) information for the security. See [OpenFIGI](https://www.openfigi.com/) for more information.
            - `figi_code` string, nullable: This identifier is unique per security per trading venue. See section 1.4.1 of the [FIGI Standard](https://www.openfigi.com/assets/local/figi-allocation-rules.pdf) for more information.
            - `figi_share_class` string, nullable: This enables users to link multiple FIGIs for the same security in order to obtain an aggregated view across all countries and all exchanges. For example, `AAPL` has a different FIGI for each exchange/trading venue it is traded on. The `figi_share_class` is the same for all of these FIGIs. See section 1.4.3 of the [FIGI Standard](https://www.openfigi.com/assets/local/figi-allocation-rules.pdf) for more information.
        - FutureInstrument: Future instrument metadata for a V2 position.
          - `kind` 'future', required: Type of security instrument.
          - `id` string, uuid, required: Unique identifier for the future instrument.
          - `symbol` string, required: Display symbol for the future contract.
          - `root_symbol` string, required: Root symbol for the future contract.
          - `expiration_code` string, required: Exchange expiration code for the contract.
          - `expiration_date` string, date, nullable: Expiration date of the contract.
          - `multiplier` string, decimal, nullable: Multiplier for the future contract.
          - `currency` string, nullable: ISO-4217 currency code for the contract.
          - `exchange` string, nullable: Exchange MIC code or exchange code for the contract.
        - FutureOptionInstrument: Future option (option on a futures contract) instrument metadata for a V2 position. **Beta:** currently returned only for tastytrade and Interactive Brokers connections, and only for partners it has been enabled for. This schema may change.
          - `kind` 'future_option', required: Type of security instrument.
          - `id` string, uuid, required: Unique identifier for the future option instrument.
          - `symbol` string, required: Display symbol for the future option contract.
          - `option_type` 'CALL' | 'PUT', required: Whether the contract is a call or put.
          - `strike_price` string, decimal, required: Strike price for the option contract.
          - `expiration_date` string, date, required: Expiration date of the option contract.
          - `multiplier` string, decimal, nullable: Notional multiplier for the option contract.
          - `description` string, nullable: Human-readable description of the option contract.
          - `currency` string, nullable: ISO-4217 currency code for the contract.
          - `exchange` string, nullable: Exchange MIC code or exchange code for the contract.
          - `underlying` FutureInstrument, required: Future instrument metadata for a V2 position.
            - `kind` 'future', required: Type of security instrument.
            - `id` string, uuid, required: Unique identifier for the future instrument.
            - `symbol` string, required: Display symbol for the future contract.
            - `root_symbol` string, required: Root symbol for the future contract.
            - `expiration_code` string, required: Exchange expiration code for the contract.
            - `expiration_date` string, date, nullable: Expiration date of the contract.
            - `multiplier` string, decimal, nullable: Multiplier for the future contract.
            - `currency` string, nullable: ISO-4217 currency code for the contract.
            - `exchange` string, nullable: Exchange MIC code or exchange code for the contract.
        - EtfInstrument: Security instrument metadata for ETF positions.
          - `kind` 'etf', required: Type of security instrument.
          - `id` string, uuid, required: Unique identifier for the instrument.
          - `symbol` string, required: The formatted trading symbol for the security.
          - `raw_symbol` string, required: The raw symbol without any exchange suffix.
          - `description` string, nullable: Human-readable description of the security.
          - `currency` string, nullable: ISO-4217 currency code for the security listing.
          - `exchange` string, nullable: Exchange MIC code or exchange code for the security.
          - `figi_instrument` FigiInstrument: Financial Instrument Global Identifier (FIGI) information for the security. See [OpenFIGI](https://www.openfigi.com/) for more information.
            - `figi_code` string, nullable: This identifier is unique per security per trading venue. See section 1.4.1 of the [FIGI Standard](https://www.openfigi.com/assets/local/figi-allocation-rules.pdf) for more information.
            - `figi_share_class` string, nullable: This enables users to link multiple FIGIs for the same security in order to obtain an aggregated view across all countries and all exchanges. For example, `AAPL` has a different FIGI for each exchange/trading venue it is traded on. The `figi_share_class` is the same for all of these FIGIs. See section 1.4.3 of the [FIGI Standard](https://www.openfigi.com/assets/local/figi-allocation-rules.pdf) for more information.
        - MutualFundInstrument: Security instrument metadata for mutual fund positions.
          - `kind` 'mutualfund', required: Type of security instrument.
          - `id` string, uuid, required: Unique identifier for the instrument.
          - `symbol` string, required: The formatted trading symbol for the security.
          - `raw_symbol` string, required: The raw symbol without any exchange suffix.
          - `description` string, nullable: Human-readable description of the security.
          - `currency` string, nullable: ISO-4217 currency code for the security listing.
          - `exchange` string, nullable: Exchange MIC code or exchange code for the security.
          - `figi_instrument` FigiInstrument: Financial Instrument Global Identifier (FIGI) information for the security. See [OpenFIGI](https://www.openfigi.com/) for more information.
            - `figi_code` string, nullable: This identifier is unique per security per trading venue. See section 1.4.1 of the [FIGI Standard](https://www.openfigi.com/assets/local/figi-allocation-rules.pdf) for more information.
            - `figi_share_class` string, nullable: This enables users to link multiple FIGIs for the same security in order to obtain an aggregated view across all countries and all exchanges. For example, `AAPL` has a different FIGI for each exchange/trading venue it is traded on. The `figi_share_class` is the same for all of these FIGIs. See section 1.4.3 of the [FIGI Standard](https://www.openfigi.com/assets/local/figi-allocation-rules.pdf) for more information.
        - CefInstrument: Security instrument metadata for closed-end fund positions.
          - `kind` 'cef', required: Type of security instrument.
          - `id` string, uuid, required: Unique identifier for the instrument.
          - `symbol` string, required: The formatted trading symbol for the security.
          - `raw_symbol` string, required: The raw symbol without any exchange suffix.
          - `description` string, nullable: Human-readable description of the security.
          - `currency` string, nullable: ISO-4217 currency code for the security listing.
          - `exchange` string, nullable: Exchange MIC code or exchange code for the security.
          - `figi_instrument` FigiInstrument: Financial Instrument Global Identifier (FIGI) information for the security. See [OpenFIGI](https://www.openfigi.com/) for more information.
            - `figi_code` string, nullable: This identifier is unique per security per trading venue. See section 1.4.1 of the [FIGI Standard](https://www.openfigi.com/assets/local/figi-allocation-rules.pdf) for more information.
            - `figi_share_class` string, nullable: This enables users to link multiple FIGIs for the same security in order to obtain an aggregated view across all countries and all exchanges. For example, `AAPL` has a different FIGI for each exchange/trading venue it is traded on. The `figi_share_class` is the same for all of these FIGIs. See section 1.4.3 of the [FIGI Standard](https://www.openfigi.com/assets/local/figi-allocation-rules.pdf) for more information.
        - AdrInstrument: Security instrument metadata for ADR positions.
          - `kind` 'adr', required: Type of security instrument.
          - `id` string, uuid, required: Unique identifier for the instrument.
          - `symbol` string, required: The formatted trading symbol for the security.
          - `raw_symbol` string, required: The raw symbol without any exchange suffix.
          - `description` string, nullable: Human-readable description of the security.
          - `currency` string, nullable: ISO-4217 currency code for the security listing.
          - `exchange` string, nullable: Exchange MIC code or exchange code for the security.
          - `figi_instrument` FigiInstrument: Financial Instrument Global Identifier (FIGI) information for the security. See [OpenFIGI](https://www.openfigi.com/) for more information.
            - `figi_code` string, nullable: This identifier is unique per security per trading venue. See section 1.4.1 of the [FIGI Standard](https://www.openfigi.com/assets/local/figi-allocation-rules.pdf) for more information.
            - `figi_share_class` string, nullable: This enables users to link multiple FIGIs for the same security in order to obtain an aggregated view across all countries and all exchanges. For example, `AAPL` has a different FIGI for each exchange/trading venue it is traded on. The `figi_share_class` is the same for all of these FIGIs. See section 1.4.3 of the [FIGI Standard](https://www.openfigi.com/assets/local/figi-allocation-rules.pdf) for more information.
        - CfdInstrument: Canonical CFD wrapper instrument metadata for a V2 position.
          - `kind` 'cfd', required: Type of security instrument.
          - `id` string, uuid, required: Unique identifier for the canonical CFD instrument wrapper.
          - `symbol` string, required: Formatted symbol of the instrument underlying the CFD wrapper.
          - `raw_symbol` string, required: Raw symbol of the instrument underlying the CFD wrapper.
          - `description` string, nullable: Human-readable description of the instrument underlying the CFD wrapper.
          - `currency` string, nullable: ISO-4217 currency code for the instrument underlying the CFD wrapper.
          - `exchange` string, nullable: Exchange MIC code or exchange code for the instrument underlying the CFD wrapper.
          - `underlying_instrument` union, required: The underlying instrument referenced by a CFD contract.
            - StockInstrument: Security instrument metadata for stock positions.
              - …
            - CryptoInstrument: Security instrument metadata for crypto positions.
              - …
            - EtfInstrument: Security instrument metadata for ETF positions.
              - …
            - MutualFundInstrument: Security instrument metadata for mutual fund positions.
              - …
            - CefInstrument: Security instrument metadata for closed-end fund positions.
              - …
            - AdrInstrument: Security instrument metadata for ADR positions.
              - …
            - OtherInstrument: Security instrument metadata for bonds and other mapped security positions.
              - …
            - PreferredStockInstrument: Security instrument metadata for preferred stock positions. Preferred shares were previously returned with kind `other`.
              - …
        - TokenizedAssetInstrument: Canonical tokenized asset wrapper for a V2 position. Symbol and description duplicate the listed underlying's display metadata for convenience; they are not token-specific identifiers or labels. Currency and exchange metadata are provided only in underlying_instrument.
          - `kind` 'tokenized_asset', required: Type of security instrument.
          - `id` string, uuid, required: Unique identifier for the canonical tokenized asset wrapper.
          - `symbol` string, required: Display symbol of the underlying stock or ETF, not a token-specific ticker.
          - `description` string: Display name of the underlying stock or ETF, when available.
          - `underlying_instrument` union, required: The listed stock or ETF underlying a tokenized asset.
            - StockInstrument: Security instrument metadata for stock positions.
              - …
            - EtfInstrument: Security instrument metadata for ETF positions.
              - …
        - OtherInstrument: Security instrument metadata for bonds and other mapped security positions.
          - `kind` 'bond' | 'other', required: Type of security instrument.
          - `id` string, uuid, required: Unique identifier for the instrument.
          - `symbol` string, required: The formatted trading symbol for the security.
          - `raw_symbol` string, required: The raw symbol without any exchange suffix.
          - `description` string, nullable: Human-readable description of the security.
          - `currency` string, nullable: ISO-4217 currency code for the security listing.
          - `exchange` string, nullable: Exchange MIC code or exchange code for the security.
          - `figi_instrument` FigiInstrument: Financial Instrument Global Identifier (FIGI) information for the security. See [OpenFIGI](https://www.openfigi.com/) for more information.
            - `figi_code` string, nullable: This identifier is unique per security per trading venue. See section 1.4.1 of the [FIGI Standard](https://www.openfigi.com/assets/local/figi-allocation-rules.pdf) for more information.
            - `figi_share_class` string, nullable: This enables users to link multiple FIGIs for the same security in order to obtain an aggregated view across all countries and all exchanges. For example, `AAPL` has a different FIGI for each exchange/trading venue it is traded on. The `figi_share_class` is the same for all of these FIGIs. See section 1.4.3 of the [FIGI Standard](https://www.openfigi.com/assets/local/figi-allocation-rules.pdf) for more information.
        - CashInstrument: A fiat currency, identified by its ISO-4217 code.
          - `kind` 'cash', required: Type of security instrument.
          - `code` string, required: ISO-4217 code of the currency.
        - PreferredStockInstrument: Security instrument metadata for preferred stock positions. Preferred shares were previously returned with kind `other`.
          - `kind` 'preferred_stock', required: Type of security instrument.
          - `id` string, uuid, required: Unique identifier for the instrument.
          - `symbol` string, required: The formatted trading symbol for the security.
          - `raw_symbol` string, required: The raw symbol without any exchange suffix.
          - `description` string, nullable: Human-readable description of the security.
          - `currency` string, nullable: ISO-4217 currency code for the security listing.
          - `exchange` string, nullable: Exchange MIC code or exchange code for the security.
          - `figi_instrument` FigiInstrument: Financial Instrument Global Identifier (FIGI) information for the security. See [OpenFIGI](https://www.openfigi.com/) for more information.
            - `figi_code` string, nullable: This identifier is unique per security per trading venue. See section 1.4.1 of the [FIGI Standard](https://www.openfigi.com/assets/local/figi-allocation-rules.pdf) for more information.
            - `figi_share_class` string, nullable: This enables users to link multiple FIGIs for the same security in order to obtain an aggregated view across all countries and all exchanges. For example, `AAPL` has a different FIGI for each exchange/trading venue it is traded on. The `figi_share_class` is the same for all of these FIGIs. See section 1.4.3 of the [FIGI Standard](https://www.openfigi.com/assets/local/figi-allocation-rules.pdf) for more information.
      - `action` string, required: The action describes the intent or side of a trade. - BUY - SELL - BUY_COVER - SELL_SHORT - BUY_TO_OPEN - BUY_TO_CLOSE - SELL_TO_OPEN - SELL_TO_CLOSE
      - `total_quantity` string, decimal, nullable: Total number of shares or contracts for this leg. Can be a decimal for fractional orders.
      - `filled_quantity` string, decimal, nullable: Number of shares or contracts filled for this leg.
      - `canceled_quantity` string, decimal, nullable: Number of shares or contracts canceled for this leg.
      - `execution_price` string, decimal, nullable: Average execution price for this leg, when available.
      - `status` 'PENDING' | 'REJECTED' | 'CANCELED' | 'CANCEL_PENDING' | 'PARTIAL_CANCELED' | 'EXECUTED' | 'PARTIALLY_EXECUTED' | 'REPLACED' | 'REPLACE_PENDING' | 'EXPIRED': Indicates the status of an order. SnapTrade does a best effort to map brokerage statuses to statuses in this enum.
  - `data_freshness` object, required: Metadata describing freshness of the returned orders data.
    - `as_of` string, date-time, required: The time the returned orders data was fetched from the brokerage.

## Other responses

- `403`: Forbidden
- `429`: Rate limit exceeded. Check `X-RateLimit-Remaining` (customer-level) and `X-RateLimit-Account-Remaining` (account-level) to see which limit you hit, then wait for the matching `*-Reset` value before retrying. Not every header listed below appears on every operation. The `X-RateLimit-Account-*` headers are sent only where the per-account limit is enforced, and OAuth-authenticated requests never receive the customer-level `X-RateLimit-Limit`, `X-RateLimit-Remaining` or `X-RateLimit-Reset`. A separate per-authenticated-user limit, reported in no `X-RateLimit-*` header, covers OAuth-authenticated requests and signed requests not governed by the customer-level limit; it does not stack on top of that limit. So a 429 can arrive with every reported counter above zero — or with no `X-RateLimit-*` headers at all. Honour `Retry-After` in that case.
- `500`: Unexpected error
- `501`: Not Implemented - recent orders are not supported for this brokerage
- `503`: Service Unavailable - the brokerage connection is busy syncing (sync lock held) or the brokerage API is temporarily unavailable. Safe to retry.

## Changes

- **2026-11-12** `f20c6dd103e2`: 2 info
  - api tag `Account Information` added
  - api tag `Experimental endpoints` removed
- **2026-11-06** `c0fa6b2adb84`: 2 breaking, 5 info
  - the response property `results/items/price_effect` became nullable for the status `200`
  - the `results/items/price_effect` response's property type changed from `string` to no type for status `200`
  - added `#/components/schemas/AccountOrderPriceEffect` to the `results/items/price_effect` response property `allOf` list for the response status `200`
  - removed the `CREDIT` enum value from the `results/items/price_effect` response property for the response status `200`
  - …3 more
- **2026-11-06** `a29239e377a8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/passiv/apis/snaptrade/changes/accounts/:accountId/orders/recent/get.md)

---

[API](https://skmtc.dev/passiv/apis/snaptrade.md) - [All operations](https://skmtc.dev/passiv/apis/snaptrade/llms.txt) - [OpenAPI document](https://skmtc.dev/passiv/apis/snaptrade/revisions/f20c6dd103e2?raw)
