v51

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-0175184292.5 KB

Transactions And Reporting

Get transaction history for a user

Deprecated. Use the account level endpoint instead, if possible.

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

Returns all historical transactions for the specified user and filtering criteria. It's recommended to use startDate and endDate to paginate through the data, as the response may be very large for accounts with a long history and/or a lot of activity. There's a max number of 10000 transactions returned per request.

There is no guarantee to the ordering of the transactions returned. Please sort the transactions based on the trade_date field if you need them in a specific order.

This endpoint returns Daily data. Daily data is cached and refreshed once a day. Exact refresh timing may vary by brokerage.

get/activities

Query parameters

startDatestring date

Date used to specify timeframe for a reporting call (in YYYY-MM-DD format). These dates are inclusive.

Example:2022-01-24

The start date (inclusive) of the transaction history to retrieve. If not provided, the default is the first transaction known to SnapTrade based on trade_date.

endDatestring date

Date used to specify timeframe for a reporting call (in YYYY-MM-DD format). These dates are inclusive.

Example:2022-01-24

The end date (inclusive) of the transaction history to retrieve. If not provided, the default is the last transaction known to SnapTrade based on trade_date.

accountsstring

Comma separated list of account IDs

Example:917c8734-8470-4a3e-a18f-57c3f2ee6631,65e839a3-9103-4cfb-9b72-2071ef80c5f2

Optional comma separated list of SnapTrade Account IDs used to filter the request to specific accounts. If not provided, the default is all known brokerage accounts for the user. The brokerageAuthorizations parameter takes precedence over this parameter.

brokerageAuthorizationsstring

Comma separated list of brokerage authorization IDs

Example:917c8734-8470-4a3e-a18f-57c3f2ee6631,65e839a3-9103-4cfb-9b72-2071ef80c5f2

Optional comma separated list of SnapTrade Connection (Brokerage Authorization) IDs used to filter the request to only accounts that belong to those connections. If not provided, the default is all connections for the user. This parameter takes precedence over the accounts parameter.

typestring

Example:BUY,SELL,DIVIDEND

Optional comma separated list of transaction types to filter by. SnapTrade does a best effort to categorize brokerage transaction types into a common set of values. Here are some of the most popular values:

BUY - Asset bought.
SELL - Asset sold.
DIVIDEND - Dividend payout.
SUBSTITUTE_DIVIDEND - Payment in lieu of a dividend.
CONTRIBUTION - Cash contribution.
WITHDRAWAL - Cash withdrawal.
REI - Dividend reinvestment.
INTEREST - Interest deposited into the account.
FEE - Fee withdrawn from the account.
OPTIONEXPIRATION - Option expiration event.
OPTIONASSIGNMENT - Option assignment event.
OPTIONEXERCISE - Option exercise event.
TRANSFER - Transfer of assets from one account to another

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

idstring

Unique identifier for the transaction. This is the ID used to reference the transaction in SnapTrade.

Please note that this ID can change if the transaction is deleted and re-added. Under normal circumstances, SnapTrade does not delete transactions. The only time this would happen is if SnapTrade re-fetches and reprocesses the data from the brokerage, which is rare. If you require a stable ID, please let us know and we can work with you to provide one.

pricenumber

The price of the security for the transaction. This is mostly applicable to BUY, SELL, and DIVIDEND transactions.

unitsnumber

The number of units of the security for the transaction. This is mostly applicable to BUY, SELL, and DIVIDEND transactions.

amountnumber nullable

The amount of the transaction denominated in currency. This can be positive or negative. In general, transactions that positively affect the account balance (like sell, deposits, dividends, etc) will have a positive amount, while transactions that negatively affect the account balance (like buy, withdrawals, fees, etc) will have a negative amount.

typestring

A string representing the type of transaction. SnapTrade does a best effort to categorize the brokerage transaction types into a common set of values. Here are some of the most popular values:

BUY - Asset bought.
SELL - Asset sold.
DIVIDEND - Dividend payout.
SUBSTITUTE_DIVIDEND - Payment in lieu of a dividend.
CONTRIBUTION - Cash contribution.
WITHDRAWAL - Cash withdrawal.
REI - Dividend reinvestment.
INTEREST - Interest deposited into the account.
FEE - Fee withdrawn from the account.
OPTIONEXPIRATION - Option expiration event. option_symbol contains the related option contract info.
OPTIONASSIGNMENT - Option assignment event. option_symbol contains the related option contract info.
OPTIONEXERCISE - Option exercise event. option_symbol contains the related option contract info.

option_typestring

If an option BUY or SELL transaction, this further specifies the type of action. The possible values are:

BUY_TO_OPEN
BUY_TO_CLOSE
SELL_TO_OPEN
SELL_TO_CLOSE

descriptionstring

A human-readable description of the transaction. This is usually the brokerage's description of the transaction.

trade_datestring date-time nullable

The recorded time for the transaction. The granularity of this timestamp depends on the brokerage. Some brokerages provide the exact time of the transaction, while others provide only the date. Please check the integrations page for the specific brokerage to see the granularity of the timestamps. Note that even though the field is named trade_date, it can represent any type of transaction, not just trades.

settlement_datestring date-time

The date on which the transaction is settled.

feenumber

Any fee associated with the transaction if provided by the brokerage.

fx_ratenumber nullable

The forex conversion rate involved in the transaction if provided by the brokerage. Used in cases where securities of one currency are purchased in a different currency, and the forex conversion is automatic. In those cases, price, amount and fee will be in the top level currency (activity -> currency)

institutionstring

The institution that the transaction is associated with. This is usually the brokerage name.

external_reference_idstring nullable

Reference ID from brokerage used to identify related transactions. For example if an order comprises of several transactions (buy, fee, fx), they can be grouped if they share the same external_reference_id

Example response

[
  {
    "id": "2f7dc9b3-5c33-4668-3440-2b31e056ebe6",
    "account": {
      "id": "917c8734-8470-4a3e-a18f-57c3f2ee6631",
      "name": "Robinhood Individual",
      "number": "Q6542138443",
      "institution_account_id": "54953432",
      "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
        }
      }
    },
    "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"
      }
    },
    "currency_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"
      }
    },
    "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"
          }
        ]
      }
    },
    "price": 0.4,
    "units": 5.2,
    "amount": 263.82,
    "currency": {
      "id": "87b24961-b51e-4db8-9226-f198f6518a89",
      "code": "USD",
      "name": "US Dollar"
    },
    "type": "BUY",
    "option_type": "BUY_TO_OPEN",
    "description": "WALT DISNEY UNIT DIST ON 21 SHS REC 12/31/21 PAY 01/06/22",
    "trade_date": "2024-03-22T16:27:55Z",
    "settlement_date": "2024-03-26T00:00:00Z",
    "fx_rate": 1.032,
    "institution": "Robinhood",
    "external_reference_id": "2f7dc9b3-5c33-4668-3440-2b31e056ebe6"
  }
]