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
| Action | What it does |
|---|---|
| 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. |
| Get order book | Get the buy and sell orders waiting on a Gemini market, best prices first, with the spread and the mid price. |
| 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. |
| 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. |
| List prices | List the price and 24-hour change of every market on Gemini in one step. |
| List recent trades | List 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
- Market
symboltextRequired - 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
- Market
symboltextRequired - 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 side
depthnumber - 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
- Market
symboltextRequired - 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 size
time_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 candles
limitnumber - 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
- Market
symboltextRequired - 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 currency
quote_currencytext - Only markets priced in this currency, e.g. USD, GUSD, USDC, EUR or BTC. Leave blank for all.
- Coin or market
searchtext - Only markets whose symbol contains this, e.g. ETH or SOLUSD. Leave blank for all.
- Sort by
sorttext - 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 markets
limitnumber - 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
- Market
symboltextRequired - 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 trades
limitnumber - How many trades to return, from 1 to 500. Defaults to 20.From 1 to 500. Default:
20. - Since
sincedate 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"
}
]
}