Binance.US and Aggregate
Last updated
Short answer: Aggregate reads your Binance.US balances and your trades against US dollars with a read-only key, so you can ask your AI about them next to your banks and books. It can't trade or withdraw.
Status: Beta. It's built to Binance.US'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 checks a Binance.US key in two ways when you connect, and again every time it syncs:
- It reads your account, and Binance.US must say trading and withdrawals are off.
- It asks Binance.US to check a test order far below the smallest allowed size. Binance.US checks a test order but never places it. A read-only key must be refused with Binance.US's "no permission" answer.
Any other answer means the key is refused. If Aggregate refuses your key, open API Management → Edit restrictions in Binance.US, turn off trading and withdrawals for the key, and try again. Binance.US's documentation doesn't say whether these flags describe the key or the whole account, so if withdrawals are on for your account, Aggregate may refuse even a read-only key. It refuses rather than guesses. If a key gains trading or withdrawal rights later, Aggregate stops syncing and deletes the key. What it already brought in stays.
What it reads
- Balances: each asset you hold. Crypto shows as a quantity with its value at Binance.US's US-dollar price. Your dollar balance shows as money.
- Trades against US dollars, so each buy or sell shows on the dollar side.
Deposits and withdrawals aren't read as rows yet, because Binance.US's documentation doesn't give their dates. Your dollar balance is always Binance.US's own number. Buying and selling crypto moves money into or out of crypto you still own, so it isn't counted as spending or income.
Make a read-only key
- In Binance.US, open your profile → API Management → Create API, and choose a system-generated key.
- Under Edit restrictions, leave Enable Spot Trading and any withdrawal option off.
- Copy the API key and the secret key. The secret is shown only once.
How we check
The test order uses Binance.US's order/test call, which its documentation says "does not send it into the matching engine", with a size below every minimum. Only Binance.US's -2015 "permissions" error passes. Our tests cover each documented answer. Not yet run with a real customer key. Every check's result is logged (codes only, never the key) so a wrong refusal shows up.
Disconnect and delete
Disconnect Binance.US in Aggregate at any time, and choose Disconnect and delete its data to delete what it brought in. Then delete the key in Binance.US (API Management), because Binance.US has no way for an app to end its own key.
Related
© 2026 Aggregate Finance LLC