# Gemini Exchange

> 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.

App · 6 actions. Web page: https://docs.lodol.com/docs/integrations/gemini-exchange

## Actions

### 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 (`symbol`, text, required): 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_currency` (text): The currency being bought and sold, e.g. 'BTC'.
- `contract_type` (text): Gemini's contract type, e.g. 'vanilla'.
- `is_open` (true/false): True when the market is open for trading.
- `min_order_size` (number): The smallest order, in the base currency.
- `price_increment` (number): The smallest step a price can move in.
- `product_type` (text): 'spot' for a spot market, 'swap' for a perpetual.
- `quantity_increment` (number): The smallest step an order's quantity can move in.
- `quote_currency` (text): The currency prices are quoted in, e.g. 'USD'.
- `status` (text): Gemini's status for the market, e.g. 'open', 'closed', 'cancel_only' or 'post_only'.
- `summary` (text): 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'.
- `symbol` (text): The market, e.g. 'BTCUSD'.

**Example output**

```json
{
  "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 (`symbol`, text, required): 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 (`depth`, number): 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_total` (number): The base currency offered across all the ask levels returned.
- `asks` (list): Sell orders, lowest price first.
- `best_ask` (number): The lowest price a seller is asking.
- `best_bid` (number): The highest price a buyer is offering.
- `bid_quantity_total` (number): The base currency wanted across all the bid levels returned.
- `bids` (list): Buy orders, highest price first.
- `mid_price` (number): Halfway between the best bid and the best ask.
- `spread` (number): The best ask minus the best bid.
- `spread_percent` (number): The spread as a percentage of the mid price.
- `symbol` (text): The market, e.g. 'BTCUSD'.

**Example output**

```json
{
  "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 (`symbol`, text, required): 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_frame`, text): 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 (`limit`, number): How many of the most recent candles to return, from 1 to 500. Defaults to 30. From 1 to 500. Default: `30`.

**Outputs**

- `candles` (list): The candles, oldest first.
- `change_percent` (number): The move from the first candle's open to the last candle's close, as a percentage.
- `count` (number): How many candles came back.
- `first_open` (number): The opening price of the first candle.
- `last_close` (number): The closing price of the last candle.
- `period_high` (number): The highest price across all the candles.
- `period_low` (number): The lowest price across all the candles.
- `symbol` (text): The market, e.g. 'BTCUSD'.
- `time_frame` (text): The length of each candle, e.g. '1day' or '1hr'.

**Example output**

```json
{
  "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 (`symbol`, text, required): 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_price` (number): The lowest price a seller is currently asking.
- `base_currency` (text): The currency being bought and sold, e.g. 'BTC'.
- `bid_price` (number): The highest price a buyer is currently offering.
- `high_price` (number): The highest price in the last 24 hours.
- `hourly_prices` (list): The price at each of the last 24 hours, oldest first; the last is the most recent hour.
- `is_perpetual` (true/false): True for a perpetual futures contract (a symbol ending in PERP).
- `last_price` (number): The price of the most recent trade.
- `low_price` (number): The lowest price in the last 24 hours.
- `open_price` (number): The price 24 hours ago.
- `price_change` (number): The last price minus the price 24 hours ago.
- `price_change_percent` (number): The 24-hour price move as a percentage, e.g. -0.98 for a 0.98% fall.
- `quote_currency` (text): The currency prices are quoted in, e.g. 'USD'.
- `quote_volume` (number): The value traded in the last 24 hours, in the quote currency.
- `spread` (number): The ask price minus the bid price.
- `summary` (text): 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)'.
- `symbol` (text): The market, e.g. 'BTCUSD'.
- `updated_at` (text): When Gemini last updated the volume figures (ISO 8601, UTC).
- `volume` (number): How much of the base currency traded in the last 24 hours.

**Example output**

```json
{
  "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_currency`, text): Only markets priced in this currency, e.g. USD, GUSD, USDC, EUR or BTC. Leave blank for all.
- Coin or market (`search`, text): Only markets whose symbol contains this, e.g. ETH or SOLUSD. Leave blank for all.
- Sort by (`sort`, text): 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 (`limit`, number): The most markets to return, from 1 to 500. Defaults to 100. From 1 to 500. Default: `100`.

**Outputs**

- `count` (number): How many markets came back.
- `prices` (list): The markets, in the order asked for.
- `total_matches` (number): How many markets matched, before the limit.

**Example output**

```json
{
  "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 (`symbol`, text, required): 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 (`limit`, number): How many trades to return, from 1 to 500. Defaults to 20. From 1 to 500. Default: `20`.
- Since (`since`, date and time): Only trades at or after this time. Leave blank for the latest trades.

**Outputs**

- `count` (number): How many trades came back.
- `symbol` (text): The market, e.g. 'BTCUSD'.
- `trades` (list): The trades, newest first.

**Example output**

```json
{
  "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"
    }
  ]
}
```