# Gemini Exchange API (slim)

> Gemini's exchange API for spot, margin, perpetuals, prediction markets and staking, through REST, WebSocket and FIX, with API key roles or OAuth, plus an official MCP server and SDKs from its developer-platform repository.

- Full: https://www.anchorterminal.com/tools/gemini-exchange.md (~10,550 tokens) · this version ~2,480 tokens · JSON https://www.anchorterminal.com/tools/gemini-exchange.json · canonical https://www.anchorterminal.com/tools/gemini-exchange
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · MCP: https://www.anchorterminal.com/mcp · Updated: 2026-11-04 · pricing https://www.anchorterminal.com/tools/gemini-exchange#pricing · reviews https://www.anchorterminal.com/tools/gemini-exchange#reviews
- Licence: CC BY 4.0, credit Anchor Terminal and link this page (https://www.anchorterminal.com/terms/#data)

**BB · 74.6/100 · rank #70 of 1349 · #1 in Crypto exchanges · agent-ready · confidence medium**


Assessment: Gemini publishes an OpenAPI and AsyncAPI contract, API key roles that keep withdrawals off a trading key, a funded sandbox, and an official MCP server whose tools carry read-only and destructive annotations and a confirm gate. Client order ids are not checked for duplicates, there is no SLA, and UK, EEA and Australian accounts closed in April 2026.

## Facts

- Kind: HTTP API · vendor: Gemini Trust Company, LLC · category: Crypto exchanges · legal entity: Gemini Trust Company, LLC · provenance 95/100
- Local only (stdio): npm `@gemini-markets/sdk`
- Auth: OAuth or key · pricing: Pay per use · x402: no · licence: Proprietary hosted API under Gemini's user agreement. The developer-platform repository (MCP server, TypeScript and Go SDKs, samples and skills) is Apache-2.0
- Probe metrics: not measured yet (probes haven't run)
- Surface listed: The hosted REST API at api.gemini.com (v1 and v2) as an agent calls it, read from developer.gemini.com, its specs catalogue, llms.txt and agents.md, the gemini/developer-platform repository (shallow clone), status.gemini.com, gemini.com's fee, legal and availability pages and the SEC on 3 November 2026. No account was made, no key minted and no MCP session opened
- MCP server: Official. `gemini-mcp` 1.0.1 in packages/mcp-server of github.com/gemini/developer-platform, stdio, built from source (not on npm), 87 tools in the source where the README says 40+, authenticated by GEMINI_API_KEY and GEMINI_API_SECRET in the client config (public market tools need no key). Not in the official MCP registry. The repository's mcp-plugin manifest names a hosted `https://api.gemini.com/mcp` that no docs page mentions and that answered no complete response to a GET
- Key permissions: One role per key, Trader (default; balances, orders, addresses, history), Fund Manager (withdrawals, approved addresses, bank methods, transfers between accounts; no orders), Auditor (read-only, cannot be combined), Administrator (master keys; create and view accounts). Approved (whitelisted) withdrawal addresses are managed by Fund Manager. Keys are revoked in API Settings. No IP allow-list documented
- Rate limits: 120 requests a minute public, 600 a minute private, five queued burst requests then HTTP 429 until the rate falls; transfers 1 per 5 seconds and deposit addresses 1 per 2 seconds per subaccount. No Retry-After or backoff guidance. WebSocket limits not documented
- Sandbox: exchange.sandbox.gemini.com, api.sandbox.gemini.com, wss://ws.sandbox.gemini.com and docs.sandbox.gemini.com. New accounts get $100,000, 1,000 BTC, 20,000 ETH, BCH, ZEC and LTC; bots trade the book; only Bitcoin testnet deposits and withdrawals; 2FA bypass with the GEMINI-SANDBOX-2FA header and code 9999999
- Countries served: The availability page lists the United States and its territories, the Bahamas, Bermuda, BVI, Cayman Islands, Costa Rica, Dominican Republic, Jamaica, Mexico, Panama, St Lucia, St Vincent, Argentina, Brazil, Chile, Ecuador, Peru, Uruguay, 33 European countries, Israel, Singapore, Turkey, Australia, Egypt, Ghana and South Africa, with notices that UK, EEA and Australian accounts closed effective 6 April 2026. The support article on countries answered 403
- Fees at the lowest tier: 0.600% maker and 1.200% taker on spot under $10,000 of 30-day volume, API fee schedule effective 1 September 2026; derivatives 0.02% maker and 0.07% taker; stablecoin pairs 0.00% and 0.01%
- FIX and WebSocket: FIX order entry, market data and drop copy with a dictionary and third-party (on-behalf-of) support, documented under /trading/fix. WebSocket at wss://ws.gemini.com with market data and authenticated order-event streams, described by an AsyncAPI file; legacy v1 and v2 WebSocket APIs are docs-only
- Terms on automated trading: The user agreement of 19 February 2026 has no clause on API use, bots or automated trading. No separate API terms were found. The developer site's Build an agent guide sets expectations for agents (least privilege, preview, confirmation at execution)
- Errors and idempotency: JSON `{result, reason, message}` with 53 reasons (InsufficientFunds 406, RateLimit 429, MissingRole 403, Maintenance 503). client_order_id is optional, recommended, 1 to 36 characters, not checked for duplicates. A key with Requires Heartbeat cancels its session's orders after 30 seconds without a request
- SDKs: TypeScript `@gemini-markets/sdk` 0.1.1 (23 September 2026; HMAC, OAuth PKCE, REST and WebSocket, 106 operations across 10 namespaces per the docs) and a Go SDK 0.1.0 (29 August 2026), both Apache-2.0 in the developer-platform repository, plus Python, TypeScript and Go samples and three Claude Code skills
- Legal entity: Gemini Trust Company, LLC (NMLS 1518126, New York) for exchange services, Gemini Moonbase, LLC for most US states' user agreement, with UK, Irish, Maltese, Singaporean and Australian affiliates named in the privacy policy. The parent Gemini Space Station, Inc. is a Nevada corporation listed on Nasdaq as GEMI
- Prices: Spot maker fee, base tier (under $10,000 of 30-day volume) 0.6% percentage fee; Spot taker fee, base tier 1.2% percentage fee; Derivatives taker fee, base tier 0.07% percentage fee

- Scores: Reliability 73, Performance pending, Schema & documentation 88, Agent ergonomics 79, Security & auth 78, Payments & pricing 40, Task success pending, Maintenance & community 88, Transparency & trust 75 · total over the 7 assessed categories
- Why: Reliability, Read with the hosted lines on the REST API at api.gemini.com. · Schema & documentation, OpenAPI 3 for REST (specs/openapi/rest.yaml), AsyncAPI for WebSocket, a prediction-markets OpenAPI file and a specs/index.json catalogue; th… · Agent ergonomics, Graded on the REST API, with the MCP server noted. · Security & auth, Revocable API keys with one role each (Trader, Fund Manager, Auditor, Administrator), HMAC-SHA384 signing with a nonce, and OAuth 2.0 with s… · Payments & pricing, No machine payment protocol (0). · Maintenance & community, Read as a closed hosted service with an open repository. · Transparency & trust, The editorial half.
- Sources: 30, open questions: 9, both in the full twin
- Capabilities: exchange.market-data, exchange.spot-trading, exchange.derivatives, exchange.balances, exchange.transfers, exchange.staking, market.crypto
- JSON: https://www.anchorterminal.com/api/v1/tools/gemini-exchange.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/gemini-exchange.svg` or a link to https://www.anchorterminal.com/tools/gemini-exchange from a page on gemini.com or one of its subdomains, or the README at the root of github.com/gemini/developer-platform, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.
- Support: trading@gemini.com; psirt@gemini.com; https://support.gemini.com/; https://support.gemini.com/hc/requests/new; https://status.gemini.com/; more in the full twin

## Before you call it

1. Create a Trader key for order flow and a separate Fund Manager key only if withdrawals are in scope; never combine them, and keep the secret out of prompts and logs
2. Set a `client_order_id` per order and look it up with `get_order_status` before resending after a timeout, because Gemini does not reject duplicates
3. Start on api.sandbox.gemini.com with the same code; sandbox apps register at once, production OAuth apps wait for Gemini's review
4. Stay under 1 public and 5 private requests a second; a 429 keeps answering 429 until the rate falls, with no Retry-After to read
5. Check the person's country against the availability page first; UK, EEA and Australian accounts were closed on 6 April 2026

## Connect

```bash
npm install @gemini-markets/sdk
```

```bash
curl https://api.gemini.com/v1/pubticker/btcusd
```

```bash
claude mcp add gemini -s user -e GEMINI_API_KEY=your_key -e GEMINI_API_SECRET=your_secret -- node /absolute/path/to/mcp-server/dist/index.js
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/gemini-exchange

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| Kraken API | BB | 71 | exchange.spot-trading, exchange.market-data, exchange.derivatives, exchange.balances, exchange.transfers, exchange.staking, market.crypto | https://www.anchorterminal.com/tools/kraken.min.md |
| OKX API | B | 64.3 | exchange.spot-trading, exchange.market-data, exchange.derivatives, exchange.balances, exchange.transfers, exchange.staking, market.crypto | https://www.anchorterminal.com/tools/okx.min.md |
| Binance API | B | 63.2 | exchange.spot-trading, exchange.market-data, exchange.derivatives, exchange.balances, exchange.transfers, exchange.staking, market.crypto | https://www.anchorterminal.com/tools/binance.min.md |
| Bitfinex API | C | 58.4 | exchange.market-data, exchange.spot-trading, exchange.derivatives, exchange.balances, exchange.transfers, exchange.staking, market.crypto | https://www.anchorterminal.com/tools/bitfinex.min.md |
| Bybit | C | 57.3 | exchange.market-data, exchange.spot-trading, exchange.derivatives, exchange.balances, exchange.transfers, exchange.staking, market.crypto | https://www.anchorterminal.com/tools/bybit.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)