# Revision History ## Changes These release notes list changes to Gemini Exchange API. ### [2026-06-02](#2026-06-02) - **WebSocket** - **Prediction Markets WebSocket** - Documented the `c` (confirmed balance) field in the Balance Updates stream — represents the total balance including pending amounts; `f` (available balance) is the amount available to trade ### [2026-06-01](#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](#2026-05-29) - **OAuth 2.0** - **Public Clients** - Documented public clients and the required [PKCE](/authentication/oauth#public-clients-and-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](#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](#2026-05-27) - **REST APIs** - **Common** - **Admin** - Added [Subaccounts](/rest-api/common/admin/subaccounts) overview — account hierarchy, API key mechanics, and patterns for agentic trading, prediction market bots, and team/client isolation ### [2026-05-26](#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](#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](#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](#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](#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](#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](#2026-05-15) - **WebSocket** - **Navigation** - Added Introduction page to both Trading and Prediction Markets WebSocket sections ### [2026-05-14](#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](#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](#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](#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](#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](#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](#2026-05-01) - **Prediction Markets** - **Maker Rebate Program** - Removed outdated April 9, 2026 promotional offer notice ### [2026-04-29](#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](#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](#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](#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](#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](#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](#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](#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](#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](#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](#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](#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](#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](#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](#2026-03-26) - **Prediction Markets** - **Commodities Tickers** - Added [Commodities Ticker Format](/prediction-markets/tickers-commodities) documentation for commodity price prediction markets - Supported commodities: Natural Gas (`NGAS`), Oil (`WTI`, `BRENT`), Copper (`COPPER`), Silver (`XAG`), Gold (`XAU`) ### [2026-03-25](#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](/prediction-markets/maker-rebate-program) - **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](#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](#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](#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](#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](#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](#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](#2026-02-24) - **WebSocket API** - Updated public WebSocket URL from `wss://wsapi.fast.gemini.com` to `wss://ws.gemini.com` ### [2026-02-22](#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](#2026-02-18) - **WebSocket Documentation** - Updated contact information for WebSocket high performance tier onboarding ### [2026-02-18](#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](#2026-02-17) - **WebSocket API** - Updated onboarding instructions for WebSocket high performance tiers ### [2026-02-16](#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](#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](#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](#2026-02-13) - **Prediction Markets** - Added [Ticker Format](/prediction-markets/tickers-overview) 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](#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](#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](#2026-01-21) - **Order Events API Update** - Added one-liner to add stop price as a field ### [2026-01-14](#2026-01-14) - **/v1/balances showPendingBalances Parameter** - Documentation for optional `showPendingBalances` parameter for /v1/balances endpoint. ### [2026-01-14](#2026-01-14) - **FastAPI balances@account Stream** - Documentation for new `balances@account` FastAPI websocket stream. ### [2026-01-08](#2026-01-08) - **FIX Dictionary** - Added `7777 EventOutcome` FIX tag for prediction markets orders. ### [2025-12-16](#2025-12-16) - **Transfer History** - `POST /v1/transfers` - `show_completed_deposit_advances` default value updated to True. ### [2025-12-15](#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](#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](#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](#2025-10-31) - **Mark Price WebSocket API** - Updated mark price documentation to also support select spot pairs. ### [2025-10-07](#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](#2025-10-01) - **Fast API WebSocket API** - Created initial documentation for the new Fast API ### [2025-09-10](#2025-09-10) - **REST** - Updated `/v1/account` to include optional `virtual_account_number` field in response ### [2025-07-10](#2025-07-10) - **REST** - Updated `/v1/balances` to reflect new response fields `pendingWithdrawal` and `pendingDeposit` ### [2025-05-30](#2025-05-30) - **REST** - Updated `/v1/balances` to only accept a single account ### [2025-05-20](#2025-05-20) - **REST** - **Websocket** - **FIX Market Data** - **FIX Order Entry** - **FIX Drop Copy** - Improve API docs website ### [2025-05-19](#2025-05-19) - **REST** - Remove Documentation for `/v1/approvedAddresses/:network/request` ### [2025-03-14](#2025-03-14) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support `ARB` - Documentation for new token support `RLUSD` ### [2025-02-10](#2025-02-10) - **REST** - Remove Documentation for delisted perps support `MATIC` ### [2025-01-28](#2025-01-28) - **REST** - **Websocket** - **FIX Market Data** - Remove Documentation for delisted token: `LTCBCH`, `BCHETH`,`BCHBTC` ### [2025-01-21](#2025-01-21) - **REST** - Documentation for new perps support `TRUMP` ### [2024-12-26](#2024-12-26) - **REST** - **Websocket** - Documentation for new token support `CHILLGUY` ### [2024-12-10](#2024-12-10) - **REST** - Documentation for new perps support `SHIB`, `UNI`, `BCH` ### [2024-11-27](#2024-11-27) - **REST** - **Websocket** - Documentation for new token support `FLOKI`, `PYTH` ### [2024-11-19](#2024-11-19) - **REST** - **Websocket** - Documentation for new token support `PNUT`, `GOAT`, `MEW`, `BOME` ### [2024-11-15](#2024-11-15) - **REST** - **Websocket** - Documentation for new token support `MOODENG` ### [2024-11-04](#2024-11-04) - **REST** - **Websocket** - Documentation for new token support `BONK`, `POPCAT`, `OP` ### [2024-09-20](#2024-09-20) - **REST** - **Websocket** - **FIX Market Data** - Remove Documentation for delisted token: `LUNA`,`SNX`,`QRDO`,`ZBC` ### [2024-09-18](#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](#2024-05-21) - **Websocket** - Adding 'tid' to the TRADE RESPONSE events under [Market Data v2](/websocket/market-data-v2/index) ### [2024-05-05](#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](#2024-04-23) - **Websocket** - **FIX Market Data** - Remove Documentation for delisted token: `ZEC` ### [2024-04-05](#2024-04-05) - **REST** - Documentation for new perps support `WIF` ### [2024-03-04](#2024-03-04) - **FIX Market Data** - **New Feature:** Add FundingAmount support ### [2024-02-29](#2024-02-29) - **REST** - Documentation for new perps support `MATIC`, `DOGE`, `LINK`, `AVAX`, `LTC`, `DOT` ### [2024-02-06](#2024-02-06) - **REST** - Documentation for new perps support `XPR`, `SOL` ### [2023-11-15](#2023-11-15) - **REST** - **Websocket** - **FIX Market Data** - Remove Documentation for delisted token: `MIR`, `UST`, `FXS`, `FRAX`, `BUSD` ### [2023-09-18](#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](#2023-09-11) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `HNT` ### [2023-08-10](#2023-08-10) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `XRP` ### [2023-08-04](#2023-08-04) - **REST** - **Websocket** - **FIX Market Data** - Documentation for token delist: `ENJ` ### [2023-05-29](#2023-05-29) - **REST** - Updated /v1/order/status to specify orderId as negative ### [2023-05-23](#2023-05-23) - **REST** - Removed: Fund Management APIs -> SEN Withdrawals ### [2023-05-09](#2023-05-09) - **REST** - **Websocket** - Documentation for new token support: `PEPE` ### [2023-05-08](#2023-05-08) - **FIX Market Data** - Corrected documentation (symbol) for BTC-GUSD-PERP ### [2023-02-16](#2023-02-16) - **FIX Market Data** - **New Feature:** Add MarkPrice support ### [2023-01-19](#2023-01-19) - **REST** - Updated json response for [Transfers](/rest/fund-management#list-past-transfers) to include type:`Reward` and method:`CreditCard` ### [2023-01-10](#2023-01-10) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `ATOM`, `USDT` ### [2022-11-03](#2022-11-03) - **REST** - **New Feature** Documentation for [Gemini Staking](/rest/gemini-staking) ### [2022-10-21](#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](#2022-10-11) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `AVAX` ### [2022-10-03](#2022-10-03) - **REST** - Remove Gemini Dollar section ### [2022-09-14](#2022-09-14) - **REST** - **New Feature** Documentation for [Transactions](/rest/fund-management#get-transaction-history) and [Clearing Trades](/rest/clearing#list-clearing-trades) ### [2022-09-07](#2022-09-07) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `BUSD` ### [2022-08-23](#2022-08-23) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `BICO`, `IMX`, `PLA`, `IOTX` ### [2022-08-01](#2022-08-01) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `GAL`, `EUL`, `SAMO` ### [2022-07-06](#2022-07-06) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `DOT`, `ERN` ### [2022-06-29](#2022-06-29) - **REST** - **API Change** Adding `symbol` parameter to [Get Notional Volume](/rest/orders#get-notional-trading-volume) ### [2022-06-23](#2022-06-23) - **REST** - **Websocket** - **FIX Order Entry** - **FIX Drop Copy** - Deprecating documentation for Auction and Block trading support ### [2022-06-22](#2022-06-22) - **REST** - **API Change** Adding `since_tid` parameter to [Trade History](/rest/market-data#list-trades) - Documentation for new token support: `GUSDGBP` - **Websocket** - Documentation for new token support: `GUSDGBP` ### [2022-06-15](#2022-06-15) - **REST** - Documentation improvement to json example for [Symbol Details](/rest/market-data#get-symbol-details) - **New Feature** Documentation for [Gas Fee Estimation](/rest/fund-management#get-gas-fee-estimation) ### [2022-06-14](#2022-06-14) - **REST** - **API Change** Removed parameter `client_order_id` from the trades array of [order-status](/rest/orders#get-order-status) - Documentation for new token support: `ALI`, `TRU` - **Websocket** - **FIX Market Data** - Documentation for new token support: `ALI`, `TRU` ### [2022-06-07](#2022-06-07) - **REST** - **New Feature** Documentation for [FX Rates](/rest/market-data#fx-rate) ### [2022-06-01](#2022-06-01) - **REST** - **New Feature** Documentation for [Renaming an Account](/rest/account-administration#rename-account) ### [2022-05-25](#2022-05-25) - **REST** - **New Feature** Documentation for [Adding A Bank CAD](/rest/fund-management#add-bank-cad) ### [2022-05-18](#2022-05-18) - **REST** - **New Feature** Documentation for [Clearing Order List](/rest/clearing#list-clearing-orders), [Clearing Broker List](/rest/clearing#list-clearing-brokers) and [Custody Account Fees](/rest/fund-management#list-custody-fee-transfers) - **FIX Order Entry** - **FIX Market Data** - **FIX Drop Copy** - Add additional examples of using the API ### [2022-05-17](#2022-05-17) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `GFI`, `ORCA` ### [2022-05-09](#2022-05-09) - **FIX Order Entry** - Update FIX Order Cancel Reject details ### [2022-04-27](#2022-04-27) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `METIS`, `QRDO`, `ZBC`, `CHZ`, `REVV`, `JAM`, `FIDA`, `GMT` ### [2022-04-26](#2022-04-26) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `GUSDSGD` ### [2022-03-29](#2022-03-29) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `RBN`, `FXS`, `DPI`, `LQTY`, `LUSD`, `FRAX`, `INDEX`, `MPL` ### [2022-03-16](#2022-03-16) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `APE` ### [2022-03-01](#2022-03-01) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `RAY`, `SBR` ### [2022-02-28](#2022-02-28) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `SOL` ### [2022-02-08](#2022-02-08) - **REST** - **API Change** Added new parameter `clientTransferId` to [Transfer Between Accounts](/rest/fund-management#transfer-between-accounts) and [Withdraw Crypto Funds](/rest/fund-management#withdraw-crypto-funds) ### [2022-02-01](#2022-02-01) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `TOKE`, `LDO`, `RLY` ### [2022-01-28](#2022-01-28) - **REST** - **New Feature** Documentation for Earn History ### [2022-01-24](#2022-01-24) - **FIX Order Entry** - Update Third Party Execution Report details ### [2021-12-20](#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](#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](#2021-10-06) - **REST** - **New Feature** Documentation for [Wrap Order](/rest/orders#wrap-order) ### [2021-09-15](#2021-09-15) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `AXS`, `SLP`, `LUNA`, `UST`, `MCO2` ### [2021-08-06](#2021-08-06) - **REST** - **New Feature** Documentation for Earn Balances, Earn Rates and Earn Interest ### [2021-07-21](#2021-07-21) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `XTZ` ### [2021-07-14](#2021-07-14) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `CTX` ### [2021-06-16](#2021-06-16) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `ALCX`, `MIR`, `FTM`, `ANKR` ### [2021-06-07](#2021-06-07) - **REST** - **API Change** Added `is_clearing_fill` to [List Past Trades](/rest/orders#list-past-trades) response ### [2021-05-06](#2021-05-06) - **REST** - **New Feature** Documentation for SEN Withdrawals ### [2021-05-05](#2021-05-05) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `DOGE` ### [2021-04-27](#2021-04-27) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `CUBE`, `LPT`, `BOND`, `MATIC`, `INJ`, `SUSHI` ### [2021-04-16](#2021-04-16) - **REST** - **API Change** [List Approved Addresses](/rest/fund-management#list-approved-addresses) has changed from a `GET` to a `POST` HTTP request ### [2021-04-08](#2021-04-08) - **REST** - **API Change** [Symbol Details](/rest/market-data#get-symbol-details) endpoint has updated parameters ### [2021-03-29](#2021-03-29) - **Websocket** - Documentation for new [Multi Market Data Feed](/websocket/multi-market-data/index) ### [2021-03-22](#2021-03-22) - **REST** - **Websocket** - **FIX Market Data** - Documentation for new token support: `SKL`, `GRT`, `BNT`, `1INCH`, `ENJ`, `LRC`, `SAND` ### [2021-03-11](#2021-03-11) - **Websocket** - Added new optional [heartbeat filter](/websocket/order-events/about) ### [2021-02-23](#2021-02-23) - **REST** - **New Feature** Documentation for [Order Status](/rest/orders#get-order-status) now includes an optional `include_trades` parameter ### [2021-01-28](#2021-01-28) - **REST** - **Websocket** - Documentation for new symbol support: `BTCSGD` and `ETHSGD` ### [2020-10-28](#2020-10-28) - **REST** - **New Feature** Documentation for new [Symbol Details](/rest/market-data#get-symbol-details) endpoint ### [2020-10-26](#2020-10-26) - **REST** - Documentation for new fiat support: `GBP` and `EUR` ### [2020-10-14](#2020-10-14) - **Websocket** - Documentation for new token support: `FIL` ### [2020-10-07](#2020-10-07) - **Websocket** - Documentation for new token support: `AAVE` ### [2020-10-05](#2020-10-05) - **Websocket** - **FIX Market Data** - Documentation for new order book support: `BTCDAI` and `ETHDAI` ### [2020-09-24](#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](#2020-09-11) - **REST** - **FIX Market Data** - Documentation for new token support: `AMP`, `COMP`, `PAXG` ### [2020-08-28](#2020-08-28) - **REST** - **Websocket** - **FIX Market Data** - Removing `DAIBTC`and `DAIETH` trading pairs ### [2020-07-23](#2020-07-23) - **REST** - **New Feature** Documentation for [Adding a Bank](/rest/fund-management#add-bank), [Viewing Payment Methods](/rest/fund-management#list-payment-methods) and [Account Detail](/rest/account-administration#get-account-detail) ### [2020-04-09](#2020-04-09) - **REST** - **Websocket** - Documentation for new token support: `BAT`, `DAI`, `LINK`, `OXT` ### [2020-03-05](#2020-03-05) - **REST** - **New Feature** Documentation for [Retrieving deposit addresses](/rest/fund-management#list-deposit-addresses), [List Prices](/rest/market-data#list-prices), and [Notional Balances](/rest/fund-management#get-notional-balances) ### [2019-11-22](#2019-11-22) - **Websocket** - Updated response messages for [Candles Data Feed](/websocket/market-data-v2/candles) on [Market Data v2](/websocket/market-data-v2/index) ### [2019-11-18](#2019-11-18) - **REST** - **New Feature** Updating Stop order documentation ### [2019-11-12](#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](#2019-08-16) - **REST** - **New Feature** Documentation for [Account Administration APIs](/account-admin-endpoints) and Group Level API keys ### [2019-08-08](#2019-08-08) - **REST** - **New Feature** Documentation for [Gemini Clearing](/gemini-clearing) functionality - **FIX Order Entry** - Add documentation for Gemini Clearing - **FIX Drop Copy** - **New Feature:** Document [Third Party Support](/fix/drop-copy/party-ids-&-roles/third-party-support) ### [2019-06-20](#2019-06-20) - **Websocket** - Adding documentation for [Market Data v2](/websocket/market-data-v2/index) and [Candles Data Feed](/websocket/market-data-v2/candles) ### [2019-06-07](#2019-06-07) - **REST** - Add documentation for [ticker v2](/rest/market-data#get-ticker-v2) and [candles](/rest/market-data#list-candles) endpoints ### [2019-05-31](#2019-05-31) - **REST** - Add legacy parameter for LTC [address generation](/rest/fund-management#create-new-deposit-address) ### [2019-03-22](#2019-03-22) - **REST** - Add Gemini Dollar section and detail changes to [Withdrawals](/rest/fund-management#withdraw-crypto-funds) ### [2019-03-01](#2019-03-01) - **REST** - Document changes to [Notional Volume](/rest/orders#get-notional-trading-volume) ### [2018-09-21](#2018-09-21) - **FIX Drop Copy** - Updated OMS third party trade capture report example ### [2018-09-14](#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](#2018-09-10) - **REST** - Added Gemini dollar example to [Transfers](/rest/fund-management#list-past-transfers) ### [2018-08-07](#2018-08-07) - **FIX Market Data** - **API Change** Added support for maker side using custom tags 9002 `MDEntryMakerSide` and `EnableMDEntryMakerSide` ### [2018-06-18](#2018-06-18) - **FIX Order Entry** - Add [examples](#server-side-cancellations) for [order cancel reason](#order-cancel-reasons) ### [2018-06-06](#2018-06-06) - **Websocket** - **API Change** Market depth and entry filtering added to [Market Data](/websocket/market-data/index) API ### [2018-05-18](#2018-05-18) - **FIX Order Entry** - **FIX Market Data** - **FIX Drop Copy** - Add additional examples of using the API ### [2018-04-30](#2018-04-30) - **FIX Order Entry** - Document actual examples of Reject messages and Execution Report rejects in an [errors](#errors) section ### [2018-04-06](#2018-04-06) - **REST** - **New Feature:** Document [Transfers](/rest/fund-management#list-past-transfers) endpoint - **New Feature:** Document block trading support - **Websocket** - **API Change** Document block trades in [Market Data](/websocket/market-data/index) and [Order Events](/websocket/order-events/about) APIs - **FIX Order Entry** - **New Feature:** Document block trading support. Add [IOI \<6\>](#ioi-lt-6-gt) for broadcast of IOI to block trade market makers and update [New Order Single \](#new-order-single-lt-d-gt-limit) 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](#2018-03-09) - **FIX Market Data** - _Documentation bugfix:_ correct [MsgType \<35\>][MsgType] tag number in documentation for [Symbol List Request \](#symbol-list-request-lt-x-gt) - _Documentation improvement:_ added examples of [Symbol List Request \](#symbol-list-request-lt-x-gt) and [Symbol List \](#symbol-list-lt-y-gt) messages ### [2018-02-22](#2018-02-22) - **REST** - Document [List Past Trades](/rest/orders#list-past-trades) endpoint recipe for retrieving full trade history - **FIX Order Entry** - **New Feature:** Document [Third Party Support](#third-party-support). Add [OnBehalfOfCompID \<115\>][OnBehalfOfCompID] field to [Standard Header](#standard-header) - **FIX Drop Copy** - **New Feature:** Document [Third Party Support](/fix/drop-copy/party-ids-&-roles/third-party-support). Clarify usage of [Party IDs and Roles](#party-ids-and-roles) ### [2018-02-09](#2018-02-09) - **REST** - **API Change** update API [Error Codes](/error-codes) ### [2018-02-08](#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](#2018-01-22) - **FIX Market Data** - _Documentation bugfix:_ fixed [ExpireTime \<126\>][ExpireTime] tag number in documentation for [Market Data - Incremental Refresh \](#market-data-incremental-refresh-lt-x-gt) and [Market Data - Snapshot / Full Refresh \](#market-data-snapshot-full-refresh-lt-w-gt) - _Documentation improvement:_ added examples of [Market Data Request \](#market-data-request-lt-v-gt), [Market Data - Incremental Refresh \](#market-data-incremental-refresh-lt-x-gt), and [Market Data - Snapshot / Full Refresh \](#market-data-snapshot-full-refresh-lt-w-gt) messages ### [2017-12-01](#2017-12-01) - **REST** - **API Change** added `collar_price` to Current Auction and Auction History - **Websocket** - **API Change** `collar_price` added to [Market Data](/websocket/market-data/index) API - **FIX Market Data** - **API Change** added [MDEntryType \<269\>][MDEntryType] value `3 = INDEX_VALUE` to [Market Data - Incremental Refresh \](#market-data-incremental-refresh-lt-x-gt) to support reporting the auction collar price ### [2017-11-30](#2017-11-30) - **REST** - **API Change** clarify that only seven calendar days of data will be available through public API endpoints at [Trade History](/rest/market-data#list-trades) and Auction History. Email [support@gemini.com](mailto:support@gemini.com) for information about Gemini market data ### [2017-11-17](#2017-11-17) - **FIX Order Entry** - Add ExecInst=6 for Maker-or-Cancel orders ### [2017-08-30](#2017-08-30) - **FIX Market Data** - _Documentation bugfix:_ clarified description of [MDEntryType \<269\>][MDEntryType] in [Market Data - Snapshot / Full Refresh \](#market-data-snapshot-full-refresh-lt-w-gt) ### [2017-08-10](#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](/websocket/market-data/index) and [Order Events](/websocket/order-events/about) APIs. Further details available in [Sequence Numbers](/websocket/overview/socket-sequence) ### [2017-07-27](#2017-07-27) - **REST** - Improved code sampled in [Private API Invocation](/authentication/api-key#private-api-invocation) - Added [Troubleshooting](/troubleshooting#troubleshooting) section - Clarified precision in [Symbols and Minimums](/market-data/symbols-and-minimums) - _Documentation bugfix:_ [List Past Trades](/rest/orders#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](/websocket/order-events/event-types#heartbeats) ### [2017-07-13](#2017-07-13) - **Websocket** - **API Change** `timestamp` and `timestampms` added to [Market Data](/websocket/market- ### [2017-05-31](#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](/rest/orders#create-new-order) endpoint ### [2017-05-22](#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](/rest/~schemas#timestamp-type) to reflect timestamp behavior in requests and responses ### [2017-05-19](#2017-05-19) - **REST** - **API Change** order status JSON changed to always include an `options` array with [order execution options](/rest/orders#create-new-order). If no order execution options were submitted with the original order, the array will be empty ### [2017-05-15](#2017-05-15) - **REST** - Better JSON examples for all the [Order Status API](/rest/orders#get-order-status) endpoints - **Websocket** - Clarified how Gemini rate limits incoming requests to public WebSocket APIs - Document Order Events [Subscription Acknowledgement](/websocket/order-events/event-types#subscription-acknowledgement) `subscriptionId` field ### [2017-05-02](#2017-05-02) - **REST** - Clarify how rate limits are applied ### [2017-03-30](#2017-03-30) - **REST** - Improved documentation for [List Past Trades](/rest/orders#list-past-trades) and [Get Available Balances](/rest/fund-management#get-available-balances) ### [2017-03-06](#2017-03-06) - **Websocket** - Documentation bugfix: correct location of market data JSON example for trade events ### [2017-02-22](#2017-02-22) - **REST** - Added recipe for retrieving full trade history from [List Past Trades](/rest/orders#list-past-trades) endpoint ### [2016-12-14](#2016-12-14) - **REST** - **Websocket** - New feature: API key roles, crypto deposit and withdrawal endpoints ### [2016-11-10](#2016-11-10) - **Websocket** - Initial WebSocket API documentation ### [2016-08-23](#2016-08-23) - **REST** - New feature: auction documentation added to new order placement, public APIs, and streaming market data ### [2016-05-31](#2016-05-31) - **REST** - Add ETH to supported symbols ### [2016-04-27](#2016-04-27) - **REST** - Document `marker-or-cancel` and `immediate-or-cancel` order placement options ### [2016-03-23](#2016-03-23) - **FIX Order Entry** - **FIX Market Data** - **FIX Drop Copy** - Initial FIX API documentation ### [2015-12-22](#2015-12-22) - **REST** - Document sandbox usage ### [2015-10-05](#2015-10-05) - **REST** - Initial REST API documentation