Comprehensive Guide to FCS Real-Time Cryptocurrency API

·

The FCS Crypto API provides a powerful gateway to real-time and historical cryptocurrency data. Supported by over 35 cryptocurrency exchange data sources, it delivers accurate rates for more than 1,500 cryptocurrencies and 5,000+ coin combinations. This robust API solution enables developers and traders to access the latest crypto prices, retrieve historical data, analyze market trends with technical indicators, and check supply details across various timeframes.

Understanding API Request Credits

All API endpoints count as 1 credit for each URL request, with four specific endpoints counting 1 credit per 100 records returned. The Free Plan allows users to make 500 requests per month.

Essential API Parameters

To effectively utilize the FCS Crypto API, understanding its parameters is crucial for successful data retrieval.

Required Parameters

access_key (required): Your unique authentication key that must be included in every API call to validate access permissions. Valid value: API_KEY

symbol (required): Defines the currency or cryptocurrency symbol you want information about, using standard 3-letter codes. At least one "id" or "symbol" parameter is required. Valid values include any valid short name or "all_crypto" to get data for all crypto pairs at once.

Optional Parameters

type (optional): Specifies which financial market segment to query - traditional forex or cryptocurrency markets. Default: forex. Valid values: forex, crypto

id (optional): An alternative to the symbol parameter, using the currency's unique ID in the system, particularly useful when symbols might be ambiguous.

pair (optional): Allows specification of a specific currency pair for exchange rate information, requiring both parts of the pair for correct operation.

from and to (optional): Set start and end dates for historical data queries, working together to establish a complete time period. Multiple date formats are supported including YYYY-MM-DD, Unix timestamp, and YYYY-MM-DDTHour:Min.

period (optional): Defines the time interval for requested data, from minute-by-minute to monthly timeframes. Default: 1h. Valid values include 1m, 5m, 15m, 30m, 1h, 2h, 4h, 5h, 1d, 1w, month.

output (optional): Controls the response format. Default: json. Valid values: json, jsonp, object, xml, serialize, array.

👉 Explore advanced API integration methods

Getting Started with FCS API

The FCS API is designed to simplify access to cryptocurrency data, providing responses in JSON format for seamless integration. Every API request returns data in a standard JSON structure that can be easily converted to other formats if needed.

API Access Key

To use the crypto API, users must obtain an API key upon registration. Each user receives a unique access key for authentication, which must be included in the base URL's access_key parameter.

Important Notes:

Core API Endpoints

Crypto Symbols List

The Crypto Symbol List contains abbreviated coin name combinations essential for data visualization. Users can access all available crypto IDs directly from the database with historical and real-time data in JSON format.

Parameters: access_key, type, output

API Endpoint:

https://fcsapi.com/api-v3/crypto/list?type=crypto&access_key=API_KEY

Response Attributes: status, code, msg, response array containing id, name, symbol, decimal, and info with server_time and credit_count.

Crypto Coin Profile Details

This endpoint provides comprehensive cryptocurrency details including currency name, origin country, associated bank, and multiple indexed data points using crypto ID.

Request Credit Usage: 1 credit per 100 records returned (rounded up)

Parameters: access_key, symbol, id, output

Sample Request by ID:

https://fcsapi.com/api-v3/crypto/profile?id=78,79,80&access_key=API_KEY

Crypto Currency Converter API

The currency converter facilitates price exchanges between two selected currencies by connecting the Crypto API request with the symbols parameter.

Important Note: This API doesn't support multiple crypto symbols in URL - use only one Symbol name per request.

Parameters: access_key, symbol, pair, amount, output

Sample Request:

https://fcsapi.com/api-v3/crypto/converter?symbol=BTC/USD&amount=200&access_key=API_KEY

Crypto Latest Price API

Delivers up-to-the-minute market prices that update every 30 seconds to 1 minute. Users can fetch prices for multiple currencies simultaneously by specifying currency ID or symbol code.

Request Credit Usage: 1 credit per 100 records returned (rounded up)

Parameters: access_key, symbol, id, output

Sample Request for All Prices:

https://fcsapi.com/api-v3/crypto/latest?symbol=all_crypto&access_key=API_KEY

Historical Data and Advanced Features

Historical Price API

Essential for comparing current market trends with historical data, this API offers comprehensive historical exchange data for specific symbols, with some data dating back to 1995.

Request Credit Usage: 1 credit per 300 candles returned (rounded up)

Parameters: access_key, symbol, id, period, from, to, level, output

Quick Latest 300 Candles:

https://fcsapi.com/api-v3/crypto/history?id=78&period=1d&access_key=API_KEY

Market Cap and Supply Data

This API delivers real-time market data including market cap, max supply, circulating supply, and 24-hour total volume, updating every 5-15 minutes.

Request Credit Usage: 1 credit per 100 records returned (rounded up)

Parameters: access_key, symbol, id, convert, sort, order, start, limit, output

Sample Request with Sorting:

https://fcsapi.com/api-v3/crypto/cross?id=78,79&sort=rank&limit=50&access_key=API_KEY

Technical Analysis Tools

Pivot Points API

Provides key indicators highlighting high, low, support, and resistance prices for the current trading day, enabling calculation of pivot points in cryptocurrency trading.

Parameters: access_key, symbol, id, period, output

Sample Request:

https://fcsapi.com/api-v3/crypto/pivot_points?id=78&period=1d&access_key=API_KEY

Moving Averages API

Delivers real-time moving average values derived from previous candles (5, 10, 20, 50, 100, 200) to inform buying and selling decisions.

Parameters: access_key, symbol, id, period, output

Sample Request:

https://fcsapi.com/api-v3/crypto/ma_avg?symbol=XRP/USD&period=1h&access_key=API_KEY

Technical Indicator API

Provides fresh values for leading technical indicators like RSI, STOCH, ATR, and others, delivering essential data for market analysis.

Parameters: access_key, symbol, id, period, output

Sample Request:

https://fcsapi.com/api-v3/crypto/indicators?symbol=XRP/USD&period=1h&access_key=API_KEY

Utility Endpoints

Search API

Enables currency search with similar words, searching through full names and short names, returning up to 20 results.

Parameters: access_key, s, strict, type, output

Sample Request:

https://fcsapi.com/api-v3/crypto/search?s=BTC Dollar&access_key=API_KEY

Multiple URL API

Allows calling multiple API endpoints simultaneously, significantly reducing processing time for multiple requests.

Parameters: access_key, base, url[]

Sample Request:

https://fcsapi.com/api-v3/crypto/multi_url?base=api-v3/crypto/&url[candle]=candle?symbol=BTC/USD&period=1h&url[history]=history?symbol=BTC/USD&period=1h&access_key=API_KEY

👉 Access real-time cryptocurrency data tools

Frequently Asked Questions

What is the minimum refresh rate for latest prices?
The latest price data has a minimum refresh rate of 20 seconds, ensuring you receive timely market information for accurate decision-making.

How can I reduce my API request usage?
You can reduce API requests by setting multiple IDs or symbols in a single URL call, efficiently retrieving multiple cryptocurrency data points at once rather than making individual requests.

What formats does the API support for responses?
The API supports multiple response formats including JSON (default), JSONP, object, XML, serialize, and array, allowing flexibility for different integration needs and programming languages.

How does credit counting work for different endpoints?
Most endpoints count 1 credit per URL request, but four specific endpoints (Latest Price, Candle, Profile, and Supply APIs) count 1 credit per 100 records returned, with rounding up to the nearest hundred.

Can I get historical data for multiple cryptocurrencies simultaneously?
For historical data, you can only request one ID or symbol at a time through the history API, but you can use the Multiple URL API to efficiently gather historical data for multiple cryptocurrencies in parallel requests.

What time periods are available for technical analysis?
The API supports various timeframes from 1 minute to monthly periods, including 1m, 5m, 15m, 30m, 1h, 2h, 4h, 5h, 1d, 1w, and month, catering to different trading strategies and analysis needs.

Important Disclaimer

Prices, market trends, and signals provided by the FCS API are not designed for trading purposes. These signals are intended for educational or non-commercial use only. Data contained in this application/website is not necessarily real-time nor accurate, and prices may differ from actual market prices. The information is indicative and not appropriate for trading purposes. Therefore, FCS doesn't bear any responsibility for any trading losses incurred as a result of using this data.