Binance

Binance integration allows you to sync your cryptocurrency accounts, track holdings across spot, margin, and earn products, and monitor trades directly in Sure using the Binance API.

​

How it works

When you connect your Binance account, Sure syncs:

• Spot wallet balances
• Cross-margin account balances (net assets)
• Simple Earn positions (flexible and locked)
• Spot trade history
• Holdings with daily valuations

All three account types (spot, margin, and earn) are combined into a single cryptocurrency account in Sure, with a unified USD-denominated balance.

​

Prerequisites

To use the Binance integration, you need:

• An active Binance account
• Binance API credentials (API key and API secret)
• API key permissions for reading account data and trade history

​

Getting your API credentials

1. Log in to your Binance account
2. Navigate to Account > API Management
3. Create a new API key with the following permissions:
   • Enable reading (view account information, balances, and trade history)
4. Save your API key and API secret securely

​

Connecting Binance to Sure

1. Navigate to Settings > Bank sync in Sure
2. Click Connect on the Binance card
3. Enter your API credentials:
   • Name: A label for this connection (e.g., “My Binance”)
   • API Key: Your Binance API key
   • API Secret: Your Binance API secret
4. Optionally set a Sync start date to limit how far back trade history is fetched. The date must be in the past.
5. Click Connect

​

Account setup

After connecting, Sure discovers your Binance account data during the first sync. You then need to link the account:

1. Review the discovered Binance account
2. Link it to an existing Sure account, or create a new one
3. Click Save to complete the setup

​

Supported features

​

Account types

The Binance integration syncs data from:

• Spot wallet — free and locked balances for all assets
• Cross-margin — net asset balances (assets minus borrowed amounts)
• Simple Earn — flexible and locked staking/savings positions

​

Holdings tracking

Sure creates a daily holding record for each asset, including:

• Current quantity per asset and source (spot, margin, earn)
• Price data from Binance market data
• Valuations converted to your family’s preferred currency

When Binance reports that an asset is no longer in your wallet, Sure removes it from today’s holdings so your portfolio stays accurate. Assets are removed based on what the latest sync reports, not on individual price lookups — a temporary pricing outage does not cause a holding to disappear. If one of the Binance sources (spot, margin, or earn) is temporarily unavailable during a sync, Sure carries forward the last known positions for that source rather than treating the silence as an empty wallet. The held positions are refreshed as soon as that source responds again.

​

Trade syncing

Sure syncs your spot trade history, including:

• Buy and sell trades
• Trade price and quantity
• Commission and fees
• Support for multiple quote currencies (USDT, BUSD, FDUSD, BTC, ETH, BNB)

Trades are synced incrementally — only new trades are fetched on subsequent syncs.

​

Currency handling

• All values are stored internally in USD
• Stablecoins (USDT, BUSD, FDUSD, TUSD, USDC, DAI) are treated as 1:1 with USD
• Values are converted to your family’s preferred currency for display

​

Security

​

Credential encryption

Your Binance API credentials are encrypted using ActiveRecord Encryption:

• API Key: Uses deterministic encryption for querying
• API Secret: Uses standard encryption for maximum security

​

Read-only access

Sure only requires read permissions on your Binance API key. No withdrawal or trading permissions are needed.

​

API timeouts

All Binance API requests include a 30-second timeout to prevent hanging connections.

​

Syncing

​

Manual sync

To manually sync your Binance account:

1. Navigate to Settings > Bank sync
2. Find your Binance connection
3. Click Sync now

​

Automatic sync

Sure automatically syncs your Binance account on a regular schedule along with your other connected accounts.

​

Limitations

• Only spot, cross-margin, and Simple Earn accounts are supported — futures, options, and other Binance products are not included
• Margin balances reflect net assets (assets minus borrowed), not gross positions
• Margin and Earn transaction history is not currently synced (only current balances)
• Historical trade data depends on Binance API availability and retention
• Real-time price updates depend on Binance market data availability

​

Troubleshooting

​

Connection errors

If you encounter connection errors:

1. Verify your API credentials are correct
2. Check that your API key has the required read permissions
3. Ensure your API key hasn’t been revoked or expired

​

Missing balances

If balances are missing:

1. Manually trigger a sync
2. Check that the asset has a non-zero balance on Binance
3. Verify the account type (spot, margin, earn) is supported
4. Verify the account is linked in Sure

If a source such as margin or Earn is temporarily unavailable, Sure preserves the last known positions for that source and logs the issue to Settings > Debug against the connection. Check there for details on any sync warnings.

​

Missing trades

If trades are missing:

1. Check that your API key has trade history read permissions
2. Verify the trade exists in your Binance account
3. Ensure the sync start date is set to a past date that falls before the trade date

​

Stale holdings after selling

If a sold asset continues to appear in your portfolio, manually trigger a sync. Sure removes holdings that Binance no longer reports as part of the wallet during each sync.

​

Stale rate warnings

If you see stale rate warnings on certain holdings, this means Sure couldn’t find a recent exchange rate for that asset. This can happen with low-liquidity tokens.

​

Account linking issues

If you have trouble linking accounts:

1. Ensure you’ve completed the account setup after connecting
2. When linking to an existing account, verify it’s a manual crypto account
3. Try unlinking and relinking the account

​

Getting help

If you encounter issues with the Binance integration:

• Check the troubleshooting guide
• Ask in the Discord
• Open an issue