Gemini Developer Platform

A suite of developer tools for integrating with the Gemini cryptocurrency exchange API. Includes an MCP server for AI assistant integrations, multi-language SDK samples, and Claude Code skills.

What's Included

Package	Description
packages/mcp-server	MCP server exposing Gemini API as tools for AI assistants
Go SDK	Official Go SDK for the Gemini REST and WebSocket APIs
Go SDK Gorilla WebSocket adapter	Optional Gorilla WebSocket adapter for the Go SDK
TypeScript SDK (npm package)	Official TypeScript SDK for REST and WebSocket APIs, with server and browser entry points
samples/	REST and WebSocket examples in TypeScript, Python, and Go
skills/	Claude Code skills (e.g., terminal candlestick charts)

Samples

Multi-language examples (TypeScript, Python, Go) demonstrating public and authenticated API usage. See samples/README.md for the full guide.

Quick Start

No API key required:

# Get ticker data
python3 samples/python/get_ticker.py btcusd
go run samples/go/get_ticker.go btcusd
npx ts-node samples/typescript/src/getTicker.ts btcusd

# Stream real-time trades (WebSocket)
python3 samples/python/ws_trades.py btcusd
go run samples/go/ws_trades.go btcusd

With API credentials:

# Copy and fill in your credentials
cp samples/.env.example samples/.env

# Get account balances
python3 samples/python/balances.py
go run samples/go/balances.go
npx ts-node samples/typescript/src/balances.ts

Install Dependencies

# TypeScript
cd samples/typescript && npm install

# Python
cd samples/python && pip install -r requirements.txt

# Go
cd samples/go && go mod download

Configuration

Samples, the MCP server, and the Go demo read credentials from environment variables. See each package README for SDK-specific configuration:

Variable	Description
GEMINI_BASE_URL	API base URL (production or sandbox)
GEMINI_API_KEY	Your Gemini API key
GEMINI_API_SECRET	Your Gemini API secret

For testing, use the sandbox environment:

GEMINI_BASE_URL=https://api.sandbox.gemini.com/v1

Get sandbox credentials at exchange.sandbox.gemini.com.

Authentication

Private endpoints use HMAC-SHA384 signing:

1. Build a JSON payload with the request path and a millisecond timestamp nonce
2. Base64-encode the payload
3. Sign it with your API secret using HMAC-SHA384
4. Send via headers: X-GEMINI-APIKEY, X-GEMINI-PAYLOAD, X-GEMINI-SIGNATURE

All samples and the MCP server handle this automatically.

Installing Skills

Install all Claude Code skills using the skills CLI:

npx skills add gemini/developer-platform -a claude-code --all -y

See skills/README.md for installing individual skills or other agents.

MCP Server

The MCP server exposes the Gemini API as tools compatible with Claude and other MCP clients. It covers 40+ tools across six categories:

• Market — ticker, symbols, candles, price feeds, order books, trade history
• Orders — place/cancel orders, order status, trade volume
• Funds — balances, deposits, withdrawals, transfers, gas fee estimates
• Account — account info, sub-accounts, approved addresses
• Margin — margin account, preview orders, open positions, funding payments
• Staking — balances, rates, history, stake/unstake

Setup

cd packages/mcp-server
npm install
npm run build

Configure your Claude client to use the server (example for Claude Desktop):

{
  "mcpServers": {
    "gemini": {
      "command": "node",
      "args": ["/path/to/developer-platform/packages/mcp-server/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "account-xxxxxxxxxxxxxx",
        "GEMINI_API_SECRET": "xxxxxxxxxxxxxx"
      }
    }
  }
}

API Documentation

• Gemini REST API
• Gemini WebSocket API

License

Apache 2.0