# Leeway Financial Data API — Full Reference for LLMs

## Overview

Leeway is a financial market data API with first-class MCP (Model Context Protocol) support.
Data is served as JSON via REST and as MCP tools auto-generated from the OpenAPI specification.

- Website: https://leeway.tech/data-api
- MCP onboarding: https://leeway.tech/mcp
- MCP setup: https://leeway.tech/mcp/setup
- REST base: https://api.leeway.tech/api/v1/public
- OpenAPI 3.0: https://api.leeway.tech/openapi.json
- MCP endpoint: https://mcp.leeway.tech/mcp
- MCP health: https://mcp.leeway.tech/health

## Authentication

### REST API
- Query parameter: `?apitoken=YOUR_TOKEN`
- Sample data: `SAP.XETRA` endpoints work without token on some routes

### MCP
- HTTP: `Authorization: Bearer YOUR_TOKEN` on every MCP request
- stdio bridge (Claude Desktop, via `npx mcp-remote`): same `Authorization: Bearer YOUR_TOKEN`, passed as `--header`
- Token source: https://leeway.tech/account (free signup, 50 units/day)

## Rate Limits

- Burst: 1 request per 250ms per token/IP
- Daily units: free 50/day, paid 100,000/day
- HTTP 429 when exceeded
- Check remaining: tool `general_dailyrequestsleft`

## MCP Tools (32 tools, auto-generated from OpenAPI)

### General
| Tool | REST path | Description |
|------|-----------|-------------|
| general_isin | GET /general/isin/{isin} | Resolve ISIN or name substring to listings |
| general_mainstock | GET /general/mainstock/{isin} | Main stock by ISIN |
| general_symbols | GET /general/symbols/{exchange} | All symbols on exchange |
| general_exchanges | GET /general/exchanges | List exchanges |
| general_screener | GET /general/screener | Filter by fundamentals (10 units) |
| general_tradingperiod | GET /general/tradingperiod/{symbolExchange} | First/last trading date |
| general_dailyrequestsleft | GET /general/dailyrequestsleft | Remaining daily units |

### Historical Quotes
| Tool | REST path |
|------|-----------|
| historicalquotes_marketwide-lastday-quote | GET /historicalquotes/marketwide-lastday-quote/{exchange} |
| historicalquotes | GET /historicalquotes/{symbolExchange} |
| historicalquotes_marketcap | GET /historicalquotes/marketcap/{symbolExchange} |
| historicalquotes_marketcap_aggregation | GET /historicalquotes/marketcap/aggregation/{type} |
| historicalquotes_benchmark | GET /historicalquotes/benchmark |

### Fundamentals
| Tool | REST path |
|------|-----------|
| fundamentals | GET /fundamentals/{symbolExchange} |
| fundamentals_forecast | GET /fundamentals/forecast/{symbolExchange} |
| fundamentals_keyfigures | GET /fundamentals/keyfigures/{symbolExchange} |

### Market Data
| Tool | REST path |
|------|-----------|
| live | GET /live/{symbolExchange} |
| live_relative-move | GET /live/relative-move/{symbolExchange} |
| dividends | GET /dividends/{symbolExchange} |
| dividends_history | GET /dividends/history/{symbolExchange} |
| splits | GET /splits/{symbolExchange} |
| intraday | GET /intraday/{symbolExchange} |

### Events & Macro
| Tool | REST path |
|------|-----------|
| events_ipos | GET /events/ipos |
| events_earnings | GET /events/earnings |
| events_trends | GET /events/trends |
| events_splits | GET /events/splits |
| macro_indicators | GET /macro/indicators |
| macro_countries | GET /macro/countries |
| macro | GET /macro/{country} |
| bond | GET /bond/{isin} |
| news | GET /news/ |

### Images
| Tool | REST path |
|------|-----------|
| img_logos | GET /img/logos/{path} |
| img_logosbycodeexchange | GET /img/logosbycodeexchange/{codeexchange} |

## Typical Workflow

1. `general_isin` with query "SAP" or ISIN → get `SAP.XETRA`
2. `fundamentals` with symbolExchange `SAP.XETRA`
3. `historicalquotes` with symbolExchange `SAP.XETRA`
4. `general_screener` with filters for European tech stocks

## Symbol Format

Use `SYMBOL.EXCHANGE` (e.g. `DTE.XETRA`, `AAPL.US`).

## Positioning

European coverage is a key differentiator: XETRA, Frankfurt, Euronext Paris/Amsterdam, LSE plus US markets.

## Contact

kontakt@leeway.tech