# Binance

Connect your Binance account to rotki and import spot trades, deposits and withdrawals, Convert swaps, margin and futures positions, and Simple Earn interest. Use a read-only API key or import Binance's CSV exports.

## Features

- Spot trades - full trade history once you select your market pairs.
- Deposits and withdrawals - reconciled against your balance history.
- Binance Convert - quick swaps imported as trades.
- Cross-collateral and margin futures - balances and positions for COIN-M (dapi) and USD-M (fapi).
- Simple Earn - flexible and locked interest history.
- CSV import - load Binance's exported trade and history CSVs for periods before your API key existed.

## Limitations

- Binance does not return trades for delisted markets via API; CSV import is the workaround.
- You must paste your market pairs into rotki - Binance's API requires the pair to query its trades.
- Binance Convert history is limited by Binance to a 30-day window per request, so deep history takes longer to sync.

## Setup

1. In Binance, open Account → API Management and click "Create API".
2. Restrict permissions to "Enable Reading" only. Leave trading, withdrawals, and futures-trading permissions off.
3. Optionally enable IP whitelist for extra safety.
4. In rotki, open API Keys → Exchanges → Add Binance, paste the API key and secret.
5. Paste your active market pairs (e.g. BTCUSDT, ETHUSDT) so rotki knows which markets to query.

## FAQ

### Does rotki support Binance Futures?

Yes. rotki queries USD-M and COIN-M margined futures balances. Make sure the API key has "Enable Reading" for futures.

### Why does rotki ask for market pairs?

Binance's API only returns trades when you specify a pair. rotki asks you to paste your active pairs so it can query each one. You can paste multiple pairs at once.

### Can I track Binance.US and global Binance in the same rotki instance?

Yes. Binance.US is a separate integration in rotki - add both with their own API keys.

### Where are my Binance API keys sent?

rotki is a local application: your Binance API key is stored on your computer and used to sign each request, which goes directly from your machine to Binance's API. No rotki-operated server ever sees the key or the request.