FCS Forex API

Get Started

Quickly integrate the FCS Forex API for real-time and historical rates. Use any language (PHP, JavaScript, Java, C#, etc.). Responses are JSON for easy parsing; try the cURL example below to fetch the latest EURUSD rate.

Follow these 3 quick steps to start using the FCS Forex API.

Step 1: Get Your API Key

Sign up and get your API key instantly. Free plans available for testing.

Step 2: Try a Simple cURL Request

Run this command (replace YOUR_API_KEY):

curl "https://api-v4.fcsapi.com/forex/latest?symbol=EURUSD&access_key=YOUR_API_KEY"

Step 3: Integrate in Your App

Use the JSON response in your application. Toggle parameters like symbol, period, and exchange to fetch the data you need.

Parameters List

Symbols List

You can access the complete list of supported currency short names and symbols using the API below. These symbols will allow you to fetch indicator values, historical trends, and real-time exchange rates. Our forex API endpoint is regularly updated, guaranteeing you always have the most up-to-date forex currencies in real time.

Latest Prices

The Latest Currency Rate API is extremely beneficial, ensuring you stay informed with up-to-date currency prices. Our Currency Conversion API enables you to retrieve one or multiple currency rates at once. You can get active/current candle OHLC and previous closed candle prices.

{
    "type": "forex",
    "sub_type": "spot",
    "symbol":"EURUSD,USDJPY",
    "exchange": "ONA,FX",
    "period": "1d",
    "get_profile": 1,
    "per_page": "20",
    "access_key": "API_KEY"
}

Response Format

{
    "active": {
        "o": 1.16153,
        "h": 1.16256,
        "l": 1.16128,
        "c": 1.16192,
        "v": 3182,
        "t": 1756155600,
        "vw": 1.16808,
        "ch": 0.00039,
        "chp": 0.034
    },
    "profile": {
        "id": "165558",
        "symbol": "EURUSD",
        "exchange": "FX",
        "name": "EURO / U.S. DOLLAR",
        "type": "forex",
        "sub_type": "",
        "currency": "USD",
        "country": "",
        "base_id": "EU"
    },
    "more": {
        ".....": "4000+ more currency prices"
    }
}

Commodities

We provide commodity market data for precious metals, energies, and base metals. To request commodities from any endpoint, pass type=commodity. Example symbols include Gold (XAUUSD), Silver (XAGUSD), Crude Oil (USOIL / WTI), Brent (BRENT), Natural Gas (NGAS), Copper, and Platinum. Use the Symbols List API to find exact tickers available on the platform.

Response Format

{
    "ticker": "XAUUSD",
    "update": 1765318304,
    "active": {
        "o": 2500,
        "h": 2530,
        "l": 2498.5,
        "c": 2523.1,
        "t": 1765317600
    }
}

Currency Converter

In our Currency API, price conversion is an essential function that enables you to exchange between two chosen currencies. To achieve this, simply include the symbols parameter along with the amount you wish to convert. Our Currency Exchange API ensures a seamless and efficient conversion process.

Response Format

{
    "total": "11.7362",
    "price_1x_EUR": "0.85206",
    "price_1x_USD": "1.17362",
    "more": "10 EUR into USD"
}

Base Currency

Single base currency, it will return all quote prices of all currencies. If direct currency pair not available e.g: we not have a INRBDT, system automatic derive from intermediate pairs (e.g., BDTUSD and INRUSD → INRBDT). Only last close price returned. For OHLC data please use our Latest Price API or Cross API.
e.g: You set USD and API will return USDEUR, USDNZD, USDBTC....

Response Format

{
    "base": "USD",
    "USDAUD": 1.5343,
    "USDBRL": 5.4736,
    "USDCAD": 1.38208,
    "USDCHF": 0.8055,
    "USDEUR": 0.8587,
    "more": "all prices with Base USD",
    "info": {
        "credit_count": 1
    }
}

Cross Currency

Return OHLC (open, high, low, close) and bid/ask data for all cross pairs of the given currency. For example, if you set symbol=USD, the API will return USDJPY, USDEUR, USDGBP, USDPKR, USDxxx and more.
•By default, the API returns pairs with the base currency first (e.g., USDEUR). To get the reverse pair (EURUSD), calculate it manually as 1/USDEUR.
•When using multiple symbols with crossrates=1, the API returns all pairwise cross rates between them (both directions). With crossrates=0 (default), it returns pairs starting with each provided currency.

About crossrates parameter: When crossrates=1 and you pass multiple single-currency symbols (for example symbol=USD,EUR,JPY), the API returns all pairwise cross rates between those currencies (both directions). Example pairs returned: USDEUR, EURUSD, USDJPY, EURJPY, JPYUSD, JPYEUR. When crossrates=0 (default), the API returns symbols that start with each provided currency (e.g. all symbols beginning with USD*, EUR*, JPY*).

Historical Price API

If you're looking to compare current exchange prices with past rates to watch the market trends, our Forex History API offers comprehensive historical exchange data for all supported symbols. For most symbols, historical prices are available starting from 1995, with data in 1-day or higher time frames.

Response Format

{
    "1748815200": {
        "o": 1.13479,
        "h": 1.14495,
        "l": 1.13476,
        "c": 1.14363,
        "v": 434204,
        "vw": 1.144,
        "t": 1748815200,
        "tm": "2025-06-01 22:00:00"
    }
}

Currency Profile Details

In our API, You can get all the details about Forex currencies. Details like its name, country name, bank name, currency unit, type of notes and more details.

Response Format

{
    "short_name": "EUR",
    "name": "Euro",
    "country": "Belgium",
    "code_n": "978",
    "subunit": "cent",
    "website": "ecb.europa.eu",
    "symbol": "€",
    "bank": "European Central Bank",
    "banknotes": "€5, €10, €20, €50, €100",
    "coins": "1c, 2c, 5c, 10c, 20c, 50c, €1, €2"
}

Exchange Coverage & Data Sources

Our Forex API aggregates data from 10+ premium exchanges and data feed providers worldwide. Get real-time coverage statistics and exchange details to choose the best data sources for your application.

Response Format

Advanced Query API

(ALL IN ONE) The Advanced Query API is a powerful endpoint that combines multiple data sources and provides flexible filtering, sorting, and pagination capabilities. This unified API allows you to retrieve forex data with advanced customization options, making it perfect for complex trading applications and data analysis.

POST/RAW JSON both accepted
{ 
    "symbol":"FX:EURUSD,SFO:JPYUSD",  // EXCHANGE:SYMBOL
    "exchange":"", // return data from specific exchange 
    "type":"forex", // forex 
    "sub_type":"spot", // spot,synthetic 
    "period":"1d", // 1m,5m, to 1month 
    "columns":"", // return specific columns/All
    "keep_parent_colm":0, //(0|1) work with columns
    "filters":{"active.c_gt":1}, // range filter 
    "sort_by":"active.chp_desc", // columnname_asc /desc 
    "merge" :"latest,perf,tech,profile,meta", // merge other api
    "page":1, 
    "per_page":"50", //  
    "search":"", // search and symbol will not work together 
    "access_key":"API_KEY"
}

Sorting API Guide (Top Gainers, Losers, Movers)

The Gainer/Loser API is built on our Advanced API framework, specifically optimized for identifying top-performing and worst-performing currency pairs. You can sort results of by using Advanced API by using simple sorting parameters. This allows you to fetch Top Gainers, Losers, Most Active by Volume, or Highest by Value without a separate endpoint. Just append the column name with `_asc` or `_desc`.

Sort Parameter Guide:
Format: {column_name}_{direction} where direction is asc (ascending) or desc (descending).
• Column names are case-sensitive and must match exactly as they appear in the API response
• Only columns present in the response can be used for sorting
• Examples: chp_desc (top gainers), chp_asc (top losers), v_desc (highest volume), c_asc (lowest price)

{
    "type": "forex",
    "sub_type": "spot",
    "symbols":"",
    "exchange": "FX", 
    "period": "1h",
    "columns": "",
    "keep_parent_colm": 0,
    "sort_by": "active.chp_desc",  // Sort by Change % DESC
    "filters": {}, 
    "merge": "latest,profile", // return latest prices and profile
    "per_page": "20", // limit reponse by 20 result only.
    "access_key": "API_KEY"
}

Moving Average API (EMA & SMA)

The Moving Average API provides calculated Exponential Moving Average (EMA) and Simple Moving Average (SMA) values for multiple time periods. This helps traders and developers analyze short-term and long-term market trends using reliable forex technical indicators. You can easily integrate these signals into trading bots, charting tools, or algorithmic strategies.

{
    "type": "forex",
    "symbols": "EURUSD,USDJPY",
    "exchange": "FX",
    "period": "1d",

    "access_key": "API_KEY"
}

Response Format

{
    "signal": {
        "summary": "WEAK_SELL",
        "score": -23,
        "confidence": "LOW",
        "trend": "WEAK",
        "volatility": "LOW"
    },
    "ma_avg": {
        "ema10": {
            "v": 1.16496,
            "s": "Neutral",
            "n": "EMA 10",
            "score": 0
        },
        "ema25": {
            "v": 1.16524,
            "s": "Neutral",
            "n": "EMA 25",
            "score": 0
        }
    }
}

Technical Indicators API

The Technical Indicators API provides a comprehensive set of popular technical indicators and Oscillator indicators including RSI, MACD, Stochastic, and more. Get precise indicator values for your trading strategies and analysis.

{
    "type": "forex",
    "symbols": "EURUSD,USDJPY",
    "exchange": "FX",
    "period": "1d",
    "access_key": "API_KEY"
}

Response Format

{
    "ticker": "FCM:EURUSD",
    "signal": {
        "summary": "BUY",
        "score": 48.6,
        "confidence": "LOW",
        "trend": "WEAK",
        "volatility": "LOW"
    },
    "indicators": {
        "volatility": {
            "atr_per": 0.663,
            "true_range": 0.00739,
            "level": "Low"
        },
        "bollinger": {
            "width_per": 1.097,
            "pos_per": 50.78,
            "middle": 1.16502,
            "squeeze": "Squeeze"
        },
        "price_action": {
            "body_size": 0.00203,
            "shadow_u": 0.00213,
            "shadow_l": 0.00323,
            "body_range_per": 27.47,
            "c_type": "Bullish",
            "pattern": "Normal"
        }
    },
    "oscillators": {
        "rsi": {
            "v": 49.2919,
            "s": "Neutral",
            "n": "RSI",
            "score": 0
        },
        "stoch": {
            "v": 43.9802,
            "s": "Sell",
            "n": "STOCH K%",
            "score": -25
        },
        "macd": {
            "v": 0.0008076,
            "s": "Sell",
            "n": "MACD Level",
            "score": -25
        }
    }
}

Pivot Points API

The Pivot Points API delivers key support and resistance levels calculated from multiple pivot point methods. These levels are widely used in forex and stock markets for intraday trading, trend confirmation, and setting stop-loss or take-profit targets. Supported methods include Classic, Fibonacci, Camarilla, Woodie, and Demark.

{
    "type": "forex",
    "symbols": "EURUSD,USDJPY",
    "exchange": "FX",
    "period": "1d",
    "access_key": "API_KEY"
}

Performance Analysis API

Comprehensive performance analytics for currency pairs including historical highs/lows, percentage changes across multiple timeframes, and volatility metrics. Essential for fundamental analysis, portfolio management, and risk assessment of forex instruments.

Response Format

{
    "H1M": 1.17428,
    "L1M": 1.15276,
    "H3M": 1.18299,
    "L3M": 1.13717,
    "H6M": 1.18299,
    "L6M": 1.07332,
    "H52": 1.18299,
    "L52": 1.01775,
    "HIGHEST": 1.60381,
    "LOWEST": 0.95361,
    "PW": 0.0360736,
    "P1M": 0.527797,
    "P3M": 2.00122,
    "P6M": 8.00406,
    "PYTD": 12.489,
    "PY": 5.19943,
    "P5Y": -1.72676,
    "PAll": -1.78973,
    "voltD": 0.418582,
    "voltW": 0.567319,
    "voltM": 0.664304
}

Economic Calendar API

Get real-time economic events and indicators as they are announced. See the immediate impact of global markets, including past, forecast, and actual figures for major economic events.

Response Format

{
    "id": 326627,
    "event": "JPRSMM",
    "title": "Retail Sales MoM",
    "country": "JP",
    "currency": "JPY",
    "importance": 0,
    "actual": "",
    "forecast": "",
    "previous": -0.4,
    "date": "2023-08-30 23:50:00"
}

Search API

This API is like website search. You can search all currencies with similar names. It will search in currency full name and short name.

Response Format

{
    "id": "1292",
    "symbol": "AUDCNH",
    "name": "Australian Dollar / Chinese Yuan",
    "type": "forex",
    "sub_type": "-",
    "currency": "CNH",
    "exchange": "CAPITALCOM",
    "country": "CN",
    "base_id": "AU",
    "bulk_support": "1"
}

Multiple URL Requests

When you need to access multiple API endpoints simultaneously, it can be time-consuming. You can write custom code to send parallel API requests or simply use this API for a faster solution. For example, if you're calling 10 APIs and each takes 2 seconds, that adds up to 20 seconds. This API can retrieve all 10 results in just 2 seconds!

Response Format

{
    "url1": [
        {
            "status": true,
            "response": []
        }
    ],
    "url2": [
        {
            "status": true,
            "response": []
        }
    ]
}

Error Codes & Troubleshooting

Understanding API error responses and how to handle them properly. All errors include a status code, error message, and helpful details for debugging.

Common HTTP Status Codes

Rate Limits & Usage

Understanding API usage limits, credit system, and best practices for efficient API usage. Different endpoints have different credit costs based on data complexity.

Plan Limits

Code Examples & SDKs

Ready-to-use code examples in popular programming languages. Copy and paste these examples to quickly integrate FCS API into your application.

Choose your preferred programming language and copy the example code to get started quickly.

Available Languages

• JavaScript: Fetch API, Axios, jQuery examples
• Python: Requests library, asyncio examples
• PHP: cURL, file_get_contents examples
• Java: HttpURLConnection, OkHttp examples
• C#: HttpClient examples
• Node.js: HTTP, Axios examples

curl  "https://api-v4.fcsapi.com/forex/latest?symbol=EURUSD&access_key=API_KEY"

// API endpoint and query params
const url = new URL("https://api-v4.fcsapi.com/forex/latest");

const params = {
  symbol: "ONA:EURUSD,BINANCE:BTCUSD",
  access_key: "test"
};

// Append query parameters to the URL
Object.keys(params).forEach(key => url.searchParams.append(key, params[key]));

// Make the request
fetch(url)
  .then(response => {
    if (!response.ok) {
      throw new Error("Network response was not ok: " + response.statusText);
    }
    return response.json();
  })
  .then(data => {
    if (data.status && Array.isArray(data.response)) {
      data.response.forEach(item => {
        console.log(`Symbol: ${item.symbol}`);
        console.log(`  Exchange: ${item.exchange}`);
        console.log(`  Open:  ${item.o}`);
        console.log(`  Close: ${item.c}`);
        console.log(`  Time:  ${item.t}`);
        console.log('-------------------------');
      });
    } else {
      console.log("Invalid or empty response structure.");
    }
  })
  .catch(error => {
    console.error("Fetch error:", error);
  });

import requests

# Local FCSAPI endpoint
url = "https://api-v4.fcsapi.com/forex/latest"
# Parameters
params = {
    "symbol": "ONA:EURUSD,BINANCE:BTCUSD",
    "access_key": "API_KEY"
}

# Send GET request
response = requests.get(url, params=params)

# Check HTTP status
if response.status_code == 200:
    data = response.json()

    if data.get("status") and "response" in data:
        for item in data["response"]:
            print(f"Symbol: {item.get('symbol')}")
            print(f"  Exchange: {item.get('exchange')}")
            print(f"  Open:  {item.get('o')}")
            print(f"  Close: {item.get('c')}")
            print(f"  Time:  {item.get('t')}")
            print()
    else:
        print("API returned an empty or malformed response.")
else:
    print(f"HTTP Error {response.status_code}: {response.text}")

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Text.Json;
using System.Threading.Tasks;

namespace FcsApiClient
{
    class Program
    {
        static async Task Main(string[] args)
        {
            string url = "https://api-v4.fcsapi.com/forex/latest?symbol=ONA:EURUSD,BINANCE:BTCUSD&access_key=API_KEY";

            using HttpClient client = new HttpClient();

            try
            {
                HttpResponseMessage response = await client.GetAsync(url);
                response.EnsureSuccessStatusCode();

                string json = await response.Content.ReadAsStringAsync();

                var options = new JsonSerializerOptions
                {
                    PropertyNameCaseInsensitive = true
                };

                var result = JsonSerializer.Deserialize(json, options);

                if (result?.Status == true && result.Response != null)
                {
                    foreach (var item in result.Response)
                    {
                        Console.WriteLine($"Symbol: {item.Symbol}");
                        Console.WriteLine($"  Name: {item.Name}");
                        Console.WriteLine($"  Exchange: {item.Exchange}");
                        Console.WriteLine($"  Type: {item.Type} / {item.SubType}");
                        Console.WriteLine($"  Open:  {item.O}");
                        Console.WriteLine($"  High:  {item.H}");
                        Console.WriteLine($"  Low:   {item.L}");
                        Console.WriteLine($"  Close: {item.C}");
                        Console.WriteLine($"  Ask:   {item.A}");
                        Console.WriteLine($"  Bid:   {item.B}");
                        Console.WriteLine($"  Time:  {item.T}");
                        Console.WriteLine("------------------------");
                    }
                }
                else
                {
                    Console.WriteLine("Invalid or empty response.");
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine("Error: " + ex.Message);
            }
        }
    }

    public class ApiResponse
    {
        public bool Status { get; set; }
        public int Code { get; set; }
        public string Msg { get; set; }
        public List Response { get; set; }
    }

    public class SymbolData
    {
        public string Symbol { get; set; }
        public string Name { get; set; }
        public string Exchange { get; set; }
        public string Type { get; set; }
        public string SubType { get; set; }
        public double O { get; set; }
        public double H { get; set; }
        public double L { get; set; }
        public double C { get; set; }
        public double A { get; set; }
        public double B { get; set; }
        public long T { get; set; }
    }
}

<?php
$url = "https://api-v4.fcsapi.com/forex/latest?symbol=ONA:EURUSD,BINANCE:BTCUSD&access_key=API_KEY";
$response = file_get_contents($url);
$data = json_decode($response, true);

foreach ($data['response'] as $item) {
    echo "Symbol: " . $item['symbol'] . "\n";
}
?>

require 'net/http'
require 'json'

url = URI("https://api-v4.fcsapi.com/forex/latest?symbol=ONA:EURUSD,BINANCE:BTCUSD&access_key=API_KEY")
res = Net::HTTP.get_response(url)
data = JSON.parse(res.body)

data["response"].each do |item|
  puts "Symbol: #{item["symbol"]}"
end

Disclaimer & Terms of Use

Important information about data usage, accuracy, and limitations of the FCS API service.

Data Accuracy & Usage

Prices, Market trends and signals are not designed for trading purposes. These signals are only for educational or non-commercial purpose use. Data contained in this application/website is not necessarily real-time nor accurate and so prices may not be accurate and may differ from the actual market price, meaning prices are indicative and not appropriate for trading purposes.

Trading Disclaimer

Therefore we don't bear any responsibility for any trading losses you might incur as a result of using this data. Latest price minimum refresh rate is 30 seconds.

Data Sources

Our data is sourced from multiple financial institutions and exchanges. While we strive for accuracy, we cannot guarantee 100% accuracy or completeness of the data.