# Friends Data API

Independent, read-only market and research data API.

- Base URL: https://api.alphahubs.uk
- Authentication: Authorization: Bearer $FRIENDS_DATA_API_KEY
- OpenAPI: https://api.alphahubs.uk/openapi.json
- Human documentation: https://api.alphahubs.uk/api/docs
- Dataset and field dictionary: https://api.alphahubs.uk/datasets
- Machine-readable dictionary: https://api.alphahubs.uk/static/downloads/friends-data-dictionary-v2.json
- Full compressed dictionary: https://api.alphahubs.uk/static/downloads/friends-data-dictionary-v2.full.json.gz
- Dictionary JSON Schema: https://api.alphahubs.uk/static/downloads/friends-data-dictionary-v2.schema.json
- Python/CLI/MCP wheel: https://api.alphahubs.uk/static/downloads/friends_data_api-1.1.0-py3-none-any.whl
- Codex skill: https://api.alphahubs.uk/static/downloads/query-friends-data-1.1.0.zip
- MCP tools: list_datasets, search_instruments, get_market_quotes, get_market_candles, get_dataset_rows, get_point_in_time_rows, get_sec_earnings_context