List all account positions / SnapTrade

List all account positions

get

https://api.snaptrade.com/accounts/{accountId}/positions/all

Returns a list of all positions in the specified account.

The results list can contain multiple instrument types in the same response, including stocks, ADRs, ETFs, mutual funds, closed-end funds, bonds, crypto, futures, option positions, future option positions, CFD positions, and tokenized asset positions. Use the instrument.kind discriminator to determine the schema for each position's instrument.

Beta: future option positions (instrument.kind: future_option) are in beta. They are currently returned only for tastytrade and Interactive Brokers connections, and only for partners they have been enabled for — please contact the SnapTrade team to enable them. The FutureOptionInstrument schema may change.

Positions counted in account cash balance or buying power include cash_equivalent: true. stock, adr, etf, mutualfund, and crypto positions may include tax_lots when tax lot data is enabled for the account. To see which institutions support tax lot data, please see our supported institutions doc.

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 on how to fix a disabled connection.

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.

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.getAllAccountPositions(
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

Information about all account positions.

resultsarray of objects

Positions returned for the request.

instrumentobject

Instrument metadata for a V2 position. Use kind to determine which schema is present.

unitsstring (format: decimal) or null

The number of units held in the position. Positive numbers indicate long positions and negative numbers indicate short positions.

pricestring (format: decimal) or null

Last known market price per share. The freshness of this price depends on the brokerage. Some brokerages provide real-time prices, while others provide delayed prices. It is recommended that you rely on your own third-party market data provider for most up to date prices.

cost_basisstring (format: decimal) or null

Book price or average purchase price for the position. For options, this is per-share.

currencystring or null

ISO-4217 currency code for the position price and cost_basis.

cash_equivalentboolean

Present for mutual fund positions and for other instrument kinds when true. A true value means the position is also counted in cash balance or buying power.

tax_lotsarray of objects

List of tax lots for the given position. Disabled by default; enable via the Customer Dashboard Add-ons page. When enabled, this field is included only for stocks, ADRs, ETFs, mutual funds, and crypto positions. For these positions, an empty list means no tax lot data is available. Availability varies by brokerage and position. This field is omitted for all other instrument kinds or when the feature is disabled.

data_freshnessobject

Metadata describing freshness of the returned positions data.

1
{
2
  "results": [
3
    {
4
      "instrument": {
5
        "kind": "stock",
6
        "id": "1ef3a5d3-4a9b-40b2-b8d1-cc35f74d6324",
7
        "symbol": "AAPL",
8
        "raw_symbol": "AAPL",
9
        "description": "Apple Inc.",
10
        "currency": "USD",
11
        "exchange": "XNAS",
12
        "figi_instrument": {
13
          "figi_code": "BBG000B9Y5X2",
14
          "figi_share_class": "BBG001S5N8V8"
15
        }
16
      },
17
      "units": "10.5",
18
      "price": "123.45",
19
      "cost_basis": "118.2",
20
      "currency": "USD",
21
      "cash_equivalent": false,
22
      "tax_lots": [
23
        {
24
          "original_purchase_date": "2022-01-15T10:30:00.000Z",
25
          "quantity": "10",
26
          "purchased_price": "100.50",
27
          "cost_basis": "1005.00",
28
          "current_value": "1200.00",
29
          "position_type": "LONG",
30
          "lot_id": "12345678"
31
        }
32
      ]
33
    }
34
  ],
35
  "data_freshness": {
36
    "as_of": "2026-06-02T14:30:00.000Z"
37
  }
38
}