Skip to main content

Importing Holdings from Altruist

Written by Taylor Stewart

How do I import holdings from Altruist?

Advisors import Altruist holdings by uploading 1 holdings report CSV from Altruist to Import holdings in Kerdora's practice sidebar. Kerdora suggests a household you already have for each Altruist account it can match, and you check every match before anything changes.

  1. In Kerdora, open your user menu, choose Integrations, choose Turn on on Altruist's row under Custodians, then choose Turn on Altruist.

  2. In Altruist, open Reports, choose Holdings, and export that report as a CSV. Use Altruist's extended report with all fields when it's offered.

  3. In Kerdora's practice sidebar, open Import holdings, add your file, and choose Match accounts.

  4. Check every household and account destination on Kerdora's review screen.

  5. Choose Import N accounts, where N counts rows with a household selected.

Importing into an investment account replaces all of that account's holdings, so export complete accounts. For errors, see Altruist Import Troubleshooting. Using Schwab instead? See Importing Holdings from Schwab.

How do I turn on the Altruist import?

Turn on Altruist on the Integrations tab of Kerdora's Settings. Kerdora saves your choice right away, with no separate Save button.

  1. Open your user menu (your photo at the top right) and choose Integrations. From Advisor Settings, you can also select the Integrations tab.

  2. Under Custodians, find Altruist ("Holdings from CSV reports") and choose Turn on on its row.

  3. In the Turn on Altruist pop-up, choose Turn on Altruist.

  4. Kerdora shows "Altruist is on." Choose Import holdings to open Kerdora's Altruist upload page now, or Not now to close it.

After that, Altruist's row shows a check mark. Selecting that row opens Altruist's drawer, which has Import holdings and Turn off buttons.

New advisors can also choose Turn on for Altruist under Custodians in Practice setup's Connect your tools step. Once households exist, Practice setup's Your first client step offers Import holdings for each custodian you've turned on.

Turning it on doesn't sign in to Altruist or load any data.

How do I export the holdings report from Altruist?

Export your holdings report from Altruist's Reports page, using its Holdings report, which lists holdings across all your households.

  1. In Altruist's left menu, choose Reports.

  2. On Altruist's Reports page (titled Firm), choose Holdings ("View all Holdings across all Households").

  3. Export that report as a CSV file. When Altruist offers its extended report with all fields, choose it.

Kerdora's upload page notes that Altruist's extended report matches accounts best. A standard report still imports, with a warning. Export every account you want to refresh, with all of each account's holdings: an import replaces an account's full holdings set.

What Altruist file do I need?

On Import from Altruist, upload 1 holdings report CSV, no larger than 10 MB. Altruist's extended report with all fields gives Kerdora each owner's first and last name, account type, and group name, which helps matching.

A standard holdings report is also accepted. Kerdora shows: "Standard format detected. For better matching accuracy, use the extended Altruist report with all fields." That warning doesn't stop your review.

Keep Altruist's original column names. Kerdora uses Account Number, Account Name, Security Type, Symbol, Description, Quantity, Price, and Market Value; extended reports add First Name, Last Name, Account Type, and Group Name.

Rows without an Account Number are left out. Missing or unreadable numbers become zero, so compare quantities and values in Kerdora's review with your report before importing. Upload real CSV exports; a PDF or Excel workbook renamed to .csv won't work.

How does Kerdora pick an Altruist account's owner and type?

On Kerdora's Altruist review screen, a new account's suggested type comes from your report: Account Type in an extended report, or Account Name in a standard one (for example, "Jane Doe and John Doe's Rollover IRA"). A row going to an existing Kerdora account shows that account's saved type and keeps its saved owner.

If Kerdora's AI matches a household but not an owner, it proposes the first name in your report as a new person. A joint account gets one proposed owner, not both. A row whose household you choose yourself has no owner until you save its account details.

If Kerdora can't map an Altruist account type, it suggests Taxable, with no warning. Check each new account's Account type and Owner against its real registration in that account's details. A suggestion doesn't confirm tax treatment.

Where do I find Import holdings for Altruist?

Import holdings appears in Kerdora's practice sidebar once Altruist or Schwab import is turned on for your advisor login. It doesn't appear while you're inside a household, so return to your client list first. On a phone, open Kerdora's app menu and choose Import holdings.

With only Altruist turned on, Import holdings opens Import from Altruist directly. With Schwab also on, Kerdora asks "Which custodian are your files from?" Choose Altruist.

With no custodian import on, the sidebar entry is hidden. Opening Kerdora's import page directly shows "No custodian import is on" and a Turn on Altruist or Schwab in Settings link.

You can also open Import from Altruist from Settings: open your user menu, choose Integrations, select Altruist's row, and choose Import holdings in its drawer.

How do I upload an Altruist file for matching?

On Import from Altruist, add your holdings report to Kerdora's Holdings report row, then choose Match accounts. Uploading and matching prepare a review; nothing in your households changes yet.

  1. Choose Choose file beside Holdings report and select your Altruist CSV. You can also drag that CSV onto its row.

  2. Check its filename. To replace it, choose Remove beside it, then choose another file.

  3. Choose Match accounts and wait while Kerdora shows "Reading the files…"

Match accounts stays unavailable until Kerdora's Holdings report row has a file. Compare account counts and totals with your report before approving any destination.

How do I review Altruist account matches?

On Kerdora's Altruist review screen, check every destination, including accounts Kerdora matched on its own. Kerdora checks stored account numbers first, then uses AI to suggest households, people, and accounts for remaining rows.

  • Suggested matches holds AI suggestions.

  • Needs your input holds rows with no household match.

  • Matched holds account-number matches. This group starts collapsed.

  • Skipped holds rows you've skipped.

A summary at the top says how many accounts matched automatically, counting AI suggestions. Expand Matched and check account numbers, households, account names, and types. Use the arrow at the start of each row to see that account's holdings from your report. An existing account's owner isn't shown on its review row, so check uncertain ownership in that household's Profile → Accounts.

How do I change an Altruist account match?

On Kerdora's Altruist review screen, change any destination before you choose Import N accounts. Match an existing Kerdora account when it's the same Altruist account; a second account can count that balance twice.

  1. For a row under Matched, choose Edit to show its controls.

  2. Select a household in Kerdora household. This clears that row's account, owner, proposed person, and Goal assignments.

  3. To use an existing account, choose Existing account and select it. Kerdora first selects that household's first account, so check your selection.

  4. To add an account, choose New account and select its proposed name. In account details, check Account name, Owner (it lists only people already in that household), Account type, and Goal assignments, then choose Save. Without Save after a household change, Kerdora creates that account with no owner. Cancel closes account details without keeping changes.

  5. Choose Skip for a row you don't want. Undo brings back Kerdora's suggestion and clears your Goal assignments.

Existing account appears only when that household has an investment account, or a cash account for a cash-only Altruist account. For a cash-only account, account details also offer Investment or Cash / Bank; Cash / Bank gets a balance update instead of holdings.

How do I finish an Altruist import?

On Kerdora's Altruist review screen, choose Import N accounts only after checking every destination. N counts rows with a household selected, not rows you've checked; rows with no household are skipped.

  1. Check destinations, owners, and account types. Choose Skip for accounts you don't want.

  2. Choose Import N accounts and wait for "Import complete."

  3. Read Accounts imported and Accounts skipped. People added and Accounts added show only when they aren't zero. Holdings added counts imported investment holdings, including replacements.

  4. Choose Go to clients and open each affected household to check positions, quantities, totals, owners, and Goal assignments.

Import more files returns you to Kerdora's Altruist upload step. "Import complete" gives counts only, with no detailed change list and no undo. Keep your report and review notes so you can tell what changed.

How do I refresh Altruist holdings later?

Use Import holdings again with a new, complete Altruist holdings report whenever you want current holdings in Kerdora. Stored account numbers let Kerdora match accounts from earlier imports; unfinished review choices aren't saved between sessions.

  1. Export a fresh holdings report from Altruist's Reports → Holdings.

  2. Open Import holdings, choose Altruist if asked, add your file, and choose Match accounts.

  3. Expand Matched and check every destination, including rows you moved to a different account last time.

  4. Choose Import N accounts and check affected households.

Each imported investment account gets a replacement holdings set, not extra copies of earlier positions. Accounts missing from your report stay as they are. Always export complete accounts: importing only changed positions removes every other holding from those accounts.

What does an Altruist import change in an existing account?

An Altruist import replaces an existing investment account's entire holdings set and switches its balance to come from holdings when needed. Positions missing from your report disappear from that account, including positions entered by hand.

Kerdora also saves the Altruist account number on an existing destination, which can replace a different saved number. If another account you can access already stores that Altruist number, Kerdora leaves it there, so later imports match that other account again. To move a match for good, clear or correct Account Number on the old account (choose Open details on its Profile → Accounts row, or select the row in the Balance sheet layout or on a phone).

An existing bank destination gets that Altruist account's total as its balance. Kerdora doesn't change an existing account's name, owner, type, institution, savings, time horizon, or beneficiary; Goal assignments saved during review are added.

New accounts get the name and type on their row, the owner saved or suggested, Altruist as institution, and the Altruist account number. Check each new account's savings, beneficiary, time horizon, and Goal assignments afterward. Skipped rows aren't refreshed.

What doesn't an Altruist import bring in?

An Altruist import doesn't bring in tax lots or cost basis. Every imported holding has a cost basis of zero, which replaces any basis on that account's earlier holdings. Correct basis before relying on gain or loss figures.

Tickers Kerdora recognizes use imported share counts and Kerdora's own prices, so values can differ from a dated report. Cash and unrecognized securities become custom holdings valued at their exported market value. Check their classification and value after importing.

Altruist import doesn't create households, bring in spending transactions, or keep a live feed. Create households first. For PDF statements, use File & extract after Upload on a client's Documents page, or Upload & Extract in Profile → Accounts → Add account → Import (see Using Upload & Extract for Client Data), and check proposed accounts for duplicates.

Can an Altruist import add people to a household?

Yes. On Kerdora's Altruist review screen, a Suggested matches row adds a new person when Kerdora's AI matched the household but no person in it. Kerdora uses the first owner named on that Altruist account, even for a row going to an existing account, and adds one person per row: 3 accounts for one new owner add that owner 3 times. Each new person becomes a Client while a household has fewer than 2 Clients, then an Other adult.

No review row shows a proposed person. Choosing a different household clears it, so Needs your input rows never add one. Choosing Save in account details also clears it, because Owner lists only people already in that household.

To add an owner once, add that person on their household's Profile → Household page before uploading, then select them as Owner in each of their rows' account details and choose Save. For a row going to an existing account, follow "How do I stop an Altruist import from adding a person?"

If People added appears after importing, open Profile → Household in every household you imported into. Contact Support before removing an unexpected person if you're unsure what depends on that record.

How do I stop an Altruist import from adding a person?

On Kerdora's Altruist review screen, saving an existing person as Owner in a row's account details clears that row's proposed new person. For a row going to an existing account, also clear any proposed Goal assignments.

  1. Choose New account and select that row's proposed account name to open account details.

  2. Select your intended person in Owner. If that person isn't listed, add them on their household's Profile → Household page and start your upload again.

  3. For a row that will update an existing account, open Assign goals and uncheck each checked goal.

  4. Choose Save. For an existing destination, switch back to Existing account and select your intended account again.

Account details can preselect a goal, such as a household's only Retirement goal for an IRA; Save keeps it, and switching to Existing account doesn't clear it. Choosing Owner here doesn't change an existing account's saved owner, and unchecking goals here doesn't remove goals it already has.

Does an Altruist import keep accounts connected?

No. Import holdings loads Altruist CSV data once; it doesn't create an ongoing connection to Altruist. Neither advisors nor clients can make this import fetch later balances. To refresh, export a new report and import again.

Linked accounts through Plaid are a separate workflow for connecting supported institutions. Advisors reach them from a household's Profile → Accounts → Connections. An Altruist linking failure in Connections belongs to Troubleshooting Linked Accounts, not to Altruist CSV import.

Who can use the Altruist import?

Every advisor can turn on Altruist import on the Integrations tab of Settings. Clients don't have Kerdora's import pages in their portal.

Turning it on is saved for your advisor login only; another advisor at your practice turns on their own.

Kerdora's review screen lists existing households you can access. Create any missing household before uploading your report; see Adding Your First Client. Choosing New account during review adds an account to a selected household; it never creates a household.

How do I turn off the Altruist import?

Turn off Altruist from its drawer on the Integrations tab of Kerdora's Settings. This changes availability for your advisor login only; people, accounts, and holdings you imported stay in place.

  1. Open your user menu (your photo at the top right) and choose Integrations.

  2. Under Custodians, select Altruist's row to open its drawer.

  3. Choose Turn off at the top of Altruist's drawer. Kerdora turns it off right away, with no confirmation step.

If Schwab import is still on, Import holdings stays in your practice sidebar and opens Schwab. If neither is on, that sidebar entry disappears. To turn Altruist back on, choose Turn on on Altruist's row, then Turn on Altruist. Turning off an import doesn't undo past imports or disconnect a Plaid connection.

Did this answer your question?