AggregateDocs
Guides

Gemini and Aggregate

Last updated

Short answer: Aggregate reads your Gemini balances, cash deposits and withdrawals, and trades with a read-only key, so you can ask your AI about them next to your banks and books. It can't trade, deposit or withdraw.

Status: Beta. It's built to Gemini's documentation and is still being checked with real accounts, so if a number looks off, tell us at support@aggregate.finance.

Read-only keys only

Aggregate accepts a Gemini key only if it has the Auditor role and nothing else. Gemini's Auditor role is read-only and can't be combined with other roles. Aggregate checks the key's roles with Gemini when you connect, and again every time it syncs.

What it reads

Crypto deposits and withdrawals show in the balances, not as rows. Buying and selling crypto moves money into or out of crypto you still own, so it isn't counted as spending or income.

Make an Auditor key

  1. In Gemini, open Settings → API → Create API key. If Gemini lets you choose an account, choose it: an account-scoped key is the narrowest.
  2. Change the role from Trader to Auditor.
  3. Choose Time-based nonce.
  4. Copy the API key (it starts account- or master-) and the API secret. The secret is shown only once.

Group accounts. If your Gemini account is a group, Gemini may offer only a master key (it starts master-). Aggregate accepts a master key with the Auditor role alone. It's still read-only, but it covers the whole group: a master key lets Aggregate read every subaccount in the group. Each open subaccount shows up as its own set of accounts, named "Gemini <subaccount> USD" and so on.

Connect

  1. Sign in to Aggregate at app.aggregate.finance.
  2. Open Workspace → Connections → + Add a connection → Gemini (marked Beta).
  3. Paste the key and secret. Aggregate checks the key is Auditor-only before it saves it, and stores it encrypted.
  4. Connect your AI to Aggregate and ask about your numbers.

How we check

Gemini's roles call reports each role as true or false. We tested the check against Gemini's sandbox on 2026-11-13 with two master keys: an Auditor-only key was accepted and could list its group and read balances, and a Trading-only key was refused. Our tests also cover account keys, a missing or unclear answer (refused), and a key that gains a role (dropped at the next sync).

Disconnect and delete

Disconnect Gemini in Aggregate at any time, and choose Disconnect and delete its data to delete what it brought in. Then delete the key in Gemini (Settings → API), because Gemini has no way for an app to end its own key. Backups are kept for 25 days, so deleted data is gone from backups within 30 days.

To delete all your data, delete your workspace. See Privacy.

Questions people ask

Can my AI trade or move my crypto? No. Aggregate accepts only an Auditor key, which Gemini makes read-only, and it checks the key on every sync.

What does it cost? Aggregate is free while we're in beta. We may introduce paid plans later, and we'll let you know before anything changes.

Who do I contact? support@aggregate.finance.

Last checked 2026-11-13.

© 2026 Aggregate Finance LLC