Account Information

List account holdings

Changed on Oct 23, 2026

Deprecated. Use the finer-grained account data endpoints instead: balances, positions, and orders.

This endpoint will return HTTP 410 Gone for all customers that sign up after May 11, 2026.

Returns a list of balances, positions, and recent orders for the specified account.

Check your API key on the Customer Dashboard billing page to see if you have real-time data access:

If you do, this endpoint returns real-time data.
If you don't, Daily data is cached and refreshed once a day. Exact refresh timing may vary by brokerage. If you need real-time, use the manual refresh endpoint.

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.

Concurrent live holdings requests for the same account fail immediately with HTTP 409 and error code 1166. Wait for the in-flight request to complete before retrying.

get/accounts/{accountId}/holdings

Request

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

Path parameters

accountIdstring uuid required

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

Example:917c8734-8470-4a3e-a18f-57c3f2ee6631

Query parameters

userIdstring 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.

Example:snaptrade-user-123

userSecretstring 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.

Example:adf2aa34-8219-40f7-a6b3-60156985cc61

Response

Example response

{
  "account": {
    "id": "917c8734-8470-4a3e-a18f-57c3f2ee6631",
    "brokerage_authorization": "87b24961-b51e-4db8-9226-f198f6518a89",
    "name": "Robinhood Individual",
    "number": "Q6542138443",
    "institution_account_id": "54953432",
    "institution_name": "Robinhood",
    "created_date": "2024-07-23T22:50:22.761390Z",
    "funding_date": "2024-07-25T12:00:00.000000Z",
    "opening_date": "2024-07-20T09:30:00.000000Z",
    "sync_status": {
      "transactions": {
        "initial_sync_completed": true,
        "last_successful_sync": "2022-01-24",
        "first_transaction_date": "2022-01-24"
      },
      "holdings": {
        "initial_sync_completed": true,
        "last_successful_sync": "2024-06-28 18:42:46.561408+00:00",
        "holdings_unavailable": true
      }
    },
    "balance": {
      "total": {
        "amount": 15363.23,
        "currency": "USD"
      }
    },
    "status": "open",
    "raw_type": "Margin",
    "account_category": "INVESTMENT",
    "meta": {
      "type": "Margin",
      "status": "ACTIVE",
      "institution_name": "Robinhood"
    },
    "portfolio_group": "2bcd7cc3-e922-4976-bce1-9858296801c3",
    "cash_restrictions": []
  },
  "balances": [
    {
      "currency": {
        "id": "87b24961-b51e-4db8-9226-f198f6518a89",
        "code": "USD",
        "name": "US Dollar"
      },
      "cash": 300.71,
      "buying_power": 410.71
    }
  ],
  "positions": [
    {
      "symbol": {
        "symbol": {
          "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
          "symbol": "VAB.TO",
          "raw_symbol": "VAB",
          "description": "VANGUARD CDN AGGREGATE BOND INDEX ETF",
          "currency": {
            "id": "87b24961-b51e-4db8-9226-f198f6518a89",
            "code": "USD",
            "name": "US Dollar"
          },
          "exchange": {
            "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
            "code": "TSX",
            "mic_code": "XTSE",
            "name": "Toronto Stock Exchange",
            "timezone": "America/New_York",
            "start_time": "09:30:00",
            "close_time": "16:00:00",
            "suffix": ".TO"
          },
          "type": {
            "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
            "code": "cs",
            "description": "Common Stock",
            "is_supported": true
          },
          "figi_code": "BBG000B9XRY4",
          "figi_instrument": {
            "figi_code": "BBG000B9Y5X2",
            "figi_share_class": "BBG001S5N8V8"
          },
          "currencies": [
            {
              "id": "87b24961-b51e-4db8-9226-f198f6518a89",
              "code": "USD",
              "name": "US Dollar"
            }
          ]
        },
        "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
        "description": "VANGUARD CDN AGGREGATE BOND INDEX ETF",
        "local_id": "3291231",
        "is_quotable": true,
        "is_tradable": true
      },
      "units": 40,
      "price": 113.15,
      "open_pnl": 0.44,
      "average_purchase_price": 108.3353,
      "fractional_units": 1.44,
      "currency": {
        "id": "87b24961-b51e-4db8-9226-f198f6518a89",
        "code": "USD",
        "name": "US Dollar"
      },
      "tax_lots": [
        {
          "original_purchase_date": "2022-01-15T10:30:00Z",
          "quantity": "10",
          "purchased_price": "100.50",
          "cost_basis": "1005.00",
          "current_value": "1200.00",
          "position_type": "LONG",
          "lot_id": "12345678"
        }
      ]
    }
  ],
  "option_positions": [
    {
      "symbol": {
        "option_symbol": {
          "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
          "ticker": "AAPL  261218C00240000",
          "option_type": "CALL",
          "strike_price": 240,
          "expiration_date": "2026-12-18",
          "underlying_symbol": {
            "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
            "symbol": "SPY",
            "raw_symbol": "VAB",
            "description": "SPDR S&P 500 ETF Trust",
            "currency": {
              "id": "87b24961-b51e-4db8-9226-f198f6518a89",
              "code": "USD",
              "name": "US Dollar"
            },
            "exchange": {
              "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
              "code": "ARCX",
              "mic_code": "ARCA",
              "name": "NYSE ARCA",
              "timezone": "America/New_York",
              "start_time": "09:30:00",
              "close_time": "16:00:00",
              "suffix": "None"
            },
            "type": {
              "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
              "code": "cs",
              "description": "Common Stock",
              "is_supported": true
            },
            "figi_code": "BBG000B9XRY4",
            "figi_instrument": {
              "figi_code": "BBG000B9Y5X2",
              "figi_share_class": "BBG001S5N8V8"
            },
            "currencies": [
              {
                "id": "87b24961-b51e-4db8-9226-f198f6518a89",
                "code": "USD",
                "name": "US Dollar"
              }
            ]
          }
        },
        "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
        "description": "SPY CALL 7/17 200"
      },
      "price": 38.4,
      "units": -50,
      "average_purchase_price": 4126,
      "currency": {
        "id": "87b24961-b51e-4db8-9226-f198f6518a89",
        "code": "USD",
        "name": "US Dollar"
      }
    }
  ],
  "orders": [
    {
      "brokerage_order_id": "66a033fa-da74-4fcf-b527-feefdec9257e",
      "brokerage_group_order_id": "1234567890",
      "order_role": "TRIGGER",
      "universal_symbol": {
        "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
        "symbol": "VAB.TO",
        "raw_symbol": "VAB",
        "description": "VANGUARD CDN AGGREGATE BOND INDEX ETF",
        "currency": {
          "id": "87b24961-b51e-4db8-9226-f198f6518a89",
          "code": "USD",
          "name": "US Dollar"
        },
        "exchange": {
          "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
          "code": "TSX",
          "mic_code": "XTSE",
          "name": "Toronto Stock Exchange",
          "timezone": "America/New_York",
          "start_time": "09:30:00",
          "close_time": "16:00:00",
          "suffix": ".TO"
        },
        "type": {
          "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
          "code": "cs",
          "description": "Common Stock",
          "is_supported": true
        },
        "figi_code": "BBG000B9XRY4",
        "figi_instrument": {
          "figi_code": "BBG000B9Y5X2",
          "figi_share_class": "BBG001S5N8V8"
        },
        "currencies": [
          {
            "id": "87b24961-b51e-4db8-9226-f198f6518a89",
            "code": "USD",
            "name": "US Dollar"
          }
        ]
      },
      "option_symbol": {
        "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
        "ticker": "AAPL  261218C00240000",
        "option_type": "CALL",
        "strike_price": 240,
        "expiration_date": "2026-12-18",
        "underlying_symbol": {
          "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
          "symbol": "SPY",
          "raw_symbol": "VAB",
          "description": "SPDR S&P 500 ETF Trust",
          "currency": {
            "id": "87b24961-b51e-4db8-9226-f198f6518a89",
            "code": "USD",
            "name": "US Dollar"
          },
          "exchange": {
            "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
            "code": "ARCX",
            "mic_code": "ARCA",
            "name": "NYSE ARCA",
            "timezone": "America/New_York",
            "start_time": "09:30:00",
            "close_time": "16:00:00",
            "suffix": "None"
          },
          "type": {
            "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
            "code": "cs",
            "description": "Common Stock",
            "is_supported": true
          },
          "figi_code": "BBG000B9XRY4",
          "figi_instrument": {
            "figi_code": "BBG000B9Y5X2",
            "figi_share_class": "BBG001S5N8V8"
          },
          "currencies": [
            {
              "id": "87b24961-b51e-4db8-9226-f198f6518a89",
              "code": "USD",
              "name": "US Dollar"
            }
          ]
        }
      },
      "quote_universal_symbol": {
        "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
        "symbol": "VAB.TO",
        "raw_symbol": "VAB",
        "description": "VANGUARD CDN AGGREGATE BOND INDEX ETF",
        "currency": {
          "id": "87b24961-b51e-4db8-9226-f198f6518a89",
          "code": "USD",
          "name": "US Dollar"
        },
        "exchange": {
          "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
          "code": "TSX",
          "mic_code": "XTSE",
          "name": "Toronto Stock Exchange",
          "timezone": "America/New_York",
          "start_time": "09:30:00",
          "close_time": "16:00:00",
          "suffix": ".TO"
        },
        "type": {
          "id": "2bcd7cc3-e922-4976-bce1-9858296801c3",
          "code": "cs",
          "description": "Common Stock",
          "is_supported": true
        },
        "figi_code": "BBG000B9XRY4",
        "figi_instrument": {
          "figi_code": "BBG000B9Y5X2",
          "figi_share_class": "BBG001S5N8V8"
        },
        "currencies": [
          {
            "id": "87b24961-b51e-4db8-9226-f198f6518a89",
            "code": "USD",
            "name": "US Dollar"
          }
        ]
      },
      "quote_currency": {
        "id": "87b24961-b51e-4db8-9226-f198f6518a89",
        "code": "USD",
        "name": "US Dollar"
      },
      "total_quantity": "100",
      "open_quantity": "10",
      "canceled_quantity": "10",
      "filled_quantity": "80",
      "execution_price": "12.34",
      "limit_price": "12.34",
      "stop_price": "12.50",
      "trailing_stop": {
        "amount": "0.60"
      },
      "order_type": "Market",
      "time_placed": "2024-07-30T22:51:49.746270Z",
      "time_updated": "2024-08-05T00:05:57.409000Z",
      "time_executed": "2024-08-05T00:05:57.409000Z",
      "expiry_date": "2024-08-05T00:05:57.409000Z",
      "symbol": "2bcd7cc3-e922-4976-bce1-9858296801c3",
      "child_brokerage_order_ids": {
        "take_profit_order_id": "12345678",
        "stop_loss_order_id": "12345678"
      }
    }
  ],
  "total_value": {
    "value": 32600.71,
    "currency": "USD"
  }
}

Changes

Oct 23, 202660be624d75b7 Revision changes
- warning
  added the new ANNUITY enum value to the / response property for the response status
Oct 14, 2026efd73af6c911 Revision changes
- breaking
  the / response's property type changed from object to no type for status
- breaking
  the // response's property type changed from object to no type for status
- breaking
  the response's property type changed from string to no type for status
- breaking
  the response's property type changed from string to no type for status
- breaking
  the response's property type changed from string to no type for status
- breaking
  the response's property type changed from string to no type for status
- breaking
  the response's property type changed from string to no type for status
- breaking
  the response's property type changed from string to no type for status
- breaking
  the response's property type changed from string to no type for status
- breaking
  the response's property type changed from string to no type for status
- breaking
  the response's property type changed from string to no type for status
- breaking
  the response's property type changed from string to no type for status
- breaking
  the response's property type changed from integer to no type for status
- breaking
  the response's property type changed from integer to no type for status

Operation history (15 revisions)