Crypto API Documentation
FCS API
Powered by 35+ Crypto coin exchange data sources, the FCS API delivering real-time Crypto 1500+ currencies and 5000+ coins combination rates. We provides different API endpoints, each one is serving a different data response. FCS provides the latest Crypto price for all or a specific pair of crypto, retrieving historical coin rates data for one or multiple coins, technical indicators, moving averages for market analyzing, supply details from 5min to 1 month.
In this document, you will learn how to use API with its parameters, potential unwanted errors and some code examples. After this document, if you face difficulty to understand API structure, you can contact us any time and our team will be happy to help out.
Get Started
Hello World,
FCS API is the platform which has been designed to resolve all the problems of the users and the developers, Who face trouble in getting Cryptocurrency API. Here we provide almost all of the tools related to Crypto. In this documentation, we have discussed all the parameters and providing almost all the response in JSON format, Because 90% developer want in JSON API format for their project. Here we provide all requests response in Standard JSON format, which can be changed into another format. In order to use our services users can select any programming language to send request on API URL.
API Access Key
In order to access our API, users need an API key after signup. For the purpose of crypto API, the user’s Access key is unique that authenticate with the FCS API after passing it into the base URL’s access_key parameter. In Users can understand the API structure, code examples, method, and potential errors through this documentation.
Note: Maximum 10 URL hits allow per minute for single IP. Please set multiple ids or symbols in the URL to reduce API requests. You can make your work efficient by getting multiple crypto data at once. If you need more Request/minute please contact us.
Sample API:
https://fcsapi.com/api/crypto/latest?id=78&access_key=API_KEYFree Sign up to get an API ACCESS KEY using the button below.
Signup
Parameters
| Parameters | Details |
|---|---|
| ID | In order to get a response for a specific Crypto API data, you need to set Crypto-ID in a URL parameter. Default: none. Values: 1,2,3... etc, You need to use “List API” to get all of the Crypto IDs or symbols List |
| Symbol | To get the data of specific Crypto from our database to use our API, you have to use a specific symbol or short name of crypto to get its response. Default: none Values: BTC/USD,ETH/JPY,ETC/USD etc, Note: You needs one ID or Symbol to set in API parameter. The symbol parameter would be ignored if their Id parameter is present in the URL. They have to use any parameter, that would be the Symbol or ID, and the result obtained by them will be the same. |
| Period | When you are looking for candle price, History, Signals, Pivot point and Average Line, for this you required to use in few crypto ids and you just have to indicate the time frames data which you want. Default: 1h Valid Values: 5m, 15m, 30m,1h, 5h, 1d, 1w, month OR Alternate: 5, 15, 30,60, 300, 1440, 10080, 43200 |
| From (Optional) | It is very important for you when you want to look after historical data from any date and willing to access any history of crypto. In that manner, you just need to use (from, to) parameter to indicate the date through From/To. Default: none Format: YYYY-MM-DD E.g: 2018-01-01 OR YYYY-MM-DDTHour:Min E.g: 2018-01-01T12:30 |
| To (Optional) | When you are looking for Crypto API history Access. It is required with "From" Parameter. Default: none Format: YYYY-MM-DD E.g: 2018-01-31 OR YYYY-MM-DDTHour:Min E.g: 2018-01-31T12:30 Note: When you not pass FROM/TO in URL, then history will return the latest 300 candles. T in date format is just use to remove space between date and time. It has no usage and no validation. |
| Type (Optional) | It is necessary for developers when you need a specific type of symbols for a Cryptocurrency then you need to use “list API”. Default: both Values: Forex, Crypto or both |
| Convert | Its use to convert USD price into other specific currencies. In order to convert BTC into other Currency, you prefer this parameter for conversion. Default: none. Values: USD,EUR,JPY,BTC,XRP etc, Note: Currently it is only support in "Crypto Supply API" |
| Output (Optional) | You can change the crypto API response format. Default: JSON Valid Values: JSON, JSONP, object, XML, serialize and array |
Crypto Symbols List
Crypto symbol list is a list of two (2) short coins name combination. To display the lines, points, and polygon on the specific graphic’s layer in crypto you have to use symbols. You can get the response of all available crypto ids from our Database. Here we mentioned all the historical and real-time access in JSON format, which uses an easy and get all the supported cryptocurrencies names. Moreover, we provide constantly update regarding crypto API endpoint which shows all the real-time currencies.
Accepted Parameters:
type = crypto
top_symbol = 0 OR 1
access_key=API_KEY
We provide a huge collection of crypto symbols, so you can easily use Free Crypto API to get the latest price, price converter, historical and technical signals.
https://fcsapi.com/api/crypto/list?type=crypto&access_key=API_KEYPopular Symbols List:
When of top_symbol=1, It will give you response of top crypto currencies. API "latest candle" only accepts top crypto ids. When top_symbol=0 it will return all cryptocurrencies.
https://fcsapi.com/api/crypto/list?type=crypto&top_symbol=1&access_key=API_KEYResponse:
{
"id": 1,
"name": "Bitcoin US Dollar",
"symbol": "BTC/USD",
"decimal": 4
},
{
"id": 2,
"name": "Ethereum US Dollar",
"symbol": "ETH/USD",
"decimal": 4
},
{5000+ More Crypto Currencies} Crypto Coin Profile Details
Here user can reach the details related to the cryptocurrencies. Detail includes currency’s name, country, bank name, etc
You can utilize different currencies’ profiles through their crypto ID in order to get a response including several index keys.
Accepted Parameters:
id={any valid Crypto ID}
symbol={any valid Crypto short name}
access_key=API_KEY
https://fcsapi.com/api/crypto/profile?id=78,79,80&access_key=API_KEYBy Symbol Combination:
https://fcsapi.com/api/crypto/profile?symbol=BTC/USD,ETH/USD,XRP/USD&access_key=API_KEYBy Currency Short Name:
https://fcsapi.com/api/crypto/profile?symbol=BTC,ETH,XRP,LTC&access_key=API_KEYResponse:
{ //Crypto Currency Profile
"slug" : "bitcoin",
"name" : "Bitcoin",
"symbol" : "BTC",
"category" : "coin",
"short_name" : "BTC",
"website" : "https://bitcoin.org/",
"icon" : "https://fcsapi.com/assets/images/coin/btc.svg",
"urls" : {
"technical_doc" : "https://bitcoin.org/bitcoin.pdf",
"twitter" : "https://twitter.com/Bitcoin",
"reddit" : "https://reddit.com/r/bitcoin",
"announcement" : "https://news.bitcoin.com/category/announcements",
"source_code" : https://github.com/bitcoin/
},
"type": "crypto"
}, {and more} Crypto Currency Converter
Currency converter plays a very important role in the price conversation because the user needs a conversion between two specified currencies. For this purpose you just have to link the Crypto API request through the symbols parameter in URL.
Note: Below API doesnt support multiple crypto symbols in URL. Use only one ID OR Symbol name for each request.
Accepted Parameters :
pair1 = BTC & pair2 = USD (Use both at a time) OR
symbol = BTC/USD
amount = 200
access_key = API_KEY
Note: It is also support all forex currencies ids or symbols.
https://fcsapi.com/api/crypto/converter?symbol=BTC/USD&amount=200&access_key=API_KEYCurrency Converter example 2:
https://fcsapi.com/api/crypto/converter?pair1=BTC&pair2=USD&amount=200&access_key=API_KEYConversation by ID:
https://fcsapi.com/api/crypto/converter?id=78&amount=200&access_key=API_KEYResponse:
{
"price_1x_BTC": "5.04E-5", // 1 BTC = USD
"price_1x_USD": "19826", // 1 USD = BTC
"total": "3965200" // Total Price x amount (Amount * 1 USD) = Total (USD)
}, Latest Price
The user who is a concern with crypto API. It is necessary for them to have the latest price data anytime. We provide a current market latest price which you can easily access. However, you can see multiple currency prices at a time, for this you just have to set the currency’s id order symbol code in the API’s parameters.
Note: Prices update in every 30 seconds.
Accepted Parameters :
id = {Any valid Crypto ID}
symbol = {Any valid Crypto symbol}
access_key = API_KEY
https://fcsapi.com/api/crypto/latest?id=78&access_key=API_KEYMultiple prices by ids:
https://fcsapi.com/api/crypto/latest?id=78,79,80,81,82&access_key=API_KEYMultiple prices by name:
https://fcsapi.com/api/crypto/latest?symbol=BTC/USD,ETH/USD,LTC/USD&access_key=API_KEYResponse:
{
"symbol": "BTC/USD",
"price": "7,124.2", // Price
"change": "98.1", // Change in 1 day candle
"change_per: "1.36%", // Change in percentage
"last_changed": "2019-11-27 12:30:00" // When price changed last time
},
{
"symbol": "ETH/USD",
"price": "147.51", // Price
"change": "0.45", // Change in 1 day candle
"change_per: "-0.30%", // Change in percentage
"last_changed": "2019-11-27 12:30:00" // When price changed last time
},
{and more}Last Candle Prices (Open,High,Low,Close)
Here all the latest candles of the crypto are present for the users which are mandatory to them in analyzing the cryptocurrency trading. You just has to make the connection between request and the parameter of FCS API’s symbol in order to see the candle price, you can discover single or multiples candles at the same time.
Note : As we discussed in the above “All Symbol list” API that in order to get Last Candle’s API you first have to get TOP IDs/Symbols of cryptocurrency. Below request only return response on ids of top cryptocurrency.
Accepted Parameters :
id = {Any popular Crypto ID}
symbol = {Any popular Crypto symbol}
period = {Currency time period}
access_key = API_KEY
https://fcsapi.com/api/crypto/candle?id=78&period=1h&access_key=API_KEY
https://fcsapi.com/api/crypto/candle?id=78,79,80&period=1h&access_key=API_KEYBy Symbol Name:
https://fcsapi.com/api/crypto/candle?symbol=BTC/USD&period=1h&access_key=API_KEY
https://fcsapi.com/api/crypto/candle?symbol=BTC/USD,ETH/USD,LTC/USD&period=1h&access_key=API_KEYResponse:
{
"symbol": "BTC/USD", // 1 Hour Candle
"candle": {
"o": "19355", // Open
"h": "19946", // High
"l": "19355", // Low
"c": "19826", // Close
"t": 1665712800000, // Unix Time (UTC) (Candle Time)
"tm": "2022-10-14 02:00:00" // Date Time (UTC) (Candle Time)
}
},
{
"symbol": "",
"candle": {
"o": "",
"h": "",
"l": "",
"c": "",
"t": ,
"tm": ""
}
},
{and more}Historical Price API
It is an important part for the users to know about the history and historical prices of the coin market, which helps them to compare the current market with the previous market, which makes it easy to analyze. We provide all the historical data of the exchange price for a specific symbol. You can discover all the previous rates from the year 1995 for most of the symbol and through the FCS API URL you can easily get historical rates which append a date in the format of (YYYY-MM-DD) for the specified period of time (5m, 30m, 1h, 5h, 1d, 1w, month).
Accepted Parameters :
id = {Any valid Crypto ID}
symbol = {Any valid Crypto symbol}
period = {Currency time period}
from = {History date from} & To = {date to} (Use both at a time or ignore both for latest)
access_key = API_KEY
You have to keep it in your mind, if you are looking for the latest history, we should not have to assign the “From/To” parameter. It will best and fast response.
Note: In the URL multiple IDs do not support, Through the API request only one ID or symbol you can send at a time.
Here you can see the history of the previous 300 candles through the latest API URL which helps you to predict the market and analyze the current market with respect to these candles. So, you will not face any trouble when you are going to guess the real-time market by keeping the latest candles.
https://fcsapi.com/api/crypto/history?id=78&period=1h&access_key=API_KEY
https://fcsapi.com/api/crypto/history?symbol=BTC/USD&period=1h&access_key=API_KEYFor Graphic Charts
Specially develop to use in HTML/JS graphs.
https://fcsapi.com/api/crypto/history?symbol=BTC/USD&period=1h&access_key=API_KEY&chart=1History Between Specific Date {YYYY-MM-DD}
You can easily get the historical exchange rate for the specific time period between the two specified dates for all the symbols which are available through the parameter of “From/To”. There are two symbols separated by a slash between them. And for the specific time period, you can see the exchange rate historical data.
https://fcsapi.com/api/crypto/historyOr Between Specific Date-Time
?symbol=BTC/USD
&period=1d
&from=2023-10-01
&to=2024-04-23
&access_key=API_KEY
https://fcsapi.com/api/crypto/history?symbol=BTC/USD&period=1d&from=2023-10-01T12:00&to=2024-04-23T12:00&access_key=API_KEYResponse:
The response will be seemed by this crypto API in terms of index keys of (o, h, l, c, t,tm ). these index keys show the open, high, low and close parameters in crypto for such a different historical candle.
{
"symbol": "BTC/USD",
"candle": {
"o": "19355", // Open
"h": "19946", // High
"l": "19355", // Low
"c": "19826", // Close
"t": 1665712800000, // Time Unix Format (UTC)
"tm": "2022-10-14 02:00:00" // Date Time (UTC)
},
{and 300 more historical candles},
} Coin Market Cap API
Crypto market cap, demand and supply is the most important factor in any coin market which investors have to keep in their mind before investing in. There are some cryptos having an infinite supply and market cap which means for a certain fixed number. If you want to see the coinmarketcap for one or more coins in the latest time so you can use our cryptocurrency market cap API mentioned below. Through this API, users can get familiar with the accurate time of data update in coin cap market which includes market_cap, max_supply, circulating_supply and totalvolume of 24 hours which would be helpful for the developers.
Accepted Parameters :
id = {Any valid Crypto ID}
symbol = {Any valid Crypto symbol}
convert = {Currency name to convert into price} e.g: USD,EUR, BTC,LTC,XRP,ETH
access_key = API_KEY
https://fcsapi.com/api/crypto/supply?symbol=BTC,XRP&convert=USD&access_key=API_KEYSupply by ID's'
https://fcsapi.com/api/crypto/supply?id=78,80&convert=USD&access_key=API_KEYResponse:
After using the crypto supply API, you will get the response in terms of different index keys that will provide you the latest supply data, which includes max supply, the price of currency and the percentage change of one hour, one day and one week.
{ //Crypto Currency Supply, marketcap and volume
"id" : "78",
"rank" : 1,
"name" : "Bitcoin",
"symbol" : "BTC",
"update" : "1 min ago",
"update_time" : "2019-10-03 07:01:24",
"circulating_supply" : "17970625",
"max_supply" : "21000000",
"quote": {
"usd": {
"price" : "8323.27671014",
"market_cap" : "149574484529.16",
"vol_24H" : "12579486945.484",
"percentage_change_1h" : "-0.2291",
"percentage_change_24h" : "0.8181",
"percentage_change_7d" : "-1.4546"
}
}
}, {and more} Market Trends / Signals API
It is on the hand of an investor in the crypto market, that how they get profit through the crypto market by analyzing and comparing both historical and real-time markets before the investment in the crypto market.
We provide Pivot point, technical indicators and MA line to check the current market movement.
Pivot Points API
Users use the pivot point API in order to analyze the market. Basically, It is also a indicator that indicates the user about high, low, support and resistances prices of the market for the current trading days. For the calculation of pivot point user use this API It will use to get PP Resistances and supports in a crypto trading.
Accepted Parameters :
id = {Any valid Crypto ID}
symbol = {Any valid Crypto symbol}
period = {Currency time period}
access_key = API_KEY
Note: In the URL multiple IDs do not support by the mentioned API, Through the API request only one ID or symbol you can send at a time.
https://fcsapi.com/api/crypto/pivot_points?id=80&period=1d&access_key=API_KEY
https://fcsapi.com/api/crypto/pivot_points?symbol=XRP/USD&period=1d&access_key=API_KEYResponse:
Pivot Point response include latest candle pivot point, 3 Resistance and 3 Support points in selected time period.
{
"oa_summary": "Strong Buy", // Overall Summary Buy/Sell based on Moving Avg and Technical Indicators
"pivot_point": {
"Classic": {
"pp": "1.260046", // Pivot Points
"R1": "0.933058", // Resistance 1
"R2": "0.806942", // Resistance 2
"R3": "0.719172", // Resistance 3
"S1": "0.933014", // Support 1
"S2": "0.806912", // Support 2
"S3": "0.719105" // Support 3
},
{ "Fibonacci": {...} },
{ "Camarilla": {...} },
{ "Woodies": {...} },
{ "Demarks": {...} } // High /Low
}
}
Moving Averages API (MA Lines)
It makes easy for the user if you want to get the response that would judge the whole procedure of buying and selling you can use the mentioned API. Through this API users will get crypto market real-time moving average lines values base of previous (5,10,20,50,100,200) candles.
Accepted Parameters :
id = {Any valid Crypto ID}
symbol = {Any valid Crypto symbol}
period = {Currency time period}
access_key = API_KEY
Note: In the URL multiple IDs do not support by the mentioned API, Through the API request only one ID or symbol you can send at a time.
https://fcsapi.com/api/crypto/ma_avg?id=80&period=1d&access_key=API_KEY
https://fcsapi.com/api/crypto/ma_avg?symbol=XRP/USD&period=1d&access_key=API_KEYResponse:
{
"oa_summary": "Strong Buy",
// OverAll Summary Buy/Sell based on Moving Avg and Technical Indicators
"count": { "Total_Buy": "8", "Total_Sell": "3", "Total_Neutral": "1" },
// Count Total Buys, Sells and Neutral
"ma_avg": {
"SMA": { // Simple Moving Averages
// v=Value, s=Signal
"MA5": { "v": 0.8600, "s": "Buy" }, // Based on 5 candles SMA
"MA10": { "v": 0.8800, "s": "Buy" }, // Based on 10 candles SMA
"MA20": { "v": 0.7952, "s": "Sell" }, // Based on 20 candles SMA
"MA50": { "v": 0.7976, "s": "Buy" },
"MA100": { "v": 0.6894, "s": "Buy" },
"MA200": { "v": 0.6580, "s": "Neutral" }
},
"EMA": { // Exponential Moving Averages
"MA5": { "v": 0.8600, "s": "Buy" }, // Based on 5 candles EMA
"MA10": { "v": 0.8800, "s": "Buy" }, // Based on 10 candles EMA
"MA20": { "v": 0.7952, "s": "Sell" }, // Based on 20 candles EMA
"MA50": { "v": 0.7976, "s": "Buy" },
"MA100": { "v": 0.6894, "s": "Buy" },
"MA200": { "v": 0.6580, "s": "Sell" }
},
"summary": "Buy" // Buy/Sell judgment only based on Moving Avg
}
}
Technical Indicator API
The real-time updated values are taken by technical indicator values. For the given currency exchange pair the latest and new point of data derived by the current data point. Top meta indicator (MA, RSI, STOCH, ATR, etc) calculates the technical indicators and return their values. In order to get the technical indicator’s latest values, it has been developed. It will show the top indicated values in the response of this API.
Accepted Parameters :
id = {Any valid Crypto ID}
symbol = {Any valid Crypto symbol}
period = {Currency time period}
access_key = API_KEY
Note: Below API does not support multiple ids in URL as a parameter. Send only 1 ID/Symbol name at a time with API request.
https://fcsapi.com/api/crypto/indicators?id=80&period=1d&access_key=API_KEY
https://fcsapi.com/api/crypto/indicators?symbol=XRP/USD&period=1d&access_key=API_KEYResponse:
{
"oa_summary": "Strong Buy",
// OverAll Summary Buy/Sell based on Moving Avg and Technical Indicators
"count": { "Total_Buy": "6" , "Total_Sell": "1", "Total_Neutral": "1" },
// Count Total Buys, Sells and Neutral
"indicators": {
"RSI": { "v": 57.823, "s": "Buy" }, // RSI (14)
"STOCH": { "v": 76.209, "s": "Buy" }, // Stochastic (9,6)
"STOCHRSI": { "v": 81.306, "s": "Overbought" }, // STOCH (14,6) + RSI(14)
"MACD": { "v": "0.001", "s": "Buy" }, // MACD (12,26)
"Williams": { "v": -19.355, "s": "Overbought" }, // Williams %R
"CCI": { "v": 105.315, "s": "Buy" }, // CCI (14)
"ATR": { "v": 0.0007 , "s": "Less Volatility" }, // ATR (14)
"UO": { "v": 65.45, "s": "Buy" }, // Ultimate Oscillator
"ROC": { "v": 0.142, "s": "Buy" }, // ROC
"summary": "Strong Buy" // Buy/Sell judgment only based on above Indicators
}
}
Sample Code PHP
Real-time rates: Find below a simple PHP example for getting exchange rate data via the FCS API's latest endpoint.
$access_key = "API_KEY"; // Your API access key, Signup to get API KEY
$symbol = "BTC/USD"; // Currency pairs
// Enter your API URL below
$api_url = "https://fcsapi.com/api/crypto/latest?symbol=".$symbol."&access_key=".$access_key;
// Initialize CURL:
$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($ch); // Store the data
curl_close($ch);
$response = json_decode($json, true); // convert JSON into Array
foreach ($response['data'] as $key => $value) {
echo "Open Price Of ".$value['symbol']." is ".$value['candle']['o']; // Open Price Of BTC/USD is 1.1266
echo "Close Price Of ".$value['symbol']." is ".$value['candle']['c']; // Close Price Of BTC/USD is 1.1277
}
Sample Code jQuery.ajax
Real-time rates: Find below a simple jQuery.ajax example of getting exchange rate data via the FCS API's latest endpoint.
access_key = "API_KEY"; // Your API access key, Signup to get API KEY
id = 1; // Stock id
$.ajax({
url: "https://fcsapi.com/api/stock/latest?id=" + id + "&access_key=" + access_key,
dataType: "json",
success: function(data) {
console.log(data);
}
}); Disclaimer
Prices, Market trends and signals are not designed for trading purpose, These signals are only for education 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. Therefore we doesn`t bear any responsibility for any trading losses you might incur as a result of using this data.
Latest price minimum refresh rate is 20 Seconds