canonical: https://jentic.com/apis/finage.co.uk/finage

# Finage API

Jentic publishes the only available OpenAPI specification for Finage API, keeping it validated and agent-ready. The Finage API delivers real-time and historical market data across stocks, forex, and cryptocurrencies through six focused endpoints. Authentication is performed by appending an apikey query parameter to each request against api.finage.co.uk. The API is used by fintech builders, dashboards, and automated trading workflows that need a single feed for last-trade quotes, OHLC aggregates, historical bars, and overall market status.

## For AI agents

Read last-trade and historical price data for stocks, forex, and crypto via the apikey query parameter. Useful for agents building market dashboards and trading workflows.

## Scope

Does not handle order execution, brokerage account management, or options chains - use for last-trade and historical price data on stocks, forex, and crypto only.

## Capabilities

- Fetch the last-trade price for a US stock symbol via GET `/last/stock/{symbol}`
- Pull OHLC aggregates for a stock over arbitrary periods via GET `/agg/stock/{symbol}/{period}`
- Get the last-trade price for a forex pair such as EURUSD
- Read the latest crypto trade for symbols like BTCUSD
- Retrieve historical stock bars for backtesting and charting
- Check overall market status (open, closed, holiday) before placing or routing trades

## Use cases

### Real-Time Market Dashboard

Fintech teams building portfolio dashboards can have an agent poll GET `/last/stock/{symbol}` for each holding and refresh portfolio value on a schedule. Adding GET `/last/forex/{pair}` and GET `/last/crypto/{symbol}` extends the dashboard to multi-asset portfolios without integrating three separate vendors.

Example prompt: On each refresh, call GET `/last/stock/{symbol}` for every holding, sum the position values, and emit the updated portfolio total.

### Backtesting Historical Strategies

Quant builders can pull GET `/history/stock/{symbol}` for the symbols and date range under test, then run their strategy logic locally. Because Finage returns OHLC bars rather than tick data, this is best suited for daily or intraday-bar strategies rather than microstructure work.

Example prompt: Call GET `/history/stock/{symbol}` with from and to dates, feed the bars into the strategy, and emit the resulting equity curve.

### Market Open Trade Routing

Automated trading workflows can hit GET /marketstatus before placing orders, holding orders that arrive outside regular hours and routing them through a different venue or queueing them for the open. This avoids the embarrassment of submitting equity orders into a closed exchange.

Example prompt: Before each order, call GET /marketstatus and route to either the live broker (open) or the queued-orders store (closed).

### AI Agent Finage Integration via Jentic

An agent connected to Jentic can search by intent (for example get the last trade price for a stock) and Jentic returns the matching Finage operation along with its input schema. The Finage apikey lives in the vault, so the agent can call price endpoints without ever embedding the key. Integration drops from a one-day SDK setup to under an hour.

Example prompt: Search Jentic for get the last stock price, load GET `/last/stock/{symbol}`, and execute with AAPL as the symbol while Jentic appends the apikey.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/last/stock/{symbol}` | Last trade price for a stock symbol |
| GET | `/agg/stock/{symbol}/{period}` | OHLC aggregates for a stock over a period |
| GET | `/last/forex/{pair}` | Last trade price for a forex pair |
| GET | `/last/crypto/{symbol}` | Last trade price for a crypto symbol |
| GET | `/history/stock/{symbol}` | Historical OHLC bars for a stock |
| GET | `/marketstatus` | Current US market open or closed status |

## Key resources

- **Stock Quotes** — Last-trade prices, aggregates, and historical bars for stocks
- **Forex Quotes** — Last-trade prices for forex pairs
- **Crypto Quotes** — Last-trade prices for crypto symbols
- **Market Status** — Current open, closed, or holiday status for the US market

## Why Jentic

- **Setup:** Wiring the Finage API by hand means appending the apikey query parameter to every call, keeping it out of your own request logs, and splitting last-trade from historical routes across stocks, forex, and crypto yourself. Through Jentic you install once, import the Finage API from the API Directory, store the API key once, and your agent calls it.
- **Permission scoping:** Finage is read-only market data keyed by symbol in the path rather than by an owned resource, so limit the agent to the operations it needs, such as last stock price, aggregates, or forex and crypto quotes, and leave the rest out. Because you choose the allowed operations, the agent only reads the price data you name.
- **Credential handling:** Your Finage apikey is stored once, encrypted, by your own Jentic One instance and injected at execution time. The raw key never enters the agent's prompt, logs, or context, and it stays out of the query string the agent sees.
- **Discovery method:** Agents search Jentic by intent such as 'get the last stock price' or 'pull historical forex data', and Jentic returns the matching Finage operation with its input schema, so the agent calls the right endpoint without reading the spec.

## Related APIs

- **Alpha Vantage API** — Free-tier market data with broader endpoint coverage than Finage
- **Alpaca Trading API** — Market data plus brokerage in one platform
- **CoinGecko API** — Crypto market data with deeper coin coverage and metadata

## FAQ

### Why is there no official OpenAPI spec for Finage API?

Finage does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Finage API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the Finage API use?

Finage uses an API key passed as the apikey query parameter on every request. Through Jentic the key is stored in the encrypted vault and appended at execution time, so the agent never embeds the key in its prompts or logs.

### Can I get historical stock bars with the Finage API?

Yes. Call GET `/history/stock/{symbol}` with the symbol and a date range. The endpoint returns OHLC bars suitable for charting and backtesting daily or intraday-bar strategies.

### What are the rate limits for the Finage API?

Finage applies per-plan rate limits rather than publishing a single fixed RPS. Lower-tier plans cap requests per minute; higher-tier plans loosen those limits. Agents should treat 429 responses as a backoff signal.

### How do I check whether the US market is open via Jentic?

Search Jentic for check us market status, load GET /marketstatus, and execute. Jentic appends the Finage apikey from the vault and returns the open, closed, or holiday status.

### Can I get the latest crypto price with the Finage API?

Yes. Call GET `/last/crypto/{symbol}` with a symbol such as BTCUSD. Finage returns the latest trade price aggregated across the venues it ingests for that pair.

### Can I limit what my agent is allowed to do with the Finage API?

Yes. Because Jentic One is self-hosted, you set the rules that decide which Finage operations and credentials your agent may use. Finage is read-only market data keyed by symbol, so you can allow only the endpoints you need, such as the last stock price at GET `/last/stock/{symbol}`, OHLC aggregates at GET `/agg/stock/{symbol}/{period}`, or forex and crypto quotes, and leave the rest, including historical bars and market status, out of reach. Since you choose the allowed operations, the agent can only read the price data you name.