Developers

How it works

• This is a pull API only — you poll it. There are no webhooks or push notifications.
• Authenticate every request with Authorization: Bearer <your key> — not a query parameter, so your key never ends up in a log line.
• A free key is limited to 100 requests per day, reset at midnight UTC. Every response includes X-RateLimit-Limit and X-RateLimit-Remaining headers so you can self-throttle.
• An invalid or revoked key returns 401; going over the daily limit returns 429.
• Only one key is active per account — generating a new one revokes the old.

GET/api/public/v1/quote?symbol=AAPL

A single symbol's current quote.

curl https://market-watch.co.uk/api/public/v1/quote?symbol=AAPL \
  -H "Authorization: Bearer mw_live_..."

GET/api/public/v1/stock/:symbol?range=1y

Full detail for one stock — quote, fundamentals, and OHLCV history. range is one of 1d, 5d, 1mo, 3mo, 1y, 5y.

curl https://market-watch.co.uk/api/public/v1/stock/AAPL?range=1mo \
  -H "Authorization: Bearer mw_live_..."

GET/api/public/v1/commodities

Quotes for the site's tracked commodities (gas, power, oil, agriculturals, metals).

curl https://market-watch.co.uk/api/public/v1/commodities \
  -H "Authorization: Bearer mw_live_..."

GET/api/public/v1/crypto-fx

Quotes for the site's tracked crypto and FX pairs.

curl https://market-watch.co.uk/api/public/v1/crypto-fx \
  -H "Authorization: Bearer mw_live_..."

GET/api/public/v1/econ-calendar

Upcoming economic events (FOMC, CPI, jobs data) for the next 60 days.

curl https://market-watch.co.uk/api/public/v1/econ-calendar \
  -H "Authorization: Bearer mw_live_..."