Introduction
Use the FinFeedAPI Currencies Historical MCP server to discover assets, list supported periods, fetch point-in-time rates, and retrieve OHLC exchange-rate timeseries.
Currencies API Historical MCP
The FinFeedAPI Currencies Historical API is available through a hosted Model Context Protocol (MCP) server at https://api-historical.fx.finfeedapi.com/mcp.
It exposes the historical FX and crypto exchange-rates API as self-describing tools that can be used from Cursor, Claude Desktop, or custom agent runtimes.
Why use MCP?
MCP layers self-describing JSON-Schema tools over the underlying HTTP API, so agent runtimes can discover available operations, validate arguments, and call the service without a custom integration layer.
With the historical Currencies MCP server you can:
- Reuse the same
X-APIKeyauthentication you already use with FinFeedAPI. - Let MCP-aware clients inspect tool schemas before calling the API.
- Connect directly to a dedicated hosted endpoint instead of building your own adapter.
Use your regular FinFeedAPI API key in the X-APIKey header.
What is available through MCP?
The historical server currently exposes 6 tools grouped into three areas:
| Area | What you can do |
|---|---|
| Metadata discovery | List assets, fetch asset icon URLs, and enumerate supported candle periods. |
| Point-in-time rates | Retrieve one historical rate for a pair or get all rates from one base asset at a chosen timestamp. |
| Historical timeseries | Pull OHLC exchange-rate candles for a pair across periods from 1SEC up to 10DAY. |
Typical workflows
Discover valid symbols
- Call
exchange_rates_history_list_assetsto confirm supportedasset_idvalues such asBTC,USD, orEUR. - Optionally use
filter_asset_idto reduce the payload when you already know the assets you care about. - Call
exchange_rates_history_list_asset_iconsif you need icon URLs for UI rendering.
Get a historical rate snapshot
- Call
exchange_rates_history_get_ratefor one pair at one timestamp. - Call
exchange_rates_history_get_all_rateswhen you need one base asset priced against multiple quotes at the same time. - Use
invert: trueif your consumer needs the reciprocal rate without post-processing.
Build charts and candles
- Call
exchange_rates_history_list_periodsto discover validperiod_idvalues. - Use
exchange_rates_history_get_timeserieswithasset_id_base,asset_id_quote, andperiod_id. - Add
time_start,time_end, andlimitto control the returned time window.
Live-tested notes
exchange_rates_history_list_periodscurrently returns granularities from1SECthrough10DAY.exchange_rates_history_get_timeseriesreturns OHLC rows with fields such astime_period_start,time_open,rate_open,rate_high,rate_low, andrate_close.- The
limitforexchange_rates_history_get_timeseriessupports values from1to100000. extended_gap_fillingis available for timeseries calls when you need better continuity around the requested boundaries.- Both
exchange_rates_history_list_assetsandexchange_rates_history_get_all_ratesacceptfilter_asset_idas a comma- or semicolon-delimited list.
