Gemini Exchange

App · 6 actions

Read live market data from Gemini, the US-regulated crypto exchange: tickers, every market's price and 24-hour change, price history candles, order books, recent trades and market details. Read-only, so it can never place an order. No account or API key required.

Actions

ActionWhat it does
Get market detailsGet a Gemini market's details: its base and quote currencies, whether it is open, whether it is spot or a perpetual, and the smallest order and price step.
Get order bookGet the buy and sell orders waiting on a Gemini market, best prices first, with the spread and the mid price.
Get price historyGet the most recent candles (open, high, low, close and volume) for a Gemini market, from 1-minute to 1-month candles, oldest first, with the overall change, high and low across them.
Get tickerGet a Gemini market's latest price with its last 24 hours: the open, high, low, change and volume, the current best bid and ask, and the price at each of the last 24 hours.
List pricesList the price and 24-hour change of every market on Gemini in one step.
List recent tradesList the latest trades on a Gemini market, newest first, with each trade's price, size, value and side.

Get market details

Get a Gemini market's details: its base and quote currencies, whether it is open, whether it is spot or a perpetual, and the smallest order and price step. No API key required.

Inputs

MarketsymboltextRequired
The Gemini market: the base currency followed by the quote currency, e.g. BTCUSD for bitcoin priced in US dollars. 'BTC/USD' works too.

Outputs

base_currencytext
The currency being bought and sold, e.g. 'BTC'.
contract_typetext
Gemini's contract type, e.g. 'vanilla'.
is_opentrue/false
True when the market is open for trading.
min_order_sizenumber
The smallest order, in the base currency.
price_incrementnumber
The smallest step a price can move in.
product_typetext
'spot' for a spot market, 'swap' for a perpetual.
quantity_incrementnumber
The smallest step an order's quantity can move in.
quote_currencytext
The currency prices are quoted in, e.g. 'USD'.
statustext
Gemini's status for the market, e.g. 'open', 'closed', 'cancel_only' or 'post_only'.
summarytext
One line about the market, e.g. 'BTC/USD is open on Gemini; orders from 0.00001 BTC, prices in steps of 0.01 USD'.
symboltext
The market, e.g. 'BTCUSD'.
Example output
{
  "base_currency": "BTC",
  "contract_type": "vanilla",
  "is_open": true,
  "min_order_size": 1e-05,
  "price_increment": 0.01,
  "product_type": "spot",
  "quantity_increment": 1e-08,
  "quote_currency": "USD",
  "status": "open",
  "summary": "BTC/USD is open on Gemini; orders from 0.00001 BTC, prices in steps of 0.01 USD",
  "symbol": "BTCUSD"
}

Get order book

Get the buy and sell orders waiting on a Gemini market, best prices first, with the spread and the mid price. No API key required.

Inputs

MarketsymboltextRequired
The Gemini market: the base currency followed by the quote currency, e.g. BTCUSD for bitcoin priced in US dollars. 'BTC/USD' works too.
Levels per sidedepthnumber
How many price levels to return on each side, from 1 to 500. Defaults to 20.From 1 to 500. Default: 20.

Outputs

ask_quantity_totalnumber
The base currency offered across all the ask levels returned.
askslist
Sell orders, lowest price first.
best_asknumber
The lowest price a seller is asking.
best_bidnumber
The highest price a buyer is offering.
bid_quantity_totalnumber
The base currency wanted across all the bid levels returned.
bidslist
Buy orders, highest price first.
mid_pricenumber
Halfway between the best bid and the best ask.
spreadnumber
The best ask minus the best bid.
spread_percentnumber
The spread as a percentage of the mid price.
symboltext
The market, e.g. 'BTCUSD'.
Example output
{
  "ask_quantity_total": 1.45882329,
  "asks": [
    {
      "price": 81345.0,
      "quantity": 0.84552728
    },
    {
      "price": 81347.26,
      "quantity": 0.01329601
    },
    {
      "price": 81352.0,
      "quantity": 0.6
    }
  ],
  "best_ask": 81345.0,
  "best_bid": 81344.99,
  "bid_quantity_total": 0.06472365,
  "bids": [
    {
      "price": 81344.99,
      "quantity": 0.02524192
    },
    {
      "price": 81338.71,
      "quantity": 0.03228173
    },
    {
      "price": 81335.04,
      "quantity": 0.0072
    }
  ],
  "mid_price": 81344.995,
  "spread": 0.01,
  "spread_percent": 1.2e-05,
  "symbol": "BTCUSD"
}

Get price history

Get the most recent candles (open, high, low, close and volume) for a Gemini market, from 1-minute to 1-month candles, oldest first, with the overall change, high and low across them. No API key required.

Inputs

MarketsymboltextRequired
The Gemini market: the base currency followed by the quote currency, e.g. BTCUSD for bitcoin priced in US dollars. 'BTC/USD' works too.
Candle sizetime_frametext
How long each candle covers. Defaults to one day.One of: 1m (1 minute), 5m (5 minutes), 15m (15 minutes), 30m (30 minutes), 1hr (1 hour), 6hr (6 hours), 1day (1 day), 1w (1 week), 1mo (1 month). Default: 1day.
Number of candleslimitnumber
How many of the most recent candles to return, from 1 to 500. Defaults to 30.From 1 to 500. Default: 30.

Outputs

candleslist
The candles, oldest first.
change_percentnumber
The move from the first candle's open to the last candle's close, as a percentage.
countnumber
How many candles came back.
first_opennumber
The opening price of the first candle.
last_closenumber
The closing price of the last candle.
period_highnumber
The highest price across all the candles.
period_lownumber
The lowest price across all the candles.
symboltext
The market, e.g. 'BTCUSD'.
time_frametext
The length of each candle, e.g. '1day' or '1hr'.
Example output
{
  "candles": [
    {
      "close": 83104.66,
      "close_time": "2026-10-13T23:59:59.999Z",
      "high": 84049.45,
      "is_closed": true,
      "low": 80965.99,
      "open": 81753.56,
      "open_time": "2026-10-13T00:00:00.000Z",
      "volume": 202.374013
    },
    {
      "close": 81575.43,
      "close_time": "2026-10-14T23:59:59.999Z",
      "high": 84048.01,
      "is_closed": true,
      "low": 81349.18,
      "open": 83104.66,
      "open_time": "2026-10-14T00:00:00.000Z",
      "volume": 142.20871273
    },
    {
      "close": 82137.66,
      "close_time": "2026-10-15T23:59:59.999Z",
      "high": 82543.73,
      "is_closed": true,
      "low": 79750.0,
      "open": 81575.43,
      "open_time": "2026-10-15T00:00:00.000Z",
      "volume": 142.83993386
    }
  ],
  "change_percent": 0.4698,
  "count": 3,
  "first_open": 81753.56,
  "last_close": 82137.66,
  "period_high": 84049.45,
  "period_low": 79750.0,
  "symbol": "BTCUSD",
  "time_frame": "1day"
}

Get ticker

Get a Gemini market's latest price with its last 24 hours: the open, high, low, change and volume, the current best bid and ask, and the price at each of the last 24 hours. No API key required.

Inputs

MarketsymboltextRequired
The Gemini market: the base currency followed by the quote currency, e.g. BTCUSD for bitcoin priced in US dollars. 'BTC/USD' works too.

Outputs

ask_pricenumber
The lowest price a seller is currently asking.
base_currencytext
The currency being bought and sold, e.g. 'BTC'.
bid_pricenumber
The highest price a buyer is currently offering.
high_pricenumber
The highest price in the last 24 hours.
hourly_priceslist
The price at each of the last 24 hours, oldest first; the last is the most recent hour.
is_perpetualtrue/false
True for a perpetual futures contract (a symbol ending in PERP).
last_pricenumber
The price of the most recent trade.
low_pricenumber
The lowest price in the last 24 hours.
open_pricenumber
The price 24 hours ago.
price_changenumber
The last price minus the price 24 hours ago.
price_change_percentnumber
The 24-hour price move as a percentage, e.g. -0.98 for a 0.98% fall.
quote_currencytext
The currency prices are quoted in, e.g. 'USD'.
quote_volumenumber
The value traded in the last 24 hours, in the quote currency.
spreadnumber
The ask price minus the bid price.
summarytext
One line about the market, e.g. 'BTC/USD is at 81,324.54 on Gemini, down 0.9843% over 24 hours (high 82,829.32, low 80,717.06)'.
symboltext
The market, e.g. 'BTCUSD'.
updated_attext
When Gemini last updated the volume figures (ISO 8601, UTC).
volumenumber
How much of the base currency traded in the last 24 hours.
Example output
{
  "ask_price": 81345.0,
  "base_currency": "BTC",
  "bid_price": 81344.99,
  "high_price": 82829.32,
  "hourly_prices": [
    82328.77,
    82305.35,
    82016.72,
    82339.23,
    82363.16,
    82137.66,
    82238.0,
    81984.34,
    81940.09,
    82025.17,
    82057.3,
    82051.03,
    82073.42,
    82198.35,
    82185.33,
    81928.36,
    82165.37,
    82529.79,
    81939.26,
    81932.46,
    81872.53,
    81259.0,
    81331.52,
    81100.0
  ],
  "is_perpetual": false,
  "last_price": 81324.54,
  "low_price": 80717.06,
  "open_price": 82132.99,
  "price_change": -808.45,
  "price_change_percent": -0.9843,
  "quote_currency": "USD",
  "quote_volume": 6909574.480747389,
  "spread": 0.01,
  "summary": "BTC/USD is at 81,324.54 on Gemini, down 0.9843% over 24 hours (high 82,829.32, low 80,717.06)",
  "symbol": "BTCUSD",
  "updated_at": "2026-10-16T18:40:00.000Z",
  "volume": 84.96297035
}

List prices

List the price and 24-hour change of every market on Gemini in one step. Narrow it to one quote currency or a coin, and sort by name or by the biggest gainers or losers. No API key required.

Inputs

Quote currencyquote_currencytext
Only markets priced in this currency, e.g. USD, GUSD, USDC, EUR or BTC. Leave blank for all.
Coin or marketsearchtext
Only markets whose symbol contains this, e.g. ETH or SOLUSD. Leave blank for all.
Sort bysorttext
How to order the markets. Defaults to by symbol.One of: symbol (Symbol (A to Z)), gainers (Biggest 24-hour gainers), losers (Biggest 24-hour losers). Default: symbol.
Maximum marketslimitnumber
The most markets to return, from 1 to 500. Defaults to 100.From 1 to 500. Default: 100.

Outputs

countnumber
How many markets came back.
priceslist
The markets, in the order asked for.
total_matchesnumber
How many markets matched, before the limit.
Example output
{
  "count": 3,
  "prices": [
    {
      "base_currency": "BTC",
      "change_percent_24h": -0.87,
      "is_perpetual": true,
      "price": 81527.5,
      "quote_currency": "GUSD",
      "symbol": "BTCGUSDPERP"
    },
    {
      "base_currency": "BTC",
      "change_percent_24h": -1.01,
      "is_perpetual": false,
      "price": 81294.28,
      "quote_currency": "USD",
      "symbol": "BTCUSD"
    },
    {
      "base_currency": "ETH",
      "change_percent_24h": -1.03,
      "is_perpetual": false,
      "price": 2413.31,
      "quote_currency": "USD",
      "symbol": "ETHUSD"
    }
  ],
  "total_matches": 3
}

List recent trades

List the latest trades on a Gemini market, newest first, with each trade's price, size, value and side. Optionally only trades since a given time. No API key required.

Inputs

MarketsymboltextRequired
The Gemini market: the base currency followed by the quote currency, e.g. BTCUSD for bitcoin priced in US dollars. 'BTC/USD' works too.
Number of tradeslimitnumber
How many trades to return, from 1 to 500. Defaults to 20.From 1 to 500. Default: 20.
Sincesincedate and time
Only trades at or after this time. Leave blank for the latest trades.

Outputs

countnumber
How many trades came back.
symboltext
The market, e.g. 'BTCUSD'.
tradeslist
The trades, newest first.
Example output
{
  "count": 2,
  "symbol": "BTCUSD",
  "trades": [
    {
      "id": 2840141033496609,
      "price": 81324.54,
      "quantity": 0.00059997,
      "quote_quantity": 48.79228426,
      "side": "buy",
      "time": "2026-10-16T18:40:00.306Z"
    },
    {
      "id": 2840141033496607,
      "price": 81323.74,
      "quantity": 6.088e-05,
      "quote_quantity": 4.95098929,
      "side": "buy",
      "time": "2026-10-16T18:39:58.289Z"
    }
  ]
}

On this page