[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Coinbase Exchange order book](https://spiral.ai/integrations/gemini-cli/coinbase-exchange-order-book)

# How to Use Coinbase Exchange order book in Gemini CLI

Returns a trading pair's open bids and asks, with sizes aggregated by price. Use it to measure the spread and displayed liquidity beyond the last traded price.

|  |  |
| --- | --- |
| Model | Coinbase Exchange order book |
| Available through | Alexandria |
| Category | Finance |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Coinbase Exchange order book in Gemini CLI

- Use Coinbase Exchange order book for ETH-USD and add a table of the nearest 20 bid and ask prices, their aggregated sizes, and the calculated spread.
- Use Coinbase Exchange order book to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Coinbase Exchange order book and tell me what changed since last week.
- Check Coinbase Exchange order book and summarize what you find in three bullet points.
- Pull the newest data from Coinbase Exchange order book and give me the result as a table.

## How to set up Coinbase Exchange order book in Gemini CLI

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Coinbase Exchange order book**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "api-exchange-coinbase-com/markets/get_order_book",
    "input": {
      "product_id": "<product_id>"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds Coinbase Exchange order book on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## Coinbase Exchange order book tools and prices

- [Coinbase Exchange · Get order book](https://spiral.ai/tools/alexandria/api-exchange-coinbase-com/markets/get_order_book) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| depth | 1 to 1000 | 50 | Maximum price levels per side to return for level 2 (level 1 always has one). |
| level | 1, 2 | 1 | 1 = best bid/ask only (default); 2 = aggregated book truncated to `depth`. |

## What can you do with Coinbase Exchange order book in Gemini CLI?

Build an internal Coinbase research screen with asset metadata, market history, liquidity, and cbETH staking context. With Coinbase's written consent for AI use, connect those records to your project's data models.

### Internal ETH market research brief

Combine ETH market history, recent executions, spreads, displayed depth, and volume with currency and pair metadata. Add cbETH conversion, supply, and APY to give the staking data its own context.

### cbETH market and conversion comparison

Find available cbETH pairs and compare their quoted market activity with Coinbase's staking conversion rate. Include recent trades and displayed bids and asks to explain what the exchange is showing.

### Displayed liquidity comparison

Compare BTC-USD and ETH-USD spreads, aggregated depth, recent trade sizes, and market volume. Include trading restrictions and increments so the comparison retains each pair's market context.

### Market data normalization checks

Check an internal data pipeline's handling of decimal amounts, timestamps, trade IDs, aggregated sizes, currency codes, and pair definitions. Check wrapped-asset conversion and supply records separately from exchange prices and volumes.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## Coinbase Exchange order book in other agents

- [Amp](https://spiral.ai/integrations/amp/coinbase-exchange-order-book)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/coinbase-exchange-order-book)
- [Claude](https://spiral.ai/integrations/claude-desktop/coinbase-exchange-order-book)
- [Claude Code](https://spiral.ai/integrations/claude-code/coinbase-exchange-order-book)
- [Cline](https://spiral.ai/integrations/cline/coinbase-exchange-order-book)
- [Codex](https://spiral.ai/integrations/codex/coinbase-exchange-order-book)
- [Cursor](https://spiral.ai/integrations/cursor/coinbase-exchange-order-book)
- [Devin](https://spiral.ai/integrations/devin/coinbase-exchange-order-book)
- [dots](https://spiral.ai/integrations/dots/coinbase-exchange-order-book)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/coinbase-exchange-order-book)
- [Gemini](https://spiral.ai/integrations/gemini/coinbase-exchange-order-book)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/coinbase-exchange-order-book)
- [goose](https://spiral.ai/integrations/goose/coinbase-exchange-order-book)
- [Grok](https://spiral.ai/integrations/grok/coinbase-exchange-order-book)
- [Grok Build](https://spiral.ai/integrations/grok-build/coinbase-exchange-order-book)
- [Hermes](https://spiral.ai/integrations/hermes/coinbase-exchange-order-book)
- [Instinct](https://spiral.ai/integrations/instinct/coinbase-exchange-order-book)
- [Manus](https://spiral.ai/integrations/manus/coinbase-exchange-order-book)
- [Muse](https://spiral.ai/integrations/muse/coinbase-exchange-order-book)
- [Muse Code](https://spiral.ai/integrations/muse-code/coinbase-exchange-order-book)
- [n8n](https://spiral.ai/integrations/n8n/coinbase-exchange-order-book)
- [Notion](https://spiral.ai/integrations/notion/coinbase-exchange-order-book)
- [OpenClaw](https://spiral.ai/integrations/openclaw/coinbase-exchange-order-book)
- [opencode](https://spiral.ai/integrations/opencode/coinbase-exchange-order-book)
- [Perplexity](https://spiral.ai/integrations/perplexity/coinbase-exchange-order-book)
- [Raycast](https://spiral.ai/integrations/raycast/coinbase-exchange-order-book)
- [VS Code](https://spiral.ai/integrations/vscode/coinbase-exchange-order-book)
- [Windsurf](https://spiral.ai/integrations/windsurf/coinbase-exchange-order-book)
- [Zapier](https://spiral.ai/integrations/zapier/coinbase-exchange-order-book)

## More Gemini CLI guides

- [Coinbase Exchange currency list](https://spiral.ai/integrations/gemini-cli/coinbase-exchange-currency-list)
- [Coinbase Exchange price candles](https://spiral.ai/integrations/gemini-cli/coinbase-exchange-price-candles)
- [Coinbase Exchange currency details](https://spiral.ai/integrations/gemini-cli/coinbase-exchange-currency-details)
- [Coinbase Exchange recent trades](https://spiral.ai/integrations/gemini-cli/coinbase-exchange-recent-trades)
- [CNBC video details](https://spiral.ai/integrations/gemini-cli/cnbc-video-details)
- [Coinbase Exchange ticker](https://spiral.ai/integrations/gemini-cli/coinbase-exchange-ticker)

## Questions about Coinbase Exchange order book in Gemini CLI

**Can Gemini CLI use Coinbase Exchange order book?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Coinbase Exchange order book like any built-in tool.

**How much does Coinbase Exchange order book cost in Gemini CLI?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

**Do I need an Alexandria account to use Coinbase Exchange order book in Gemini CLI?**

No. Spiral runs Coinbase Exchange order book on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Coinbase Exchange order book in Gemini CLI?**

About two minutes: add the server, then sign in, then check it.

**Does Gemini CLI wait while Coinbase Exchange order book runs?**

Coinbase Exchange order book runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**Does this cover the whole crypto market?**

The data comes from Coinbase Exchange. Its prices, executions, and displayed liquidity describe that venue, rather than a consolidated view across crypto exchanges.

**Does a currency appearing in Coinbase's catalog mean it currently trades?**

Coinbase explicitly says some known currencies may not currently be used for trading. The currency catalog and trading pair catalog describe different things: assets and markets.

**Is REST intended to capture every market change?**

Coinbase describes REST as suitable for lower-frequency requests and provides a WebSocket feed for market data. A REST snapshot should not be treated as a continuous record of every intervening change.

**Can Coinbase change a trading pair's details?**

Yes. Coinbase says a product ID stays fixed once assigned, while the other product fields can change.

**Do Coinbase's terms permit AI agent use?**

Coinbase's current terms require prior express written consent for uses related to operating AI technologies. The restriction extends beyond model training.

