Investment Holdings

A Holding in Quiltt represents an investment position such as a stock, bond, ETF, or mutual fund held in an investment account.

Link to this section#GraphQL Queries

Quiltt provides holdings at two levels:

1. Profile level - Aggregated positions across all investment accounts via the holdings query.
2. Account level - Individual positions for a specific account via account.holdings.

Link to this section#When to Use Each

Use the holdings query when you want:

• Consolidated portfolio view across all accounts
• Total exposure to a specific security
• Overall investment performance
• Aggregate portfolio analytics

Use account-level holdings (account.holdings) when you want:

• Positions broken down by account
• Access to provider-specific remote data
• Account-specific cost basis for reconciliation

Link to this section#Profile-Level Holdings

Use the holdings query to fetch aggregated positions across all investment accounts belonging to the Profile. This provides a consolidated portfolio view.

Profile-level holdings are calculated after each sync completes and the profile.ready event is fired. When you own the same investment across multiple accounts, positions are combined:

• Quantity: Total shares across all accounts
• Value: Total market value across all accounts
• Cost Basis: Your average cost per share across all accounts

Link to this section#Account-Level Holdings

Account-level holdings are available through Accounts. Use account.holdings when you need positions for a specific investment account, including access to provider-specific remote data.

Link to this section#Accessing Remote Data

Account-level holdings include raw provider data via the remoteData field: