# Gemini

Connect Gemini to rotki to import spot trades, transfers, and balances - including Gemini Earn balances added on top of your spot wallet. rotki uses a read-only (Auditor) API key signed from your computer.

## Features

- Spot trades imported from the mytrades endpoint as swap events with fees.
- Deposits and withdrawals imported from the transfers endpoint as asset movements.
- Spot balances and Gemini Earn balances combined into a single portfolio view.
- API key permission is validated against the roles endpoint at setup: rotki refuses to proceed if the key isn't Auditor (read-only).

## Limitations

- Margin/derivatives history is not imported (Gemini's older retail margin product is not exposed via the connector).

## Setup

1. In Gemini, open Settings → API → Create a new API key.
2. Set the scope to Auditor (read-only). Leave trading and withdrawal scopes disabled.
3. Save the key. Gemini shows the secret only once.
4. In rotki, open API Keys → Exchanges → Add Gemini and paste the key and secret.

## FAQ

### Are Gemini Earn balances included?

Yes. rotki queries the balances/earn endpoint in addition to the spot balances endpoint and combines them, so your portfolio total reflects both.

### Where are my Gemini API keys sent?

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

### Can rotki place trades on Gemini?

No. rotki insists on an Auditor (read-only) key and refuses to proceed otherwise, so it has no permission to send trade or withdrawal calls.