# KuCoin

Connect your KuCoin account to rotki to import spot trades (current and v1 legacy formats), deposits, withdrawals, and balances. rotki uses a read-only API key signed from your machine.

## Features

- Spot trades imported as swap events; both the current API responses and the older v1 trade format are handled.
- Deposits and withdrawals imported as asset movements, including paginated historical entries.
- CSV import of KuCoin trade exports for periods before your API key existed.

## Limitations

- KuCoin margin trades are not imported; only spot trades, deposits, and withdrawals are retrieved.

## Setup

1. In KuCoin, open Account → API Management → Create API.
2. Set permission to "General" (read-only). Leave "Trade" and "Transfer" off.
3. Set an API passphrase when prompted - you'll need it in rotki.
4. Whitelist your IP if you want extra safety.
5. In rotki, open API Keys → Exchanges → Add KuCoin and paste the key, secret, and passphrase.

## FAQ

### Where are my KuCoin API keys sent?

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

### What does the API passphrase do?

KuCoin requires a user-set passphrase alongside the key and secret as an additional signing factor. rotki needs all three to authenticate API calls.

### Can rotki withdraw from my KuCoin account?

No. rotki only requests the General (read-only) scope and never sends withdrawal or transfer calls.

### Are my old v1 trades imported?

Yes. rotki detects KuCoin v1 trade entries and imports them with the correct timestamp and pair conversion.