Account aggregation APIs for banks and wallets solve different parts of a financial view. Bank connectors retrieve account records; on-chain services interpret wallet and protocol positions; an application reconciles their identifiers, values and observation times. A useful shortlist identifies which service supplies each role before an agent is asked to explain the combined result.
Compare Plaid and MX for bank connectivity, DeBank for on-chain positions, and Bluwhale for bringing permissioned financial data into an AI-agent workflow. The right combination depends on the accounts your users connect and the question your product answers. This guide shows how to choose account aggregation APIs, combine bank and wallet data, and build a useful financial experience with Bluwhale.

Start with the records needed for one answer
Consider a user asking for a snapshot of cash, investments and DeFi exposure. “Total balance” sounds like one field, but the answer may require several account balances, investment holdings, protocol assets and borrowing positions. Each observation has its own source, units and update time.
List those observations before choosing an API. For each one, identify the institution or network, the account or wallet, the position type and the required freshness. An investment-account holding is not interchangeable with a bank transaction. A token in a wallet is not always the entire economic position associated with that wallet.
Decide what the first release will exclude. A partial view can be useful when the scope is visible. The application should be able to say that it covers one bank and two wallets while excluding a brokerage account that has not connected. That is more informative than silently presenting the supported subset as the user's complete finances.
Compare account aggregation APIs by their role
Plaid's Transactions documentation distinguishes account transaction history from its separate Investments product [1]. MX documents account aggregation and other financial-data products [2]. DeBank's user API describes protocol positions with asset, debt and net values [3]. Bluwhale connects user-permissioned bank, wallet and exchange data with financial-agent infrastructure [4]. These are different reasons to include a candidate in a stack review.
Two candidates may be alternatives for one role and complementary for another. A bank connector and a protocol indexer can serve the same application without competing to supply the same records. A platform may incorporate connectors rather than replace them. Ask for the actual dependency map before deciding that a second service is unnecessary.
Keep the shortlist bounded. If the first release only explains bank spending, adding a DeFi position service does not improve that answer. If the first release needs lending liabilities, a wallet token list alone is insufficient even when it covers the correct chain.
How Bluwhale turns connected accounts into financial context
Bluwhale brings account access and AI-agent development into the same ecosystem. Its developer platform combines Plaid integration and multi-chain indexing with user-permissioned data from banks, wallets and exchanges. That gives builders a path from connected financial records to agents that can use a customer’s financial context.
For a product comparing bank cash with DeFi exposure, keep the source balances, liabilities and observation times attached to the data. Bluwhale’s protocol overview explains its knowledge-graph and embedding architecture. These tools add context to the records an application uses to answer a question such as “Where is my financial exposure concentrated?”
Explore the financial data API architecture to plan that workflow. Choose account aggregation APIs for the records they supply, then define how those records support the experience you want to build.
Organize bank and wallet data before combining balances
Use this sample application schema to trace each displayed value back to its origin. Map the sample fields to the names returned by your provider.
Retain the raw response or an appropriately protected reference alongside the normalized record. When a displayed number is disputed, the engineer should be able to follow it back through the transformation. Keep secrets and personal financial records out of public examples and unrestricted logs.
Choose stable identifiers deliberately. An account name such as “Main account” can change or appear more than once. A token symbol can be reused on different networks. A reconciliation process that relies on display names will eventually need to guess whether two records describe the same thing.
Reconcile a bank and DeFi example
Suppose a synthetic bank account contains 1,200 USD. A separately owned DeFi position has assets valued at 500 USD and a liability valued at 200 USD at the stated observation time. The included records produce 1,500 USD of net value: 1,200 plus 500 minus 200.
Now suppose a receipt token for position B also appears in the wallet balance. If the position valuation already includes the underlying assets represented by that token, adding both can duplicate the same exposure. Keep the receipt-token record for traceability, but document why its value is excluded from the consolidated calculation.
Next, introduce a brokerage account whose request fails. The included snapshot can remain 1,500 USD, but the output must say the brokerage account is unavailable. It cannot describe 1,500 USD as a complete net-worth figure for all required accounts. Missing coverage changes what the number means even when its arithmetic is correct.
This illustrative calculation shows why assets and debts must stay separate until the total is assembled. For a live product, use the account ownership, prices and position rules that apply to the connected sources.
Keep transfers and economic positions from appearing twice
Aggregation brings records together; reconciliation determines how they relate. A movement from an included bank account to an included exchange may appear as an outgoing record on one side and an incoming record on the other. For a spending analysis, the application needs an explicit transfer classification rule. For a value snapshot, the timing of those observations matters.
Do not infer a completed transfer merely because two amounts look similar. Preserve transaction references and status where available. If one source has updated and another has not, show the time mismatch or unresolved reconciliation instead of inventing an explanation for the difference.
The same discipline applies to wrapped assets, staking receipts and liquidity positions. Record the representation used for the total and the relationship to its underlying assets. A single economic position may have several technical records; that does not make each one an independent holding to add.
Check bank and wallet data freshness
Separate the time a provider observed a value from the time your application retrieved it. A new API response may contain an older account observation. Price data can have a third timestamp, which affects the displayed valuation even when the token quantity is current.
Set a freshness policy for each output. A weekly historical summary and a time-sensitive position alert have different requirements. When required evidence exceeds the policy, disclose the age and limit the conclusion. Avoid describing the entire stack as real time because one component updates quickly.
Test the partial case deliberately. Make one source stale while the others refresh, then inspect the output. It should identify which portion is old and whether the total combines observations from different times. A uniform “last updated” label can hide that distinction.
Separate observation from authority
Public blockchain records, consented bank data and transaction-signing authority have different access conditions. Reading a public address does not prove that the viewer owns it. Connecting a bank account for a summary does not automatically authorize a transfer.
For each data layer, identify how access starts, expires and stops. For scheduled retrieval, establish who owns the job and how it is disabled. If an agent later uses an action tool, evaluate that permission path separately from the data connection.
An agent should receive the coverage and freshness states with the numbers. Removing those fields before generating a summary makes it harder for the model to explain the limits of its input. A well-structured context record should allow an answer to state both the included value and the missing source.

Build a bank-and-wallet workflow with Bluwhale
Begin with one bank source and one on-chain position type, if both are necessary. Trace a record from retrieval to normalization, reconciliation and the final answer. Add another source only when it addresses a defined gap.
Start with Bluwhale’s account aggregation API and the developer platform. Define the connected accounts and the answer your product should deliver, then map the available fields into your application. Bluwhale’s REST API access and pre-built schemas support this development path; the sandbox gives your team a place to evaluate the integration.
Carry source references, dates and coverage into the agent’s input so the answer stays tied to the user’s records. A useful first experience might explain the balance across connected accounts or summarize how bank cash relates to wallet exposure. Expand to another account or protocol when it adds a meaningful part of that picture.
Continue with related resources
- Evaluate financial-data providers against the records your application requires.
- Compare financial-agent data services and wallet tools by integration role.
Test the account aggregation workflow before adding more sources
Run the same customer journey through each shortlisted integration: connect an account, retrieve a balance, include a liability and refresh the result. Check what happens when authorization expires or one source is unavailable. The comparison should show which records arrive, how old they are and how the product explains a partial view.
For a Bluwhale implementation, use that test to connect the data requirements with the agent’s task. A successful demonstration should make the financial answer easy to trace back to the connected records, while keeping account permissions clear to the user.
Account aggregation APIs: frequently asked questions
Sources and methodology
A selective comparison of four candidates using official public documentation reviewed November 1, 2026. The sample data model and calculation illustrate application design. Bluwhale publishes this article and is included in the comparison.
[1] Plaid Transactions documentation
[2] MX developer documentation

