# Indices-API – Full API Reference for LLMs

> Real-time and historical market indices JSON API: S&P 500, Nasdaq, Dow Jones, FTSE 100, and 200+ world indices.

## Authentication

REST requires the query parameter `access_key` on every request:

```
GET https://indices-api.com/api/latest?access_key=YOUR_ACCESS_KEY&base=USD&symbols=GSPC
```

MCP uses `Authorization: Bearer YOUR_API_KEY` on `https://indices-api.mcp.indices-api.com/mcp`. Do not put the key in the URL (`?api_key=` or `?apikey=`) — Claude Desktop and claude.ai reject tokens in the query string. There is no OAuth client. Do not use `npx` or `mcp-remote`.

```
https://indices-api.mcp.indices-api.com/mcp
```

Get a key at https://indices-api.com/register

## Base URL

https://indices-api.com/api

---

## 1. Supported Symbols

GET /api/symbols

Retrieve the list of available market index and currency symbols.

```
GET /api/symbols?access_key=YOUR_ACCESS_KEY
```

MCP tool: `indices.symbols`

Docs: https://indices-api.com/documentation#supportedsymbols

---

## 2. Latest Rates

GET /api/latest

Real-time index rates. Update frequency depends on plan (e.g. 60 minutes, 10 minutes, or 60 seconds).

Query params: `access_key` (required), `base` (default USD), `symbols` (comma-separated).

```
GET /api/latest?access_key=YOUR_ACCESS_KEY&base=USD&symbols=GSPC,DJI,IXIC
```

MCP tool: `indices.latest`

Docs: https://indices-api.com/documentation#latestrates

---

## 3. Historical Rates

GET /api/{YYYY-MM-DD}

Historical closing rates for a past date.

```
GET /api/2025-08-18?access_key=YOUR_ACCESS_KEY&base=USD&symbols=GSPC
```

MCP tool: `indices.historical` (pass `date`, `base`, `symbols`; key in `Authorization: Bearer`)

Docs: https://indices-api.com/documentation#historicalrates

---

## 4. Convert

GET /api/convert

Convert an amount from one currency or index symbol to another (live or historical).

Query params: `access_key`, `from`, `to`, `amount`, optional `date`.

```
GET /api/convert?access_key=YOUR_ACCESS_KEY&from=GBP&to=JPY&amount=25&date=2025-08-18
```

MCP tool: `indices.convert`

Docs: https://indices-api.com/documentation#convertcurrency

---

## 5. Time-Series

GET /api/timeseries

Daily historical rates between two dates.

Query params: `access_key`, `start_date`, `end_date`, `base`, `symbols`, optional `order`.

```
GET /api/timeseries?access_key=YOUR_ACCESS_KEY&start_date=2025-08-01&end_date=2025-08-18&base=USD&symbols=GSPC&order=desc
```

MCP tool: `indices.time_series`

Docs: https://indices-api.com/documentation#timeseries

---

## 6. Fluctuation

GET /api/fluctuation

Absolute and percentage change between two dates.

```
GET /api/fluctuation?access_key=YOUR_ACCESS_KEY&start_date=2025-05-01&end_date=2025-05-05&base=USD&symbols=GSPC
```

MCP tool: `indices.fluctuation`

Docs: https://indices-api.com/documentation#fluctuation

---

## 7. OHLC

GET /api/open-high-low-close/{YYYY-MM-DD}

Open, high, low, and close for a trading day.

```
GET /api/open-high-low-close/2025-08-18?access_key=YOUR_ACCESS_KEY&base=USD&symbols=GSPC
```

MCP tool: `indices.ohlc`

Docs: https://indices-api.com/documentation#open-high-low-close

---

## 8. Intraday

GET /api/intraday

Intraday candles for one symbol on a date.

Query params: `access_key`, `symbol`, `base`, `date`, optional `interval` (`1m`, `5m`, `10m`, `15m`, `30m`, `45m`, `1h`, `2h`, `4h`, `8h`, `12h`, `1d`).

```
GET /api/intraday?access_key=YOUR_ACCESS_KEY&symbol=NYA&base=USD&date=2025-07-25&interval=1h
```

MCP tool: `indices.intraday`

Docs: https://indices-api.com/documentation#intraday

---

## MCP

- Setup: https://indices-api.com/mcp
- Endpoint: https://indices-api.mcp.indices-api.com/mcp
- Server card: https://indices-api.com/.well-known/mcp/server-card.json
- Tools: `indices.symbols`, `indices.latest`, `indices.historical`, `indices.convert`, `indices.time_series`, `indices.fluctuation`, `indices.ohlc`, `indices.intraday`

## Response shape

JSON with `success`, `timestamp`, `base`, `date`, and `rates`. Default base is USD.