FCS Stock API

Get Started

The FCS Stock API is designed for fast and easy integration with any programming language. Make HTTP requests to our API endpoints and receive responses in standard JSON format. Compatible with JavaScript (Ajax/Fetch), PHP (cURL or file_get_contents), Python (requests), Java/Android (HttpURLConnection), C# (HttpClient), Node.js (axios), and command-line tools like cURL.

Get up and running with the FCS Stock API in just 3 simple steps. Our API provides real-time and historical stock data for 25,000+ stocks from 30+ countries.

Step 1: Get Your API Key

Sign up for a free account and get your API key instantly. No credit card required for testing - start with 500 free requests per month.

Step 2: Make Your First Request

Test the API with a simple GET request to fetch the latest Apple stock price:

Step 3: Integrate & Build

Use the response data in your application. All responses are in JSON format with consistent structure across all endpoints.

Parameters List

Exchange Coverage & Data Sources

Our Stock API aggregates market data from 50+ global exchanges across 30+ countries, providing access to over 130,000 listed stocks and 500+ market indices. View real-time coverage statistics and exchange details to choose the best data sources for your trading or analytics applications.

Response Format

Stock Index List

Retrieve a complete list of supported stock market indices for any country. Use the returned index IDs with the Stock List API to get all stocks within a specific index. Simply provide a country name to get all available indices for that market.

Response Format

{
    "update_mode": "streaming",
    "fractional": "false",
    "curr_logo": "link",
    "market": "america",
    "currency_desc": "U.S. dollar",
    "minmov": 1,
    "pricescale": 100,
    "base_currency": null,
    "base_id": "nasdaq-100",
    "exc_logo": "logo link",
    "country": "US"
}

All Supported Stocks List

Get all supported stocks meta information for your selected country, sector, or index. The response provides market meta details, sector, region, currency, price scale, and index memberships. Use this list to find valid stocks for other API endpoints.

Response Format

{
    "update_mode": "delayed_streaming_900",
    "fractional": "false",
    "curr_logo": "https:fcsapi.com/assets/logos/country/US.svg",
    "sector": "Electronic Technology",
    "region": "United States",
    "market": "america",
    "currency_desc": "U.S. dollar",
    "minmov": 1,
    "pricescale": 100,
    "indexes": [
        {
            "name": "S&P 500",
            "proname": "SP:SPX"
        },
        {
            "name": "NASDAQ 100",
            "proname": "NASDAQ:NDX"
        },
        {
            "name": "Dow Jones Industrial Average",
            "proname": "DJ:DJI"
        }
    ]
}

Stock Profile Details

Retrieve detailed company profile information for one or more stocks using their symbol or ID. The response includes key details such as sector, industry, employee count, ISIN codes, headquarters location, and more. This data is essential for fundamental analysis and due diligence.

Response Format

{
    "description": "Apple Inc. engages in ...",
    "country_code": "US",
    "isin": "US0378331005",
    "timezone": "America/New_York",
    "total_employees": 164000,
    "founded": 1976,
    "headquarters": "Cupertino",
    "region": "CA",
    "sector": "Electronic Technology",
    "industry": "Telecommunications Equipment",
    "trading_hours": {
        "regular": {
            "description": "Regular Trading Hours"
        },
        "extended": {
            "description": "Extended Trading Hours"
        }
    }
}

Stock Latest Price API

Access real-time and delayed stock price data for global markets with the FCS Stock API. Receive the latest open, high, low, close, volume, and percentage change for one or multiple stocks. JSON API updates every 1-2 minutes, while socket API delivers live streaming prices. For select stocks, price updates may be delayed up to 15 minutes due to exchange regulations. Ideal for financial dashboards, portfolio management, and market analysis applications.

Response Format

{
    "active": {
        "o": 256.805,
        "h": 257.4,
        "l": 255.43,
        "c": 256.48,
        "v": 31955689,
        "t": 1759843800,
        "vw": 256.437,
        "tm": "2025-10-07 13:30:00",
        "ch": -0.325,
        "chp": -0.127
    },
    "profile": {
        "symbol": "AAPL",
        "exchange": "NASDAQ",
        "currency": "USD",
        "name": "Apple Inc.",
        "type": "stock",
        "sub_type": "common",
        "curr_logo": "country/US",
        "exc_logo": "exchange/nasdaq"
    }
}

Stock Market Indices Prices

Access the latest prices for global stock market indices with the FCS Stock API. Instantly retrieve real-time and delayed index values, including open, high, low, close, volume, and percentage change. Easily monitor major indices such as S&P 500, NASDAQ, Dow Jones, FTSE 100, and more. Our API supports bulk requests for multiple indices, enabling seamless integration into financial dashboards, trading platforms, and market analysis tools. Simply provide one or more index IDs in your API request to get comprehensive, up-to-date market data.

Response Format

{
    "ticker": "NASDAQ:OFIN",
    "update": 1759778092,
    "updateTime": "2025-10-06 19:14:52",
    "active": {
        "o": 14952.42,
        "h": 14952.84,
        "l": 14719.61,
        "c": 14765.46,
        "v": null,
        "t": 1759757400,
        "vw": 14812.64,
        "tm": "2025-10-06 13:30:00",
        "ch": -186.96,
        "chp": -1.25
    },
    "profile": {
        "symbol": "OFIN",
        "exchange": "NASDAQ",
        "currency": "USD",
        "name": "Nasdaq Real Estate and Other Financial Services",
        "type": "index",
        "sub_type": "main",
        "curr_logo": "country/US",
        "exc_logo": "exchange/nasdaq",
        "self_logo": "index/NASDAQ:OFIN"
    }
}

Historical Price API

Access comprehensive historical price data for both stocks and market indices with the FCS Stock API. Easily compare current and past prices, analyze market trends, and backtest strategies using years of historical data. The same API endpoint supports both stocks and indices, allowing you to retrieve OHLCV data for any supported symbol or index. Data is available from 1995 for most assets, with flexible timeframes including intraday, daily, weekly, and monthly intervals.

Response Format

{
    "1722519000": {
        "o": 224.37,
        "h": 224.48,
        "l": 217.02,
        "c": 218.36,
        "v": 62500996,
        "vw": 219.953,
        "t": 1722519000,
        "tm": "2024-08-01 13:30:00"
    }
}

Stock Earnings Data

Get comprehensive earnings data including EPS (Earnings Per Share) and revenue figures for stocks. Data includes both historical actuals and future estimates, organized by fiscal year (FY) and fiscal quarter (FQ).

Response Format

Stock Revenue Segmentation Data

Get detailed revenue breakdown by business segments and geographic regions. Includes historical data showing how revenue is distributed across different product lines and markets.

Response Format

Stock Forecast

Get price target forecasts and aggregated analyst estimates for a given stock. This endpoint returns high, average, median and low price targets computed from available analyst reports and internal models.

Response Format

{
    "NASDAQ:AAPL": {
        "ticker": "NASDAQ:AAPL",
        "forecast": {
            "price_target_high": [
                {
                    "id": "price_target_high",
                    "name": "Price target high",
                    "group": "",
                    "data": 310
                }
            ],
            "price_target_average": [
                {
                    "id": "price_target_average",
                    "name": "Price target average",
                    "group": "",
                    "data": 251.242927
                }
            ],
            "price_target_median": [
                {
                    "id": "price_target_median",
                    "name": "Price target median",
                    "group": "",
                    "data": 250
                }
            ],
            "price_target_low": [
                {
                    "id": "price_target_low",
                    "name": "Price target low",
                    "group": "",
                    "data": 180
                }
            ]
        }
    }
}

Stock Dividends & Yields

Retrieve current and historical dividend information — payment dates, amounts, yield percentages, and frequency — for a given stock by ID or symbol.

Response Format

{
    "ticker": "NASDAQ:AAPL",
    "dividends": {
        "dividend_payout": [
            {
                "ex-date": 1754913540,
                "record-date": 1754913540,
                "payment-date": 1755172740,
                "amount": 0.26,
                "type": "quarterly"
            }
        ]
    },
    "fq": {
        "2025-06-30": {
            "dps_common_stock_prim_issue": 0.26,
            "dividend_payout_ratio": 16.5848057664094
        }
    },
    "fy": {
        "2024-09-30": {
            "dps_common_stock_prim_issue": 0.98,
            "dividends_yield": 0.430220817419553
        }
    }
}

Stock Balance Sheet Data

Retrieve current and historical balance sheet statements for a given stock. Supports both annual and interim (quarterly) periods.

Stock Income Statement Data

Fetch income statement data including revenues, costs, and net income for annual and interim periods.

Stock Statistics API

Get key stock statistics and financial ratios useful for valuation and comparative analysis. Returns valuation metrics, profitability ratios, liquidity and leverage ratios as well as efficiency and margin indicators.

Stock Cash Flow Statement Data

Access detailed cash flow statement data including operating, investing, and financing activities, along with derived cash flow metrics for annual and interim periods. The cash flow endpoint returns operating cash flow, funds from operations, investing activities, financing activities, depreciation & amortization, changes in working capital, and other cash flow line items. Use the duration parameter to switch between annual and quarterly reporting. The response may include derived metrics such as free cash flow when available.

Combined Financials API

Fetch multiple financial endpoints in a single API call by passing comma-separated endpoint names in the data_column parameter. This reduces round-trips and is useful when you need several financial datasets for the same symbol at once.

Advanced Stock Query API

(ALL IN ONE) The Advanced Stock Query API combines multiple stock data sources and offers flexible filtering, sorting, pagination and multi-API merging. Use it to retrieve real-time prices, company profiles, performance metrics and technical indicators in a single request — ideal for dashboards, scanners and research tools.

POST/RAW JSON both accepted
{ 
    "symbol":"NASDAQ:AAPL,NYSE:TSLA",  // EXCHANGE:SYMBOL
    "exchange":"NASDAQ,NYSE", // return data from specific exchanges 
    "type":"stock", // stock,index 
    "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":{"c_gt":1}, // range filter 
    "sort_by":"c_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 stocks. You can sort results easily using simple sorting parameters. This allows you to fetch Top Gainers, Losers, Most Active by Volume, or Highest by Market Price without needing 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": "stock", // stock,index
    "sub_type": "common", // common,preferred
    "symbols": "",
    "exchange": "NASDAQ", 
    "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 response to 20 results only.
    "access_key": "YOUR_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 investors, analysts, and developers evaluate short-term and long-term stock trends using reliable market indicators. You can easily integrate these signals into dashboards, charting tools, or algorithmic trading systems.

{
    "type": "stock",
    "symbols": "AAPL,MSFT",
    "exchange": "NASDAQ",
    "period": "1d",
    "access_key": "YOUR_API_KEY"
}

Response Format

{
    "signal": {
        "summary": "STRONG_BUY",
        "score": 68,
        "confidence": "MEDIUM",
        "trend": "STRONG",
        "volatility": "LOW"
    },
    "ma_avg": {
        "ema10": {
            "v": 187.25,
            "s": "Buy",
            "n": "EMA 10",
            "score": 40
        },
        "ema25": {
            "v": 185.9,
            "s": "Buy",
            "n": "EMA 25",
            "score": 50
        }
    }
}

Stock Technical Indicators API

The Stock Technical Indicators API provides detailed calculations of popular technical and oscillator indicators such as RSI, MACD, Stochastic, Bollinger Bands, and more. Analyze real-time market trends, volatility, and price momentum for individual stocks or multiple symbols.

{
    "type": "stock",
    "symbols": "AAPL,MSFT",
    "exchange": "NASDAQ",
    "period": "1d",
    "access_key": "YOUR_API_KEY"
}

Response Format

{
    "ticker": "NASDAQ:AAPL",
    "signal": {
        "summary": "BUY",
        "score": 61.2,
        "confidence": "MEDIUM",
        "trend": "STRONG",
        "volatility": "LOW"
    },
    "indicators": {
        "volatility": {
            "atr_per": 0.94,
            "true_range": 2.34,
            "level": "Low"
        },
        "bollinger": {
            "width_per": 2.81,
            "pos_per": 62.45,
            "middle": 184.32,
            "squeeze": "No Squeeze"
        },
        "price_action": {
            "body_size": 2.15,
            "shadow_u": 1.02,
            "shadow_l": 0.98,
            "body_range_per": 45.2,
            "c_type": "Bullish",
            "pattern": "Normal"
        }
    },
    "oscillators": {
        "rsi": {
            "v": 56.7,
            "s": "Buy",
            "n": "RSI",
            "score": 25
        },
        "stoch": {
            "v": 64.5,
            "s": "Neutral",
            "n": "Stochastic",
            "score": 0
        },
        "macd": {
            "v": 1.42,
            "s": "Buy",
            "n": "MACD",
            "score": 25
        }
    }
}

Stock Pivot Points API

The Stock Pivot Points API provides precise support and resistance levels for individual stocks, calculated using multiple industry-standard pivot point formulas. These levels help traders identify intraday reversal zones, entry/exit levels, and overall market sentiment. Supported calculation methods include Classic, Fibonacci, Camarilla, Woodie, and Demark.

{
    "type": "stock",
    "symbols": "AAPL,MSFT",
    "exchange": "NASDAQ",
    "period": "1d",
    "access_key": "YOUR_API_KEY"
}

Stock Performance API

Provides detailed stock performance metrics such as historical highs/lows, percentage returns over multiple timeframes, and volatility ratios. Useful for equity research, technical evaluation, and risk-based portfolio management.

Response Format

{
    "H1M": 189.44,
    "L1M": 171.95,
    "H3M": 199.12,
    "L3M": 163.42,
    "H6M": 206.89,
    "L6M": 152.27,
    "H52": 206.89,
    "L52": 142.68,
    "HIGHEST": 206.89,
    "LOWEST": 0.51,
    "PW": 2.13,
    "P1M": 5.27,
    "P3M": 7.84,
    "P6M": 12.45,
    "PYTD": 18.62,
    "PY": 23.11,
    "P5Y": 184.33,
    "PAll": 1152.67,
    "voltD": 1.38,
    "voltW": 2.04,
    "voltM": 2.98
}

Search API

Search for any stock by company name, ticker symbol, or partial match. The search query checks both full company names and short ticker symbols. Returns up to 20 matching results.

Response Format

{
    "id": 1287,
    "name": "General Electric",
    "short_name": "GE",
    "full_name": "General Electric Company",
    "type": "stock",
    "country": "United States",
    "locality": "Boston",
    "exch": "NYSE",
    "ccy": "USD"
}

Country Report

Get a comprehensive market report showing stock distribution by country, exchange, and sector. Use this API to retrieve country names, exchange names, and see how many stocks are available in each category.

Response Format

{
    "country": {
        "united-states": 6
    },
    "exchanges": {
        "NYSE": 3,
        "NASDAQ": 2
    }
}

Multiple URL Requests

Execute multiple API endpoints in parallel to save time. Instead of calling APIs sequentially (10 APIs x 2 seconds = 20 seconds), this endpoint fetches all results simultaneously in just 2 seconds. Perfect for dashboards, portfolio tracking, and bulk data processing.

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/stock/latest?symbol=EURUSD&access_key=YOUR_API_KEY"

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

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

// 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/stock/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/stock/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/stock/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/stock/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.