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

# How to Use Marketstack stock exchange directory in dots

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, with a Spiral API key |

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

- Every Monday, use Marketstack stock exchange directory to retrieve Nasdaq matches and report any changes in names, MIC codes, locations, or websites since the previous check.
- Once a month, use Marketstack stock exchange directory to collect all pages and report added or removed records located in Japan.
- Each Friday, use Marketstack stock exchange directory to look up London Stock Exchange and summarize changes to the returned names and websites.
- Every Monday, use Marketstack stock exchange directory to retrieve XNAS and XNYS and flag changes to their returned names or locations.
- Once a month, use Marketstack stock exchange directory to retrieve Deutsche Boerse matches and compare their MIC codes and websites with the previous results.

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

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

### Use the Spiral skill

1. **Send dots 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 Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for your dot. Copy it.

2. **Send your dot this message**: Your dot reads Spiral's skill and asks for your API key.

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

3. **Give your dot the key**: When your dot asks for the key, add it where your dot keeps secrets, never in the chat itself.

### 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: dots finds Marketstack stock exchange directory on Spiral, shows the price and runs it.

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

## 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 dots?

Produce a weekly report of changes in Marketstack’s exchange directory. A scheduled agent can compare saved results and flag changes to venue names, MIC codes, locations, and websites.

### 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 dots guides](https://spiral.ai/integrations/dots)

## 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)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/marketstack-stock-exchange-directory)
- [Gemini](https://spiral.ai/integrations/gemini/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 dots guides

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

## Questions about Marketstack stock exchange directory in dots

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

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

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

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 dots plan is separate.

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

You need no Alexandria account. dots uses one Spiral API key for every tool, and Spiral runs Marketstack stock exchange directory on its own Alexandria account.

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

About two minutes: create an API key, then send your dot this message, then give your dot the key.

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

Marketstack stock exchange directory runs in the background. dots 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.

