--- title: "List all account orders" method: GET path: "/accounts/{accountId}/orders/all" tags: ["Experimental endpoints"] --- # List all account orders `GET /accounts/{accountId}/orders/all` ## Request - Base URL: `https://api.snaptrade.com` - URL: `https://api.snaptrade.com/accounts/{accountId}/orders/all` - Auth: API key in header `Signature` and API key in query parameter `clientId` and API key in query parameter `timestamp` Returns a list of recent orders in the specified account, in the same `kind`-discriminated format as `/accounts/{accountId}/positions/all`. Every order carries a `legs` list with at least one leg. Each leg's `instrument` uses the same `Instrument` union as positions; switch on `instrument.kind` to know which fields are present. Multi-leg orders (spreads, strangles, covered calls) are a single order with multiple legs. Orders that belong to a complex order group (OCO, OTO, OTOCO) share a `group.id`. `order_type` is an object discriminated by `kind`. Each kind declares the price fields it requires (`limit_price` on `limit`, `stop_price` on `stop`, both on `stop_limit`, `trail` on `trailing_stop`), so a consumer never has to null-check a price that cannot exist for that kind. When the brokerage reports an order type we cannot normalize, `kind` is `other` and the brokerage's own label is in `raw_type`. **Experimental:** this endpoint may change without notice. If the connection has become disabled, it can no longer access the latest data from the brokerage, but will continue to return the last available cached state. Please see [this guide](/docs/fix-broken-connections) on how to fix a disabled connection. ## 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). - `state` 'all' | 'open' | 'executed' - `days` integer ## Response `200` OK - AllAccountOrdersResponse: Orders in the `kind`-discriminated format returned by `/accounts/{accountId}/orders/all`. - `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`. - `price_currency` string, nullable: ISO-4217 currency code the order prices are denominated in. For crypto pairs this is the quote asset (for example `USDC` for `ETH-USDC`). - `price_effect` 'CREDIT' | 'DEBIT' | 'EVEN' | 'UNKNOWN', required: 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. - `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. - … - 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. - … - 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. - `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 - `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 - `503`: Service Unavailable - the brokerage connection is busy syncing (sync lock held) or the brokerage API is temporarily unavailable. Safe to retry. ## Changes - **2026-10-23** `545027f11ed6`: 1 info - endpoint added [Operation history](https://skmtc.dev/passiv/apis/snaptrade/changes/accounts/:accountId/orders/all/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/60be624d75b7?raw)