🔗 MCP Historical API

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-APIKey authentication 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:

AreaWhat you can do
Metadata discoveryList assets, fetch asset icon URLs, and enumerate supported candle periods.
Point-in-time ratesRetrieve one historical rate for a pair or get all rates from one base asset at a chosen timestamp.
Historical timeseriesPull OHLC exchange-rate candles for a pair across periods from 1SEC up to 10DAY.

Typical workflows

Discover valid symbols

  1. Call exchange_rates_history_list_assets to confirm supported asset_id values such as BTC, USD, or EUR.
  2. Optionally use filter_asset_id to reduce the payload when you already know the assets you care about.
  3. Call exchange_rates_history_list_asset_icons if you need icon URLs for UI rendering.

Get a historical rate snapshot

  1. Call exchange_rates_history_get_rate for one pair at one timestamp.
  2. Call exchange_rates_history_get_all_rates when you need one base asset priced against multiple quotes at the same time.
  3. Use invert: true if your consumer needs the reciprocal rate without post-processing.

Build charts and candles

  1. Call exchange_rates_history_list_periods to discover valid period_id values.
  2. Use exchange_rates_history_get_timeseries with asset_id_base, asset_id_quote, and period_id.
  3. Add time_start, time_end, and limit to control the returned time window.

Live-tested notes

  • exchange_rates_history_list_periods currently returns granularities from 1SEC through 10DAY.
  • exchange_rates_history_get_timeseries returns OHLC rows with fields such as time_period_start, time_open, rate_open, rate_high, rate_low, and rate_close.
  • The limit for exchange_rates_history_get_timeseries supports values from 1 to 100000.
  • extended_gap_filling is available for timeseries calls when you need better continuity around the requested boundaries.
  • Both exchange_rates_history_list_assets and exchange_rates_history_get_all_rates accept filter_asset_id as a comma- or semicolon-delimited list.

Start here

Service StatusGitHub SDK