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, crypto, futures, option positions, and CFD positions. Use the instrument.kind discriminator to determine the schema for each position's instrument.

mutualfund positions may also include cash_equivalent. stock, etf, and mutualfund positions may include tax_lots when tax lot data is enabled for the account.

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 that are also counted in cash balance or buying power.

tax_lotsarray of objects

List of tax lots for the given position (disabled by default, only available on paid plans, contact support if needed)

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
}