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

# How to Use Marketstack stock exchange directory in Muse

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 Muse

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

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

### Use the Muse connector

1. **Create an API key**: Create one under API keys in the Spiral console.

2. **Send Muse this message**: Muse reads Spiral's skill and asks for an API key.

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

3. **Give Muse the key**: Paste the key when Muse asks for it, never in the chat itself.

### Use the Spiral skill

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

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

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

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

## 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](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 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 Muse guides

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

## Questions about Marketstack stock exchange directory in Muse

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

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

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

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

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

You need no Alexandria account. Muse 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 Muse?**

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

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

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

