[Integrations](https://spiral.ai/integrations) › [Gemini](https://spiral.ai/integrations/gemini) › [Marketstack stock exchange directory](https://spiral.ai/integrations/gemini/marketstack-stock-exchange-directory)

# How to Use Marketstack stock exchange directory in Gemini

Returns exchange names, MIC codes, locations, and websites from Marketstack’s directory. Use it to identify trading venues or build an exchange lookup; a directory entry does not guarantee price coverage.

|  |  |
| --- | --- |
| Model | Marketstack stock exchange directory |
| Available through | Alexandria |
| Category | Finance |
| Price | Up to $0.034918 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Marketstack stock exchange directory in Gemini

- Use Marketstack stock exchange directory to find Nasdaq and show all matching venues with their names, MIC codes, countries, and cities.
- Use Marketstack stock exchange directory to look up London Stock Exchange and list the matching names, MIC codes, and websites.
- Use Marketstack stock exchange directory to look up XNAS and XNYS and compare the returned names and locations in a table.
- Use Marketstack stock exchange directory to collect the complete directory and show records located in Japan, grouped by city.
- Use Marketstack stock exchange directory to find Deutsche Boerse records and give me the returned venue names, MIC codes, and websites.

## How to set up Marketstack stock exchange directory in Gemini

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

### Use the Gemini connector

1. **Open Connected Apps**: On your computer, go to gemini.google.com. At the bottom, click Settings › Connected Apps. If you don't see Connected Apps, click Personal Intelligence first, then Connected Apps.

2. **Add Spiral as a custom app**: Under Custom apps, click Add a custom app and paste this MCP server URL:

```text
https://api.spiral.ai/mcp
```

3. **Sign in to Spiral and approve**: Follow the on-screen instructions. Spiral opens: sign in, pick the organization and click Authorize. No API key.

### Use the Spiral skill

1. **Send Gemini 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 Marketstack stock exchange directory**: 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": "marketstack/exchanges/list",
    "input": {
      "limit": 1
    }
  }'
```

Then paste one of the prompts above: Gemini finds Marketstack stock exchange directory on Spiral, shows the price and runs it.

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

## Marketstack stock exchange directory tools and prices

- [Marketstack · Exchanges](https://spiral.ai/tools/alexandria/marketstack/exchanges/list) (Alexandria): Up to $0.034918 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 100 | — | Rows per page, from 1 to 100. Default 100. The request costs the same whatever the row count. |
| offset | 0 to 1000000 | — | Rows to skip for the next page. Default 0. |
| search |  | — | Exchange name, acronym, or MIC fragment, such as nasdaq. |

## What can you do with Marketstack stock exchange directory in Gemini?

Turn an exchange name into a table of matching venues, locations, and MIC codes. A chat app can use Marketstack’s directory to prepare regional exchange references and explain the returned matches.

### Build an exchange picker

Populate a searchable trading venue selector with exchange names, MIC codes, and locations.

### Check exchange labels in imported data

Compare exchange names in a portfolio import with directory records and flag ambiguous matches for review.

### Create a regional venue reference

Collect the directory and organize returned exchanges by country and city for a market research brief.

### Enrich market reports

Expand exchange codes in a report into readable venue names and add the returned exchange websites.

### Review directory changes

Compare successive directory snapshots to identify added records and changes to names, locations, or websites.

### Prepare price coverage checks

Resolve a requested trading venue to candidate MIC codes before separately checking whether its securities have price data.

## Overview

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

## Marketstack stock exchange directory in other agents

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

## More Gemini guides

- [Marketstack dividend history](https://spiral.ai/integrations/gemini/marketstack-dividend-history)
- [Marketstack stock split history](https://spiral.ai/integrations/gemini/marketstack-stock-split-history)
- [Marketstack daily stock prices](https://spiral.ai/integrations/gemini/marketstack-daily-stock-prices)
- [Marketstack ticker search](https://spiral.ai/integrations/gemini/marketstack-ticker-search)
- [Marketstack company profile](https://spiral.ai/integrations/gemini/marketstack-company-profile)
- [NFA BASIC CFTC reparations cases](https://spiral.ai/integrations/gemini/nfa-basic-cftc-reparations-cases)

## Questions about Marketstack stock exchange directory in Gemini

**Can Gemini use Marketstack stock exchange directory?**

Yes. Add Spiral to Gemini as an MCP server, and Gemini can find and run Marketstack stock exchange directory like any built-in tool.

**How much does Marketstack stock exchange directory cost in Gemini?**

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

**Do I need an Alexandria account to use Marketstack stock exchange directory in Gemini?**

No. Spiral runs Marketstack stock exchange directory on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Marketstack stock exchange directory in Gemini?**

About two minutes: open Connected Apps, then add Spiral as a custom app, then sign in to Spiral and approve.

**Does Gemini wait while Marketstack stock exchange directory runs?**

Marketstack stock exchange directory runs in the background. Gemini starts the run, checks on it and gives you the json when it's ready.

**How many exchanges does Marketstack’s directory cover?**

Marketstack documents more than 2,700 exchange records in its database. That is the directory’s scope, not a count of exchanges with available price data.

**What information identifies each exchange?**

Records include the exchange name, MIC code, country, city, and website. Marketstack also documents regulatory metadata for exchange records.

**How can I tell whether I retrieved the complete directory?**

Marketstack returns a total result count in its pagination metadata. Compare the records collected across pages with that total before treating the retrieval as complete.

**Does Marketstack guarantee that every exchange record is accurate?**

APILayer’s master agreement expressly disclaims warranties and liability for inaccuracies, errors, and omissions in licensed data. The directory therefore does not carry an unconditional accuracy guarantee.

**Does access give me unrestricted rights to republish the directory?**

APILayer’s master agreement grants only rights expressly provided in the agreement. Access alone should not be read as an unrestricted republication license.

