Practical overview
When it fits
Use it when a Python application needs Gemini REST API calls or WebSocket market and order-event data, and select the public or authenticated client according to the task.
Who it is for
- Python developers integrating Gemini market data into tools or applications.
- Developers building Gemini trading integrations that need authenticated order methods or private order-event streams.
Documented uses
- Retrieve Gemini symbols, symbol details, ticker data, order books, trade history and auction history.
- Stream public market data and inspect recorded trades, bids and asks.
- Create, cancel and check orders, query balances, or use documented deposit and withdrawal methods through authenticated API access.
- Receive real-time order-event information such as order acceptance, fills and cancellations.
Requirements & limits
The documented PublicClient requires neither an API key nor a Gemini account. PrivateClient requires public and private API keys, a Gemini account and a registered application. The repository specifies an MIT license.
- PublicClient and private methods have different account and credential requirements.
- The README documents sandbox initialization for REST clients and WebSocket clients.
- The market-data WebSocket is public; the order-events WebSocket is private and requires credentials.
- With the API heartbeat option enabled, the README says the user must revive the heartbeat manually.
- The README says subscription filters for OrderEventsWS were under development.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install the library and initialize a public client
Set up the documented Python package and initialize a client for public Gemini API calls.
Before you start
- Python environment with pip.
Steps
Install the package with the command below.
pip install gemini_pythonImport
geminiin a Python program.Initialize
gemini.PublicClient(); usegemini.PublicClient(sandbox=True)for the documented sandbox option.
Expected outcome
A PublicClient instance is initialized for public API methods such as symbols, ticker and order-book requests.
Guide limitations
- The README describes initialization and lists public methods; it does not provide a complete application workflow or response-handling example.
- PublicClient does not cover the authenticated methods that require account credentials.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 16 October 2026
- Original website title
- mtusman/gemini-python · Official homepage title · retained in its source language

