# Finage

> Finage is a real-time and historical market data provider covering US and global stocks, forex, cryptocurrencies, CFD indices, ETFs, bonds, and company fundamentals — delivered over a REST API (api.finage.co.uk, apikey query-parameter auth, all endpoints GET, gzip required) and dedicated WebSocket streams (per-customer subdomain on finage.ws, socket-key token auth). Sign up at https://moon.finage.co.uk/register; a 3-day free trial covers all markets.

Generated by API Evangelist from the Finage docs database (https://api.finage.co.uk/op/v1/endpoints/list) and the artifacts in https://github.com/api-evangelist/finage. Finage does not publish its own llms.txt (checked https://finage.co.uk/llms.txt on 2026-07-22).

## APIs

- [Finage Market Data API](https://finage.co.uk/docs/api): 72 GET endpoints across US Stocks, Forex, Crypto, Indices, ETFs, UK/Indian/Canadian/Russian stocks, Bonds, and Fundamentals (statements, calendars, news, technical indicators, search)
- [Finage WebSocket streams](https://finage.co.uk/docs/websocket): real-time trades and quotes; your assigned wss URL, port, and socket key are in the dashboard
- [Symbol lists](https://finage.co.uk/docs/symbols): symbology reference for all covered markets

## Specs

- [OpenAPI 3.0 (generated from Finage's docs database)](https://raw.githubusercontent.com/api-evangelist/finage/main/openapi/finage-openapi.yml)
- [AsyncAPI 3.0 for the WebSocket stream (derived from docs)](https://raw.githubusercontent.com/api-evangelist/finage/main/asyncapi/finage-websocket-asyncapi.yml)

## Docs

- [Documentation](https://finage.co.uk/docs/api)
- [Pricing](https://finage.co.uk/pricing) — free API plan (1,000 requests/month), Basic packages from $49-$169/month with 100,000 calls/month, Professional WebSocket feeds $499-$2,899/month
- [Widgets](https://finage.co.uk/product/widgets) — embeddable ticker, tape, converter, and historical-chart widgets loaded from cdn.finage.co.uk
- [FAQ](https://finage.co.uk/company/frequently-asked-questions)
- [Blog](https://finage.co.uk/blog)
- [Terms of Use](https://finage.co.uk/company/privacy-policy/terms-of-use)
- [Privacy Policy](https://finage.co.uk/company/privacy-policy/privacy-policy)
- [GitHub examples](https://github.com/FinageLTD)
- Support: support@finage.co.uk

## Key conventions

- Authenticate every REST request with `?apikey=YOUR_API_KEY`
- Send `Accept-Encoding: gzip` — the API returns 406 `{"error":"GZip compression required"}` without it
- Errors come as a single JSON envelope: `{"error":"<message>"}`
- Timestamps are Unix epoch milliseconds; date range parameters use YYYY-MM-DD
- WebSocket errors: `401 - invalid socket key`, `401 - use your socket key to connect`, `401 - please upgrade your package to access this market`