Binance

Connect your Binance account to track cryptocurrency holdings, balances, and trades

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. description: Connect your Binance account to track cryptocurrency holdings and transactions

Binance integration allows you to sync your cryptocurrency accounts, track holdings, and monitor transactions directly in Sure using the Binance API.

This integration is currently in beta. Please report any issues you encounter.

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

Your API secret is only shown once during creation. Store it securely — you’ll need both the API key and secret to connect Sure.

Do not enable withdrawal or trading permissions on your API key. Sure only requires read access.

For security, restrict your API key to read-only access. Sure does not execute trades or withdrawals on your behalf.

Connecting Binance to Sure

1. Navigate to Settings > Providers in Sure
2. Click Add Provider and select Binance
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
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

Spot, margin, and earn balances are combined into a single account. They are not tracked separately.

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

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 > Providers
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
• Historical trade data depends on Binance API availability and retention
• Real-time price updates depend on Binance market data availability To manually sync your Binance accounts:

1. Navigate to Settings > Providers
2. Find your Binance connection
3. Click Sync

Automatic sync

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

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 is linked in Sure

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 before the trade date
4. Ensure your API key hasn’t been revoked or expired
5. Check that your API key has read permissions enabled
6. Confirm your Binance account is active and in good standing

Missing balances

If some balances are missing:

1. Manually trigger a sync
2. Verify the asset exists in your Binance account
3. Check that the account type (spot, margin, earn) is supported

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

Limitations

• Historical trade data is limited to spot trades
• Some asset types may not have real-time pricing available
• Margin and Earn transaction history is not currently synced (only current balances)

Getting help

If you encounter issues with the Binance integration:

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