product features
Understand a user’s investments
Understand a user’s investments

Gain insight into a user’s investment accounts, including account balances, holdings, and transactions that create a change in a holding

feature-investments-2 image
Expansive institution coverage

Retrieve investment data from a broad coverage network that includes banks, brokerages, crypto exchanges, credit unions, and retirement plan providers

Full breadth of account types
Full breadth of account types

Connect to the full breadth of investment account types—from brokerage and retirement accounts, crypto exchanges, self custody wallets, to 529s and HSAs

Multiple endpoints

With multiple endpoints, Investments can enable a wide range of use cases—from net worth assessment and financial planning, to performance reporting and risk optimization

Retrieve Holdings response

http code 200
{
  "accounts": [{object}],
  "securities": [{
    "id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
    "isin": "US85207UAE55",
    "cusip": "85207UAE5",
    "sedol": null,
    "institution_security_id": null,
    "institution_id": "ins_102937",
    "proxy_security_id": null,
    "name": "Sprint Corporation",
    "ticker_symbol": "S",
    "is_cash_equivalent": false,
    "type": "equity",
    "close_price": 6.10,
    "close_price_as_of": "2019-04-16",
    "iso_currency_code": "USD",
    "unofficial_currency_code": null
  }, {
    "id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "isin": null,
    "cusip": null,
    "sedol": null,
    "institution_security_id": "VGSLX",
    "institution_id": "ins_115616",
    "proxy_security_id": null,
    "name": "Vanguard Real Estate Index",
    "ticker_symbol": null,
    "is_cash_equivalent": false,
    "type": "mutual fund",
    "close_price": 26.44,
    "close_price_as_of": "2019-04-15",
    "iso_currency_code": "USD",
    "unofficial_currency_code": null
  }],
  "holdings": [{
    "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
    "security_id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
    "cost_basis": 4.28,
    "quantity": 2104.07,
    "institution_price": 6.09,
    "institution_price_as_of": "2019-04-19",
    "institution_value": 12813.79,
    "iso_currency_code": "USD",
    "unofficial_currency_code": null
  }, {
    "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
    "security_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "cost_basis": 22.32,
    "quantity": 150.00,
    "institution_price": 26.44,
    "institution_price_as_of": "2019-04-19",
    "institution_value": 3348,
    "iso_currency_code": "USD",
    "unofficial_currency_code": null
  }],
}

Retrieve Investment Holdings data

The /investments/holdings/get endpoint returns a detailed breakdown of an account’s holdings, including quantity, price, total value, ticker, and common name

cost_basis

Total cost of acquiring the holding—this is a summation of all purchases of the security, including fees

quantity

The count of the security purchased

institution_price

The price of the security, according to the institution

institution_value

The value of the holding, according to the institution

securities

Definitions for the securities referenced by these holdings, including standardized identifiers, trading symbols, and classifications

Retrieve Investment Holdings data

The /investments/holdings/get endpoint returns a detailed breakdown of an account’s holdings, including quantity, price, total value, ticker, and common name

Retrieve Holdings response

http code 200
{
  "accounts": [{object}],
  "securities": [{
    "id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
    "isin": "US85207UAE55",
    "cusip": "85207UAE5",
    "sedol": null,
    "institution_security_id": null,
    "institution_id": "ins_102937",
    "proxy_security_id": null,
    "name": "Sprint Corporation",
    "ticker_symbol": "S",
    "is_cash_equivalent": false,
    "type": "equity",
    "close_price": 6.10,
    "close_price_as_of": "2019-04-16",
    "iso_currency_code": "USD",
    "unofficial_currency_code": null
  }, {
    "id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "isin": null,
    "cusip": null,
    "sedol": null,
    "institution_security_id": "VGSLX",
    "institution_id": "ins_115616",
    "proxy_security_id": null,
    "name": "Vanguard Real Estate Index",
    "ticker_symbol": null,
    "is_cash_equivalent": false,
    "type": "mutual fund",
    "close_price": 26.44,
    "close_price_as_of": "2019-04-15",
    "iso_currency_code": "USD",
    "unofficial_currency_code": null
  }],
  "holdings": [{
    "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
    "security_id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
    "cost_basis": 4.28,
    "quantity": 2104.07,
    "institution_price": 6.09,
    "institution_price_as_of": "2019-04-19",
    "institution_value": 12813.79,
    "iso_currency_code": "USD",
    "unofficial_currency_code": null
  }, {
    "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
    "security_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "cost_basis": 22.32,
    "quantity": 150.00,
    "institution_price": 26.44,
    "institution_price_as_of": "2019-04-19",
    "institution_value": 3348,
    "iso_currency_code": "USD",
    "unofficial_currency_code": null
  }],
}

cost_basis

Total cost of acquiring the holding—this is a summation of all purchases of the security, including fees

quantity

The count of the security purchased

institution_price

The price of the security, according to the institution

institution_value

The value of the holding, according to the institution

securities

Definitions for the securities referenced by these holdings, including standardized identifiers, trading symbols, and classifications

Retrieve Investment Transactions data

The /investments/transactions/get endpoint returns details on transactions that create a change in one or more holdings in a portfolio, such as buys, sells, splits, or dividends. Cash transfers in and out of an investment account are also returned

name

Description of the transaction, taken from the institution

quantity

Amount of the security that is moved in the transaction

amount

The value of the transaction = price * quantity

price

The price of the security for this transaction

type

A broad transaction type that informs the treatment of the transaction

securities

Definitions for the securities referenced by these holdings, including standardized identifiers, trading symbols, and classifications

Retrieve Investment Transactions response

http code 200
{
  "accounts": [{object}],
  "securities": [{
    "id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
    "isin": "US85207UAE55",
    "cusip": "85207UAE5",
    "sedol": null,
    "institution_security_id": null,
    "institution_id": "ins_102937",
    "proxy_security_id": null,
    "name": "Sprint Corporation",
    "ticker_symbol": "S",
    "is_cash_equivalent": false,
    "type": "equity",
    "close_price": 6.10,
    "close_price_as_of": "2019-04-16",
    "iso_currency_code": "USD",
    "unofficial_currency_code": null
   }, {
    "id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "isin": null,
    "cusip": null,
    "sedol": null,
    "institution_security_id": "VGSLX",
    "institution_id": "ins_115616",
    "proxy_security_id": null,
    "name": "Vanguard Real Estate Index",
    "ticker_symbol": null,
    "is_cash_equivalent": false,
    "type": "mutual fund",
    "close_price": 26.44,
    "close_price_as_of": "2019-04-15",
    "iso_currency_code": "USD",
    "unofficial_currency_code": null
  }],
  "investment_transactions": [{
    "investment_transaction_id": "VaYBeiw3H9AhAHw53vQYkmkn2s2qJOGcY9hhs",
    "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
    "security_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "cancel_transaction_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "date": "2019-01-12",
    "name": "Dividend VANGUARD FEDERAL MONEY MARKET FUND (Settlement Fund)",
    "quantity": 0.84,
    "amount": 0.84,
    "price": 1,
    "fees": 0,
    "type": "cash",
    "subtype": "dividend",
    "iso_currency_code": "USD",
    "unofficial_currency_code": null
  }, {
    "investment_transaction_id": "VaYBeiw3H9AhAHw53vQYkmkn2s2qJOGcY9asd",
    "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
    "security_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "cancel_transaction_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0D1o3Q",
    "date": "2018-12-18",
    "name": "VANGUARD WINDSOR INVESTOR CL",
    "quantity": 146.915,
    "amount": 3000,
    "price": 20.42,
    "fees": 0,
    "type": "buy",
    "subtype": "contribution",
    "iso_currency_code": "USD",
    "unofficial_currency_code": null
  }, {
    "investment_transaction_id": "VaYBeiw3H9AhAHw53vQYkmkn2s2qJOGcH2xvv",
    "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
    "security_id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
    "cancel_transaction_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr1X8B2w5X",
    "date": "2018-10-30",
    "name": "SPRINT CORPORATION",
    "quantity": 372,
    "amount": 2118.91,
    "price": 5.68,
    "fees": 5.95,
    "type": "buy",
    "subtype": "buy",
    "iso_currency_code": "USD",
    "unofficial_currency_code": null
  }]
}

Retrieve Investment Transactions data

The /investments/transactions/get endpoint returns details on transactions that create a change in one or more holdings in a portfolio, such as buys, sells, splits, or dividends. Cash transfers in and out of an investment account are also returned

Retrieve Investment Transactions response

http code 200
{
  "accounts": [{object}],
  "securities": [{
    "id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
    "isin": "US85207UAE55",
    "cusip": "85207UAE5",
    "sedol": null,
    "institution_security_id": null,
    "institution_id": "ins_102937",
    "proxy_security_id": null,
    "name": "Sprint Corporation",
    "ticker_symbol": "S",
    "is_cash_equivalent": false,
    "type": "equity",
    "close_price": 6.10,
    "close_price_as_of": "2019-04-16",
    "iso_currency_code": "USD",
    "unofficial_currency_code": null
   }, {
    "id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "isin": null,
    "cusip": null,
    "sedol": null,
    "institution_security_id": "VGSLX",
    "institution_id": "ins_115616",
    "proxy_security_id": null,
    "name": "Vanguard Real Estate Index",
    "ticker_symbol": null,
    "is_cash_equivalent": false,
    "type": "mutual fund",
    "close_price": 26.44,
    "close_price_as_of": "2019-04-15",
    "iso_currency_code": "USD",
    "unofficial_currency_code": null
  }],
  "investment_transactions": [{
    "investment_transaction_id": "VaYBeiw3H9AhAHw53vQYkmkn2s2qJOGcY9hhs",
    "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
    "security_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "cancel_transaction_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "date": "2019-01-12",
    "name": "Dividend VANGUARD FEDERAL MONEY MARKET FUND (Settlement Fund)",
    "quantity": 0.84,
    "amount": 0.84,
    "price": 1,
    "fees": 0,
    "type": "cash",
    "subtype": "dividend",
    "iso_currency_code": "USD",
    "unofficial_currency_code": null
  }, {
    "investment_transaction_id": "VaYBeiw3H9AhAHw53vQYkmkn2s2qJOGcY9asd",
    "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
    "security_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "cancel_transaction_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0D1o3Q",
    "date": "2018-12-18",
    "name": "VANGUARD WINDSOR INVESTOR CL",
    "quantity": 146.915,
    "amount": 3000,
    "price": 20.42,
    "fees": 0,
    "type": "buy",
    "subtype": "contribution",
    "iso_currency_code": "USD",
    "unofficial_currency_code": null
  }, {
    "investment_transaction_id": "VaYBeiw3H9AhAHw53vQYkmkn2s2qJOGcH2xvv",
    "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
    "security_id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
    "cancel_transaction_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr1X8B2w5X",
    "date": "2018-10-30",
    "name": "SPRINT CORPORATION",
    "quantity": 372,
    "amount": 2118.91,
    "price": 5.68,
    "fees": 5.95,
    "type": "buy",
    "subtype": "buy",
    "iso_currency_code": "USD",
    "unofficial_currency_code": null
  }]
}

name

Description of the transaction, taken from the institution

quantity

Amount of the security that is moved in the transaction

amount

The value of the transaction = price * quantity

price

The price of the security for this transaction

type

A broad transaction type that informs the treatment of the transaction

securities

Definitions for the securities referenced by these holdings, including standardized identifiers, trading symbols, and classifications

Plaid enables our users to easily link their held-away investment accounts to our platform, and the /investments/holdings/get endpoint returns a detailed view of positions to support our in-depth analysis across a broad set of investment account types. Additionally, the Plaid team has been a joy to work with as we beta tested the product.
Andrew Moreland, founder and CTO of Haven