Copy page

Revision History

Changes

These release notes list changes to Gemini Exchange API.

2026-06-01

• WebSocket - Prediction Markets WebSocket
  • Documented the n (fee amount) field in the Order Events stream fill object — present only on FILLED events, applies to spot, prediction markets, and PERPS

2026-05-29

• OAuth 2.0 - Public Clients
  • Documented public clients and the required PKCE flow for native, desktop, and single-page apps — code_verifier/code_challenge parameters, the S256 requirement, mandatory state, and loopback redirect URIs

2026-05-28

• OAuth 2.0 - Prediction Markets
  • Added prediction market REST endpoints to the OAuth scopes table
  • Added OAuth 2.0 bearer token authentication option to Prediction Markets WebSocket docs

2026-05-27

• REST APIs - Common - Admin
  • Added Subaccounts overview — account hierarchy, API key mechanics, and patterns for agentic trading, prediction market bots, and team/client isolation

2026-05-26

• WebSocket - Authentication
  • Documented that the WebSocket API accepts OAuth 2.0 bearer tokens in the Authorization header during the connection upgrade, in addition to HMAC-signed API keys

2026-05-23

• Prediction Markets - Liquidity Rewards Program
  • Clarified that Spread weight uses the best price on your side as the reference when the book is one-sided
• WebSocket - Position Updates
  • Documented the positions@account@1s stream — periodic 1-second snapshot of all open event-contract positions for the authenticated account; reuses the existing positionReport wire shape

2026-05-22

• Prediction Markets - Liquidity Rewards Program
  • Added link to the Liquidity Rewards page on Gemini Exchange in the program overview
  • Linked the Liquidity Rewards REST API endpoints (Get Config, List Events, Get Daily Summary, Get Lifetime Summary) in the program overview callout
• Prediction Markets - REST APIs - Rewards
  • Linked "Liquidity Rewards" in the Rewards category page description to the Liquidity Rewards page on Gemini Exchange
• Styles
  • Added vertical spacing between adjacent paragraphs inside .exchange-link-callout

2026-05-21

• Prediction Markets - REST APIs - Rewards
  • Added REST API reference pages for the Maker Rebate program: GET /v1/prediction-markets/maker-rebate/rates (Get Rate Schedule), POST /v1/prediction-markets/maker-rebate/payouts (List Payouts), and GET /v1/prediction-markets/maker-rebate/summary/total (Lifetime Summary)
  • Added REST API reference pages for the Liquidity Rewards program: GET /v1/prediction-markets/liquidity-rewards/config (Program Config), GET /v1/prediction-markets/liquidity-rewards/events (List Events), GET /v1/prediction-markets/liquidity-rewards/summary/daily (Daily Summary), and GET /v1/prediction-markets/liquidity-rewards/summary/total (Lifetime Summary)

2026-05-20

• Prediction Markets - Combo Contracts
  • Added Combo Contracts section with overview covering contract specification, ticker format, pricing, settlement state machine, orderbook behavior, discovery, and FAQ
  • Added REST API reference pages for GET /v1/prediction-markets/combos (List Combos) and GET /v1/prediction-markets/combos/{instrumentSymbol} (Get Combo)

2026-05-18

• Prediction Markets - REST APIs
  • Added terms endpoints for API key and OAuth flows: GET /v1/prediction-markets/terms, GET /v1/prediction-markets/terms/status, and POST /v1/prediction-markets/terms/accept

2026-05-15

• WebSocket - Navigation
  • Added Introduction page to both Trading and Prediction Markets WebSocket sections

2026-05-14

• Prediction Markets - Market Makers
  • Added Liquidity Rewards Program documentation
• Prediction Markets - Getting Started
  • Consolidated the Prediction Markets intro and getting-started flow into the main Prediction Markets landing page
  • Added beginner market-maker and agent workflow guidance, including public market discovery, quoting loop, guardrails, first-order example, and common first-run issues
  • Added guidance for computing notional dollars from WebSocket depth snapshots and depth updates instead of relying on a separate dollar field
  • Clarified that WebSocket is the preferred path for active trading and market making, while REST is used for event discovery, account snapshots, and reconciliation
  • Added REST-vs-WebSocket order payload guidance, first-order prerequisites, symbol glossary, and beginner market-maker terminology
  • Clarified maker-only REST order behavior with the makerOrCancel field and aligned position examples to the web-api POST /v1/prediction-markets/positions route
  • Updated internal links to use canonical Prediction Markets REST and WebSocket routes
• Prediction Markets - WebSocket Streams
  • Added a stream matrix covering public market data, authenticated account streams, and contract lifecycle streams
  • Clarified local order book maintenance, YES-space depth calculations for YES and NO notional, and REST reconciliation after positions@account reconnects or settlement windows
  • Re-added positions@account stream documentation for real-time event-contract position updates, including authentication requirements, subscribe and acknowledgement examples, and the positionReport wire shape
  • Updated Prediction Markets WebSocket examples and interactive tools to use wss://ws.gemini.com and include positions@account for exposure updates

2026-05-12

• Prediction Markets - REST APIs
  • Added documentation pages for the following endpoints: Get Strike Price for Event (GET /v1/prediction-markets/events/{eventTicker}/strike), List Newly Listed Events (GET /v1/prediction-markets/events/newly-listed), List Recently Settled Events (GET /v1/prediction-markets/events/recently-settled), List Upcoming Events (GET /v1/prediction-markets/events/upcoming), Get Order History (POST /v1/prediction-markets/orders/history), Get Settled Positions (POST /v1/prediction-markets/positions/settled), and Get Volume Metrics (POST /v1/prediction-markets/metrics/volume)
• Prediction Markets - WebSocket Streams
  • Removed positions@account stream documentation (stream removed)

2026-05-08

• WebSocket - Playground
  • Fixed sidebar navigation disappearing when navigating to Playground pages under Trading and Prediction Markets WebSocket sections
  • Removed the empty "Overview" entry from the Playground sidebar; it was always highlighted because it shared a path with the page itself, masking the active method

2026-05-07

• Prediction Markets - WebSocket Streams
  • Documented the positions@account stream for real-time event-contract position updates: snapshot-then-delta semantics, sign convention (negative value = short), zero-position eviction (delta emits-then-evicts; repeat zeros suppressed), and that EC settlement is silent on this stream
  • Added the positionReport event payload (top-level e/E/u/A/P and per-row t/s/a[] with each amount's t/v/c)

2026-05-06

• Infrastructure
• Upgraded Zudoku from 0.66.1 to 0.76.0 (smaller bundle, OpenAPI playground array-parameter support, miscellaneous fixes)

2026-05-05

• Trading - Fund Management
  • Moved Fund Management endpoints under Trading → REST APIs to match the new vertical structure (16 endpoints: balances, deposits, withdrawals, payment methods, approved addresses, transfers, transaction history)

2026-05-01

• Prediction Markets - Maker Rebate Program
  • Removed outdated April 9, 2026 promotional offer notice

2026-04-29

• Prediction Markets - Maker Rebate Program
  • Extended promotional period end date to June 10, 2026 (post-promotional rates effective June 11, 2026+)
  • Added Politics category (0.70 rebate rate) and Economics category (0.50 rebate rate) effective May 10, 2026
  • Sports rebate rate remains 0.50 in post-promotional period

2026-04-24

• Prediction Markets - WebSocket Streams
  • Documented the contractStatus stream under Prediction Markets → WebSocket → Streams, covering lifecycle events (status transitions) and strike-populated moments for Up/Down contracts
  • Added p (strike price) field, parsed from the contract ticker and omitted for Up/Down contracts until the strike is set
  • Added a "Contract Status" entry to the prediction-markets Streams sidebar
• Prediction Markets - Positions
  • Documented the POST /v1/prediction-markets/positions/settled endpoint for retrieving historically settled positions, including payout, resolutionSide, costBasis, realizedPnl, and netProfit fields, with optional eventTicker filter

2026-04-23

• WebSocket - Sidebar Navigation
  • Added a "Contract Status" entry under Streams so the contractStatus stream is reachable from the websocket sidebar

2026-04-22

• WebSocket - Contract Status Stream
  • Documented the contractStatus stream for prediction-market contract lifecycle events (status transitions and strike-populated moments)
  • Added p (strike price) field, parsed from the contract ticker and omitted for Up/Down contracts until the strike is set

2026-04-17

• Prediction Markets - Trading
  • Added stop-limit to the supported orderType values for POST /v1/prediction-markets/order
  • Added stopPrice field to the order request and response schemas (required when orderType is stop-limit)
• WebSocket - order.place
  • Clarified that supplying stopPrice with type: "LIMIT" places a stop-limit order (activates as a limit once the trigger is reached). Documented BUY/SELL price constraints.

2026-04-15

• Market Data - Get Assets for Network
  • Changed /v2/networks/{network}/assets endpoint from public to authenticated; now requires API key with Fund Manager or Auditor role

2026-04-09

• Prediction Markets - Maker Rebate Program
  • Updated promotional rebate rates start date to April 9, 2026; promotional period runs April 9 - May 9, 2026
  • Simplified rebate rates table to show promotional and post-promotional periods only

2026-04-08

• Prediction Markets - Crypto Tickers
  • Updated 5-minute and 15-minute contract examples to use UP contract type instead of HI{PRICE}
  • Added UP contract documentation for short-duration contracts where strike price is returned via API response
  • Legacy HI{PRICE} format noted as deprecated for short-duration contracts

2026-04-07

• Prediction Markets - Positions Endpoint
  • Added new position fields: quantityOnHold, prices, resolutionSide, isAboveAutoStartThreshold, isLive, realizedPl
  • Added new prices sub-object with buy/sell prices for yes/no outcomes, plus bestBid, bestAsk, and lastTradePrice
  • Added new contract metadata fields: eventImageUrl, eventType, resolutionSide, sortOrder, parentEventTicker, template, color, startTime
  • Added total field to response for pagination support

2026-04-04

• /v1/balances
  • Clarified that the amount field (confirmed balance) is not reduced until the withdrawal has been confirmed on the blockchain, as a safeguard against blockchain reorganizations
  • Clarified that the available field is reduced immediately when an order hold or withdrawal hold is placed, making it the recommended field for tracking real-time spendable balances
  • Recommend using showPendingBalances: true for explicit pendingDeposit/pendingWithdrawal visibility (note: slower response due to additional database lookup)

2026-04-01

• Trading
  • Added WebSocket quickstart section to the Trading landing page with Python and Node.js code samples for connecting to wss://ws.gemini.com, streaming real-time prices, placing orders, and handling fill notifications

2026-03-31

• Prediction Markets - Getting Started
  • Removed US-only trading restriction callout
• Prediction Markets - Maker Rebate Program
  • Updated program status to reflect that the Maker Rebate Program is now live
  • Updated April 10 and May 10 dates to April 9 and May 9

2026-03-30

• Prediction Markets - Sports Tickers
  • Added Individual Sports section (Golf, Formula 1) with tournament/race-based ticker format
• Prediction Markets - Strike Endpoint
  • Added GET /v1/prediction-markets/events/{eventTicker}/strike endpoint to retrieve strike price for a specific event
  • Returns strike value, type, and availableAt for crypto Up/Down contracts

2026-03-27

• Prediction Markets - Maker Rebate Program
  • Added promotional rebate rates effective April 10, 2026 - May 10, 2026 for Crypto and Commodities (0.70), Sports (0.50), and All other markets (0.30)
• Prediction Markets - Weather Tickers
  • Added Weather Ticker Format specification for highest temperature prediction markets
  • Supports five locations: NYC, MDW, MIA, LAX, BOS with LO, range, and HI contract types
• Prediction Markets - Crypto Up/Down Contracts
  • Added strike object to Contract schema with value, type, and availableAt fields for Up/Down contracts
  • Added source field to Contract and Event schemas for data source identifier (e.g., GRR-KAIKO_BTCUSD_60S)
  • Added settlementValue field to Contract schema for observed settlement price
  • Added settlement object to Event schema with observed value at expiry

2026-03-26

• Prediction Markets - Commodities Tickers
  • Added Commodities Ticker Format documentation for commodity price prediction markets
  • Supported commodities: Natural Gas (NGAS), Oil (WTI, BRENT), Copper (COPPER), Silver (XAG), Gold (XAU)

2026-03-25

• Prediction Markets - Trading
  • Added maker-or-cancel option to timeInForce parameter for POST /v1/prediction-markets/order
  • Maker-or-cancel orders only add liquidity to the order book; if any part would fill immediately, the entire order is cancelled (also known as "post-only")
  • Useful for ensuring orders qualify for maker rebates
• Fund Management
  • Added v2 fee estimation endpoint POST /v2/withdraw/\{network\}/\{ticker\}/feeEstimate with explicit blockchain network support for multi-network tokens
  • Added v2 withdraw endpoint POST /v2/withdraw/{network}/{ticker} with explicit network selection for multi-chain token withdrawals
  • Added network-aware v2 transfers endpoint POST /v2/transfers with full multichain support for deposits and withdrawals
• GET /v2/networks/{network}/assets
  • Added new v2 reverse asset lookup endpoint for discovering which tokens are available on a given blockchain network
  • Returns alphabetically sorted array of asset codes with support for all enabled networks
• GET /v2/network/{token}
  • Added authenticated v2 network endpoint that returns available networks filtered by account-level deposit and withdraw access
• WebSocket API - Connection Parameters
  • Added documentation for the cancelOnDisconnect connection-level query parameter
  • When enabled (?cancelOnDisconnect=true), all open orders are automatically cancelled when the WebSocket session disconnects

2026-03-21

• Prediction Markets - Crypto Tickers
  • Updated HI contract description from "greater than" to "greater than or equal to" to accurately reflect the >= threshold behavior

2026-03-16

• /v1/balances
  • Updated examples to use showPendingBalances: false as the default
  • Added note that setting showPendingBalances to true results in slower response times due to additional database lookups
  • Added _timestamp field to the balance response schema — a monotonically increasing server-side clock in nanoseconds, allowing clients to detect and filter out stale responses

2026-03-13

• Prediction Markets - Getting Started
  • Updated getting started guide with WebSocket-first trading examples in Node.js and Python
• WebSocket API - Connection Parameters
  • Added documentation for the snapshot connection-level query parameter
  • The snapshot parameter controls initial orderbook snapshot delivery when subscribing to differential depth streams
  • Supports full snapshot (-1), top N levels (positive integer), or no snapshot (0, default)
• Prediction Markets - Maker Rebate Program
  • For makers and takers feed fixed links so the page jumps to the specific section
• Prediction Markets - Navigation
  • Flattened prediction markets page structure to fix sidebar navigation links
  • Added URL redirects for backward compatibility with old nested paths
• llms.txt
  • Fixed llms.txt generation to exclude internal Zudoku routes (~endpoints, ~schemas) from sitemap-derived links

2026-03-12

• Prediction Markets - Maker Rebate Program

  • Added Maker Rebate Program documentation with rebate formula, rates, eligibility, examples, and payment details
  • Rebate rates table now includes period column
  • Rebate examples table now includes Taker Rate, Rebate Rate, and Maker Rebate columns
  • Rebate precision changed from rounded up to rounded down
  • Simplified eligibility section
  • Clarified maker order definition in overview
  • Added links to fee schedule in rebate examples table headers
  • Bolded linked column headers in rebate examples table for consistency

• Prediction Markets - Getting Started

  • Removed "US Only" callout from Getting Started page

2026-03-04

• Prediction Markets - Discovery Endpoints

  • Added GET /v1/prediction-markets/events/newly-listed for events created in the last 24 hours
  • Added GET /v1/prediction-markets/events/recently-settled for events settled in the last 24 hours
  • Added GET /v1/prediction-markets/events/upcoming for approved pre-launch events
  • All discovery endpoints support category filtering and pagination (limit/offset)

• Prediction Markets - Contract Pricing

  • Replaced price field with prices object containing buy, sell, bestBid, bestAsk, and lastTradePrice
  • Added abbreviatedName, marketState, and sortOrder fields to Contract schema
  • Added Subcategory schema with id, slug, name, and path fields
  • Added approved status to MarketStatus enum
  • Updated max limit parameter from 100 to 500

• Prediction Markets - Volume Metrics

  • Added POST /v1/prediction-markets/metrics/volume endpoint for per-contract share volume metrics
  • Returns total volume, user taker (aggressor) volume, and user maker (resting) volume per contract
  • Supports optional time range filtering via startTime and endTime parameters

• Prediction Markets - Tickers

  • Corrected sports ticker prefix from GEM- to GEMI-

2026-02-25

• Prediction Markets - Crypto Ticker Format
  • Added duration markers for 5-minute and 15-minute interval crypto contracts
  • 5-minute contracts now use format: BTC05M2602251745 (with 05M marker)
  • 15-minute contracts now use format: BTC15M2602251745 (with 15M marker)
  • All other durations continue to use format without duration marker: BTC2603230800
  • Updated full ticker examples, regex patterns, and validation rules

2026-02-24

• WebSocket API
  • Updated public WebSocket URL from wss://wsapi.fast.gemini.com to wss://ws.gemini.com

2026-02-22

• WebSocket Documentation
  • Renamed "Fast API" references to "WebSocket API" for clarity and consistency across introduction, authentication, message format, and stream reference pages

2026-02-18

• WebSocket Documentation
  • Updated contact information for WebSocket high performance tier onboarding

2026-02-18

• WebSocket Documentation
  • Fixed broken internal links: updated all remaining /websocket/fast-api/* references to /websocket/* across documentation pages, config, and plugins

2026-02-17

• WebSocket API
  • Updated onboarding instructions for WebSocket high performance tiers

2026-02-16

• WebSocket Documentation
  • Simplified URL structure: WebSocket documentation moved from /websocket/fast-api/* to /websocket/*
  • Updated paths: /websocket/fast-api/introduction → /websocket/introduction (and similar for all WebSocket pages)
  • Maintained backward compatibility with /fast-api redirect

2026-02-15

• WebSocket API
  • Updated Fast API status from Production Beta to Production
  • Archived old WebSocket API v1/v2, Order Events, and Multi Market Data documentation under the Archived tab
  • Fixed broken links to removed WebSocket documentation across the site

2026-02-14

• FastAPI - Message Format - Stream Reference
  • Fixed error.code type from string to number in message format documentation
  • Added missing OPEN and MODIFIED order statuses to order events
  • Added O (eventOutcome) field to order events for event contracts
  • Added timestamp units (nanoseconds/milliseconds) to all stream field tables
  • Added error codes reference table with all status codes
  • Added rejection and cancellation reason tables for order events
  • Added note that order event fields with empty values may be omitted
  • Updated id field type to string | number across request/response docs
  • Updated interactive API fallback spec to match live api.json (v0.10.10)
  • Clarified the Z (Executed quantity) field description to explain its different meanings depending on event type: last fill quantity for FILLED / PARTIALLY_FILLED events, cumulative filled quantity for CANCELED and other events.

2026-02-13

• Prediction Markets

  • Added Ticker Format specifications for crypto and sports prediction markets

• FastAPI balances@account@1s Stream

  • Documentation for new balances@account@1s FastAPI websocket stream that sends periodic balance snapshots every second.

2026-02-02

• Prediction Markets REST API
  • Updated MarketStatus enum value from underreview to under_review for consistency with snake_case naming convention

2026-01-23

• GET /v1/network/{token}
  • Updated documentation to clarify multi-network support for tokens
  • Added example showing USDC available on multiple networks (Optimism, Solana, Base, Arbitrum, Monad, Avalanche, Ethereum)
  • Expanded list of supported networks in schema description

2026-01-21

• Order Events API Update
  • Added one-liner to add stop price as a field

2026-01-14

• /v1/balances showPendingBalances Parameter
  • Documentation for optional showPendingBalances parameter for /v1/balances endpoint.

2026-01-14

• FastAPI balances@account Stream
  • Documentation for new balances@account FastAPI websocket stream.

2026-01-08

• FIX Dictionary
  • Added 7777 EventOutcome FIX tag for prediction markets orders.

2025-12-16

• Transfer History
  • POST /v1/transfers - show_completed_deposit_advances default value updated to True.

2025-12-15

• WebSocket API

  • Updated WebSocket overview introduction to highlight Fast API as next-generation solution
  • Added recommendation for new integrations to start with Fast API
  • Added cross-references between traditional WebSocket APIs and Fast API

• Prediction Markets REST API

  • Added new Prediction Markets API documentation section with complete examples
  • Discovery endpoints (public):
    • GET /v1/prediction-markets/events - List prediction market events with filtering
    • GET /v1/prediction-markets/events/{eventTicker} - Get event details by ticker
    • GET /v1/prediction-markets/categories - List available event categories
  • Trading endpoints (authenticated):
    • POST /v1/prediction-markets/order - Place a prediction market limit order (only limit orders supported)
    • POST /v1/prediction-markets/order/cancel - Cancel an existing order
  • Position endpoints (authenticated):
    • POST /v1/prediction-markets/orders/active - Get active orders
    • POST /v1/prediction-markets/orders/history - Get order history
    • POST /v1/prediction-markets/positions - Get current positions
  • Market data: Use existing REST and WebSocket market data endpoints with prediction market contract symbols (e.g., GEMI-BTC100K-YES)
  • Documentation enhancements:
    • Added comprehensive request/response examples to all endpoints
    • Created Getting Started guide with complete workflow walkthrough and Python code examples
    • Added examples for order placement (buy/sell), active orders, events discovery, and positions

2025-11-20

• FIX Order Entry - Tag 544 (CashMargin) Restrictions
  • Updated documentation for tag 544 (CashMargin) field restrictions across different order types
  • Tag 544 Support Matrix:

Order Type	Buy Side (Side=1)	Sell Side (Side=2)	Error Message (if not supported)
Market	✅ Supported	❌ Not Supported	"CashMargin <544> not supported for sell orders"
Limit	✅ Supported	❌ Not Supported	"CashMargin <544> not supported for sell orders"
Stop-Limit	❌ Not Supported	❌ Not Supported	"CashMargin <544> not supported for stop-limit orders"

• Key Points:
  • Stop-limit orders: Tag 544 is completely unsupported regardless of side
  • Market/Limit orders: Tag 544 is only supported for buy-side orders (Side=1)
  • Sell-side restriction: Any sell order (Side=2) with tag 544 will be rejected
  • Clients should only include tag 544 for buy-side market or limit orders

2025-11-18

• Margin Trading
  • Added /v1/margin/account endpoint to retrieve margin account summary and risk statistics
  • Added /v1/margin/rates endpoint to retrieve current margin interest rates
  • Added /v1/margin/order/preview endpoint to preview margin impact of spot orders

2025-10-31

• Mark Price WebSocket API
  • Updated mark price documentation to also support select spot pairs.

2025-10-07

• Fast API WebSocket API
  • Updated trade stream documentation to remove Order ID, Trade Time, and Side from the event message.

2025-10-01

• Fast API WebSocket API
  • Created initial documentation for the new Fast API

2025-09-10

• REST
  • Updated /v1/account to include optional virtual_account_number field in response

2025-07-10

• REST
  • Updated /v1/balances to reflect new response fields pendingWithdrawal and pendingDeposit

2025-05-30

• REST
  • Updated /v1/balances to only accept a single account

2025-05-20

• REST - Websocket - FIX Market Data - FIX Order Entry - FIX Drop Copy
  • Improve API docs website

2025-05-19

• REST
  • Remove Documentation for /v1/approvedAddresses/:network/request

2025-03-14

• REST - Websocket - FIX Market Data
  • Documentation for new token support ARB
  • Documentation for new token support RLUSD

2025-02-10

• REST
  • Remove Documentation for delisted perps support MATIC

2025-01-28

• REST - Websocket - FIX Market Data
  • Remove Documentation for delisted token: LTCBCH, BCHETH,BCHBTC

2025-01-21

• REST
  • Documentation for new perps support TRUMP

2024-12-26

• REST - Websocket
  • Documentation for new token support CHILLGUY

2024-12-10

• REST
  • Documentation for new perps support SHIB, UNI, BCH

2024-11-27

• REST - Websocket
  • Documentation for new token support FLOKI, PYTH

2024-11-19

• REST - Websocket
  • Documentation for new token support PNUT, GOAT, MEW, BOME

2024-11-15

• REST - Websocket
  • Documentation for new token support MOODENG

2024-11-04

• REST - Websocket
  • Documentation for new token support BONK, POPCAT, OP

2024-09-20

• REST - Websocket - FIX Market Data
  • Remove Documentation for delisted token: LUNA,SNX,QRDO,ZBC

2024-09-18

• REST - Websocket
  • API Change Remove Documentation for support /v1/balances/earn, /v1/earn/rates, /v1/earn/interest
  • Documentation for new token support WIF

2024-05-21

• Websocket
  • Adding 'tid' to the TRADE RESPONSE events under Market Data v2

2024-05-05

• REST - Websocket
  • Remove Documentation for delisted token: OXT-BTC,OXT-ETH,BAT-BTC,BAT-ETH, BTC-DAI, ETH-DAI

2024-04-23

• Websocket - FIX Market Data
  • Remove Documentation for delisted token: ZEC

2024-04-05

• REST
  • Documentation for new perps support WIF

2024-03-04

• FIX Market Data
  • New Feature: Add FundingAmount support

2024-02-29

• REST
  • Documentation for new perps support MATIC, DOGE, LINK, AVAX, LTC, DOT

2024-02-06

• REST
  • Documentation for new perps support XPR, SOL

2023-11-15

• REST - Websocket - FIX Market Data
  • Remove Documentation for delisted token: MIR, UST, FXS, FRAX, BUSD

2023-09-18

• REST - Websocket - FIX Market Data
  • Removed Documentation for new token support: MPL, MC, METIS, RBN, GFI, LQTY, and LUSD

2023-09-11

• REST - Websocket - FIX Market Data
  • Documentation for new token support: HNT

2023-08-10

• REST - Websocket - FIX Market Data
  • Documentation for new token support: XRP

2023-08-04

• REST - Websocket - FIX Market Data
  • Documentation for token delist: ENJ

2023-05-29

• REST
  • Updated /v1/order/status to specify orderId as negative

2023-05-23

• REST
  • Removed: Fund Management APIs -> SEN Withdrawals

2023-05-09

• REST - Websocket
  • Documentation for new token support: PEPE

2023-05-08

• FIX Market Data
  • Corrected documentation (symbol) for BTC-GUSD-PERP

2023-02-16

• FIX Market Data
  • New Feature: Add MarkPrice support

2023-01-19

• REST
  • Updated json response for Transfers to include type:Reward and method:CreditCard

2023-01-10

• REST - Websocket - FIX Market Data
  • Documentation for new token support: ATOM, USDT

2022-11-03

• REST
  • New Feature Documentation for Gemini Staking

2022-10-21

• FIX Order Entry
  • New Feature: Add fix tag 9000 RiskLiquidityFlag. Indicates whether or not the order should match against Liquidation Orders sent from the Liquidation Engine. Only allowed from permissioned Market Makers.

2022-10-11

• REST - Websocket - FIX Market Data
  • Documentation for new token support: AVAX

2022-10-03

• REST
  • Remove Gemini Dollar section

2022-09-14

• REST
  • New Feature Documentation for Transactions and Clearing Trades

2022-09-07

• REST - Websocket - FIX Market Data
  • Documentation for new token support: BUSD

2022-08-23

• REST - Websocket - FIX Market Data
  • Documentation for new token support: BICO, IMX, PLA, IOTX

2022-08-01

• REST - Websocket - FIX Market Data
  • Documentation for new token support: GAL, EUL, SAMO

2022-07-06

• REST - Websocket - FIX Market Data
  • Documentation for new token support: DOT, ERN

2022-06-29

• REST
  • API Change Adding symbol parameter to Get Notional Volume

2022-06-23

• REST - Websocket - FIX Order Entry - FIX Drop Copy
  • Deprecating documentation for Auction and Block trading support

2022-06-22

• REST
  • API Change Adding since_tid parameter to Trade History
  • Documentation for new token support: GUSDGBP
• Websocket
  • Documentation for new token support: GUSDGBP

2022-06-15

• REST
  • Documentation improvement to json example for Symbol Details
  • New Feature Documentation for Gas Fee Estimation

2022-06-14

• REST
  • API Change Removed parameter client_order_id from the trades array of order-status
  • Documentation for new token support: ALI, TRU
• Websocket - FIX Market Data
  • Documentation for new token support: ALI, TRU

2022-06-07

• REST
  • New Feature Documentation for FX Rates

2022-06-01

• REST
  • New Feature Documentation for Renaming an Account

2022-05-25

• REST
  • New Feature Documentation for Adding A Bank CAD

2022-05-18

• REST
  • New Feature Documentation for Clearing Order List, Clearing Broker List and Custody Account Fees
• FIX Order Entry - FIX Market Data - FIX Drop Copy
  • Add additional examples of using the API

2022-05-17

• REST - Websocket - FIX Market Data
  • Documentation for new token support: GFI, ORCA

2022-05-09

• FIX Order Entry
  • Update FIX Order Cancel Reject details

2022-04-27

• REST - Websocket - FIX Market Data
  • Documentation for new token support: METIS, QRDO, ZBC, CHZ, REVV, JAM, FIDA, GMT

2022-04-26

• REST - Websocket - FIX Market Data
  • Documentation for new token support: GUSDSGD

2022-03-29

• REST - Websocket - FIX Market Data
  • Documentation for new token support: RBN, FXS, DPI, LQTY, LUSD, FRAX, INDEX, MPL

2022-03-16

• REST - Websocket - FIX Market Data
  • Documentation for new token support: APE

2022-03-01

• REST - Websocket - FIX Market Data
  • Documentation for new token support: RAY, SBR

2022-02-28

• REST - Websocket - FIX Market Data
  • Documentation for new token support: SOL

2022-02-08

• REST
  • API Change Added new parameter clientTransferId to Transfer Between Accounts and Withdraw Crypto Funds

2022-02-01

• REST - Websocket - FIX Market Data
  • Documentation for new token support: TOKE, LDO, RLY

2022-01-28

• REST
  • New Feature Documentation for Earn History

2022-01-24

• FIX Order Entry
  • Update Third Party Execution Report details

2021-12-20

• REST - Websocket - FIX Market Data
  • Documentation for new token support: RNDR, MC, GALA, ENS, KP3R, CVC, ELON, MIM, SPELL

2021-11-13

• REST - Websocket - FIX Market Data
  • Documentation for new token support: WCFG, RARE, RAD, QNT, NMR, MASK, FET, ASH, AUDIO, API3, USDC, SHIB

2021-10-06

• REST
  • New Feature Documentation for Wrap Order

2021-09-15

• REST - Websocket - FIX Market Data
  • Documentation for new token support: AXS, SLP, LUNA, UST, MCO2

2021-08-06

• REST
  • New Feature Documentation for Earn Balances, Earn Rates and Earn Interest

2021-07-21

• REST - Websocket - FIX Market Data
  • Documentation for new token support: XTZ

2021-07-14

• REST - Websocket - FIX Market Data
  • Documentation for new token support: CTX

2021-06-16

• REST - Websocket - FIX Market Data
  • Documentation for new token support: ALCX, MIR, FTM, ANKR

2021-06-07

• REST
  • API Change Added is_clearing_fill to List Past Trades response

2021-05-06

• REST
  • New Feature Documentation for SEN Withdrawals

2021-05-05

• REST - Websocket - FIX Market Data
  • Documentation for new token support: DOGE

2021-04-27

• REST - Websocket - FIX Market Data
  • Documentation for new token support: CUBE, LPT, BOND, MATIC, INJ, SUSHI

2021-04-16

• REST
  • API Change List Approved Addresses has changed from a GET to a POST HTTP request

2021-04-08

• REST
  • API Change Symbol Details endpoint has updated parameters

2021-03-29

• Websocket
  • Documentation for new Multi Market Data Feed

2021-03-22

• REST - Websocket - FIX Market Data
  • Documentation for new token support: SKL, GRT, BNT, 1INCH, ENJ, LRC, SAND

2021-03-11

• Websocket
  • Added new optional heartbeat filter

2021-02-23

• REST
  • New Feature Documentation for Order Status now includes an optional include_trades parameter

2021-01-28

• REST - Websocket
  • Documentation for new symbol support: BTCSGD and ETHSGD

2020-10-28

• REST
  • New Feature Documentation for new Symbol Details endpoint

2020-10-26

• REST
  • Documentation for new fiat support: GBP and EUR

2020-10-14

• Websocket
  • Documentation for new token support: FIL

2020-10-07

• Websocket
  • Documentation for new token support: AAVE

2020-10-05

• Websocket - FIX Market Data
  • Documentation for new order book support: BTCDAI and ETHDAI

2020-09-24

• REST - FIX Market Data
  • Documentation for new token support: MKR, ZRX, KNC, MANA, STORJ, SNX, CRV, BAL, UNI, REN, UMA, YFI

2020-09-11

• REST - FIX Market Data
  • Documentation for new token support: AMP, COMP, PAXG

2020-08-28

• REST - Websocket - FIX Market Data
  • Removing DAIBTCand DAIETH trading pairs

2020-07-23

• REST
  • New Feature Documentation for Adding a Bank, Viewing Payment Methods and Account Detail

2020-04-09

• REST - Websocket
  • Documentation for new token support: BAT, DAI, LINK, OXT

2020-03-05

• REST
  • New Feature Documentation for Retrieving deposit addresses, List Prices, and Notional Balances

2019-11-22

• Websocket
  • Updated response messages for Candles Data Feed on Market Data v2

2019-11-18

• REST
  • New Feature Updating Stop order documentation

2019-11-12

• REST
  • New Feature Documentation for Stop Orders and Group->Master API key reference changes
• FIX Order Entry
  • Add documentation for Stop Order flow

2019-08-16

• REST
  • New Feature Documentation for Account Administration APIs and Group Level API keys

2019-08-08

• REST
  • New Feature Documentation for Gemini Clearing functionality
• FIX Order Entry
  • Add documentation for Gemini Clearing
• FIX Drop Copy
  • New Feature: Document Third Party Support

2019-06-20

• Websocket
  • Adding documentation for Market Data v2 and Candles Data Feed

2019-06-07

• REST
  • Add documentation for ticker v2 and candles endpoints

2019-05-31

• REST
  • Add legacy parameter for LTC address generation

2019-03-22

• REST
  • Add Gemini Dollar section and detail changes to Withdrawals

2019-03-01

• REST
  • Document changes to Notional Volume

2018-09-21

• FIX Drop Copy
  • Updated OMS third party trade capture report example

2018-09-14

• REST
  • Document new fill-or-kill order placement options
• FIX Order Entry
  • Add Documentation for fill-or-kill orders

2018-09-10

• REST
  • Added Gemini dollar example to Transfers

2018-08-07

• FIX Market Data
  • API Change Added support for maker side using custom tags 9002 MDEntryMakerSide and EnableMDEntryMakerSide

2018-06-18

• FIX Order Entry
  • Add examples for order cancel reason

2018-06-06

• Websocket
  • API Change Market depth and entry filtering added to Market Data API

2018-05-18

• FIX Order Entry - FIX Market Data - FIX Drop Copy
  • Add additional examples of using the API

2018-04-30

• FIX Order Entry
  • Document actual examples of Reject messages and Execution Report rejects in an errors section

2018-04-06

• REST
  • New Feature: Document Transfers endpoint
  • New Feature: Document block trading support
• Websocket
  • API Change Document block trades in Market Data and Order Events APIs
• FIX Order Entry
  • New Feature: Document block trading support. Add IOI <6> for broadcast of IOI to block trade market makers and update New Order Single <D> with options for placing an IOI and responding to an IOI
• FIX Market Data - FIX Drop Copy
  • New Feature: Document block trading support

2018-03-09

• FIX Market Data
  • Documentation bugfix: correct [MsgType <35>][MsgType] tag number in documentation for Symbol List Request <x>
  • Documentation improvement: added examples of Symbol List Request <x> and Symbol List <y> messages

2018-02-22

• REST
  • Document List Past Trades endpoint recipe for retrieving full trade history
• FIX Order Entry
  • New Feature: Document Third Party Support. Add [OnBehalfOfCompID <115>][OnBehalfOfCompID] field to Standard Header
• FIX Drop Copy
  • New Feature: Document Third Party Support. Clarify usage of Party IDs and Roles

2018-02-09

• REST
  • API Change update API Error Codes

2018-02-08

• REST
  • Better explanation of how Gemini rate limits public and private API requests; better client order id documentation
• Websocket
  • Better market data examples

2018-01-22

• FIX Market Data
  • Documentation bugfix: fixed [ExpireTime <126>][ExpireTime] tag number in documentation for Market Data - Incremental Refresh <X> and Market Data - Snapshot / Full Refresh <W>
  • Documentation improvement: added examples of Market Data Request <V>, Market Data - Incremental Refresh <X>, and Market Data - Snapshot / Full Refresh <W> messages

2017-12-01

• REST
  • API Change added collar_price to Current Auction and Auction History
• Websocket
  • API Change collar_price added to Market Data API
• FIX Market Data
  • API Change added [MDEntryType <269>][MDEntryType] value 3 = INDEX_VALUE to Market Data - Incremental Refresh <X> to support reporting the auction collar price

2017-11-30

• REST
  • API Change clarify that only seven calendar days of data will be available through public API endpoints at Trade History and Auction History. Email support@gemini.com for information about Gemini market data

2017-11-17

• FIX Order Entry
  • Add ExecInst=6 for Maker-or-Cancel orders

2017-08-30

• FIX Market Data
  • Documentation bugfix: clarified description of [MDEntryType <269>][MDEntryType] in Market Data - Snapshot / Full Refresh <W>

2017-08-10

• Websocket
  • New Feature to make it easy to detect WebSocket messages that were missed or received out-of-order, Gemini has added a socket_sequence field to both the Market Data and Order Events APIs. Further details available in Sequence Numbers

2017-07-27

• REST
  • Improved code sampled in Private API Invocation
  • Added Troubleshooting section
  • Clarified precision in Symbols and Minimums
  • Documentation bugfix: List Past Trades endpoint now clarifies that timestamp parameter is on or after, not just after
• Websocket
  • Documentation bugfix: clarify the purpose of the trace_id in Order Events: Heartbeats

2017-07-13

• Websocket
  • API Change timestamp and timestampms added to [Market Data](/websocket/market-

2017-05-31

• REST
  • Added explanation about using limit orders with the immediate-or-cancel execution option instead of market orders to Create New Order endpoint

2017-05-22

• REST
  • API Change bugfix to timestamp handing in POST requests. Previously a timestamp submitted as a string was silently ignored; timestamps submitted as strings will now be parsed. No timestamp request parameter will be silently discarded. Updated documentation at Data Types: Timestamps to reflect timestamp behavior in requests and responses

2017-05-19

• REST
  • API Change order status JSON changed to always include an options array with order execution options. If no order execution options were submitted with the original order, the array will be empty

2017-05-15

• REST
  • Better JSON examples for all the Order Status API endpoints
• Websocket
  • Clarified how Gemini rate limits incoming requests to public WebSocket APIs
  • Document Order Events Subscription Acknowledgement subscriptionId field

2017-05-02

• REST
  • Clarify how rate limits are applied

2017-03-30

• REST
  • Improved documentation for List Past Trades and Get Available Balances

2017-03-06

• Websocket
  • Documentation bugfix: correct location of market data JSON example for trade events

2017-02-22

• REST
  • Added recipe for retrieving full trade history from List Past Trades endpoint

2016-12-14

• REST - Websocket
  • New feature: API key roles, crypto deposit and withdrawal endpoints

2016-11-10

• Websocket
  • Initial WebSocket API documentation

2016-08-23

• REST
  • New feature: auction documentation added to new order placement, public APIs, and streaming market data

2016-05-31

• REST
  • Add ETH to supported symbols

2016-04-27

• REST
  • Document marker-or-cancel and immediate-or-cancel order placement options

2016-03-23

• FIX Order Entry - FIX Market Data - FIX Drop Copy
  • Initial FIX API documentation

2015-12-22

• REST
  • Document sandbox usage

2015-10-05

• REST
  • Initial REST API documentation