API documentation

Authentication

To use Foundico API you need to have both "Public Key" and "Private Key". All requests must be signed by private key and sent using POST method.

PHP authentication example

$privateKey = 'privateKey';
$publicKey = 'publicKey';

$parameters = array('status' => 'upcoming');
$postData = json_encode($parameters);
$accessKey = base64_encode(hash_hmac('sha256', $postData, $privateKey, true));

$ch = curl_init('https://foundico.com/api/v1/icos/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
	'Content-Type: application/json',
	'X-Foundico-Public-Key: '.$publicKey,
	'X-Foundico-Access-Key: '.$accessKey
]);

$response = curl_exec($ch);
curl_close($ch);
echo $response;

ICOs - Filters

/filters/

This endpoint returns all available ICOs filters.

Request

POST https://foundico.com/api/v1/filters/

Parameters

No parameters are needed.

Response

{
"platform": [
	{
		"id": "158",
		"name": "Ardor"
	},
	// ...
],
"category": [
	{
		"id": "27",
		"name": "Adult"
	},
	// ...
],
"type": [
	{
		"id": "44",
		"name": "ICO"
	},
	// ...
],
"location": [
	{
		"name": "Albania"
	},
	// ...
]
}

Name	Type	Description
platform	object[]	List of all available platforms.
platform[n].id	int	ID of current platform.
platform[n].name	string	Name of current platform.
category	object[]	List of all available categories.
category[n].id	int	ID of current category.
category[n].name	string	Name of current category.
type	object[]	List of all available types of ICOs.
type[n].id	int	ID of current type.
type[n].name	string	Name of current type.
location	object[]	List of all available countries.
location[n].name	string	Name of current country.

ICOs - All

/icos/

This endpoint returns up to 20 ICOs per page with pages amount dependent on filter parameters.

Request

POST https://foundico.com/api/v1/icos/

PHP request parameters example

$parameters = array(
	'sort_asc' => 'name',
	'platform' => array(111),
	'category' => array(27, 28, 90),
	'status' => 'upcoming',
	'ico_score' => 7,
	'location' => array('China', 'Malta'),
	'investor_wl' => 'yes',
	'accepted_currencies' => array('ETH', 'BTC', 'LTC'),
	// ...
);

Parameters

Name	Type	Values	Description
sort_asc	string	-name -id -start_datetime -end_datetime	Sort ICOs in result list in order by specified value ascendingly.
sort_desc	string	-name -id -start_datetime -end_datetime	Sort ICOs in result list in order by specified value descendingly.
page	int	page number	List ICOs from the specified page of your request.
platform	array of int values	platforms ID	List ICOs from the specified platforms.
category	array of int values	categories ID	List ICOs from the specified categories.
type	array of int values	types ID	List ICOs of the required types.
location	array of string values	countries names	List ICOs located in the specified countries.
status	string	-ongoing -upcoming -past	List ICOs by specified status.
ico_score	int	1-10	List ICOs that have ICO Score 1+, 2+, 3+...
airdrop_program	string	-yes	List ICOs that have airdrop program.
bounty_program	string	-yes	List ICOs that have bounty program.
investor_kyc	string	-yes	List ICOs that conduct KYC procedure.
investor_wl	string	-yes	List ICOs that conduct whitelisting.
ico_kyc_passed	string	-yes	List ICOs which team is passed KYC procedure.
accepted_currencies	array of string values	currencies tickers	List ICOs those are accepting specified currencies, e.g. "ETH".
exclude_areas	array of string values	countries names	List ICOs excluding projects with specified countries.

Response

{
"total_icos": "2520",
"total_pages": 126,
"current_page": 1,
"error": null,
"data": [
	{
		"id": "16174",
		"main": {
			"name": "0xcert",
			"logo": "https:\/\/foundico.com\/upload\/iblock\/a6f\/a6ffaed2a580aa44cb92e7d417929f8a.png",
			"ico_score": "8"
		},
		"links": {
			"url": "https:\/\/foundico.com\/ico\/0xcert.html"
		},
		"finance": {
			"raised": ""
		}
	},
	// ...
]
}

Name	Type	Description
total_icos	int	Total amount of ICOs based on request parameters. ICOs amount limited to 20 items per page
total_pages	int	Total amount of pages based on request parameters.
current_page	int	Number of the current page based on request parameters.
error	int or null	Error code of the current request.
data	object[]	List of ICOs for request parameters.
data[n].id	int	ID of the current ICO.
data[n].main	object[]	Main information about the current ICO.
data[n].main.name	string	Name of the current ICO.
data[n].main.logo	string	URL to logo of the current ICO.
data[n].main.ico_score	string	ICO Score of the current ICO.
data[n].links	object[]	Links, belonging to the current ICO.
data[n].links.url	string	URL to Foundico.com page about the current ICO.
data[n].finance	object[]	Financial information about the current ICO.
data[n].finance.raised	int	Amount of raised funds in USD.

ICOs - Profile

/ico/

This endpoint returns detailed information on the required ICO.

Request

POST https://foundico.com/api/v1/ico/

PHP request parameters example

$parameters = array('id' => 16174);

Parameters

Name	Type	Values	Description
id	int	ID of needed ICO	Output the ICO with specified ID.

Response

{
"error": null,
"data": {
	"id": "16174",
	"main": {
		"name": "0xcert",
		"description": "Create, own, and validate unique assets on the blockchain with 0xcert - the first open protocol built to support the future of digital assets, powered by non-fungible tokens.",
		"logo": "https:\/\/foundico.com\/upload\/iblock\/a6f\/a6ffaed2a580aa44cb92e7d417929f8a.png",
		"premium": "",
		"scam": "",
		"ico_score": "8.9",
		"platform": "Ethereum",
		"kyc": true,
		"whitelist": true,
		"category": "Computing",
		"type": "ICO",
		"mvp": true,
		"location": "Slovenia",
		"kyc_passed": true
	},
	"links": {
		"url": "https:\/\/foundico.com\/ico\/0xcert.html",
		"website": "https:\/\/0xcert.org\/",
		"whitepaper": "https:\/\/0xcert.org\/whitepaper.pdf",
		"social": {
			"twitter": "https:\/\/twitter.com\/0xcert",
			// ...
		},
		"video": "https:\/\/www.youtube.com\/watch?v=yptxQdD6Xbo"
	},
	"finance": {
		"ticker": "ZXC",
		"tokens_for_sale": "250000000",
		"token_price": "0.0073",
		"token_price_unit": "USD",
		"min_purchase": "",
		"max_purchase": "",
		"purchase_unit": "ZXC",
		"token_type": "ERC20",
		"soft_cap": "3000000",
		"hard_cap": "12000000",
		"caps_unit": "USD",
		"escrow": "",
		"markets": [
			"https:\/\/bittrex.com",
			// ...
		],
		"distribution": {
			"Development": "50%",
			// ...
		},
		"restricted_areas": "",
		"accepting": [
			"ETH",
			// ...
		],
		"raised": ""
	},
	"dates": {
		"start_datetime": "02.07.2018 17:00:00",
		"end_datetime": "18.07.2018 23:59:00",
		"tba": ""
	},
	"additional": {
		"bonuses": {
			"Private presale": "20-15%",
			// ...
		},
		"airdrop": "",
		"bounty": true
	},
	"roadmap": {
		"31-10-2017": "First proposal of the blockchain certification technology First MVP",
		// ...
	},
	"team": [
		{
			"name": "Jure Zih",
			"role": "0xcert CEO",
			"photo": "https:\/\/foundico.com\/upload\/iblock\/89f\/89f2816ccc27b9ab42ccbf323661da6f.PNG",
			"social": {
				"linkedin": "https:\/\/www.linkedin.com\/in\/jurezih\/",
				// ...
			}
		},
		// ...
	],
	"advisors": [
		{
			"name": "William Entriken",
			"role": "Lead Author of the ERC-721 Standard",
			"photo": "https:\/\/foundico.com\/upload\/iblock\/7b1\/7b1ac8d2c2047a6f515f5f6d40d88c7b.PNG",
			"social": {
				"linkedin": "https:\/\/www.linkedin.com\/in\/fulldecent",
				// ...
			}
		},
		// ...
	]
}
}

Name	Type	Description
error	int or null	Error code of the current request.
data	object[]	ICO for the current request.
data.id	int	ID of ICO.
data.main	object[]	Main information about ICO.
data.main.name	string	ICO name.
data.main.description	string	ICO text description.
data.main.logo	string	URL to logo of the ICO.
data.main.premium	boolean	Return "true" if this ICO listed as premium.
data.main.scam	boolean	Returns "true" if this ICO marked as scam.
data.main.ico_score	float	ICO Score of the ICO.
data.main.platform	string	Platform name of the ICO.
data.main.kyc	boolean	Returns "true" if this ICO conduct KYC procedure.
data.main.whitelist	boolean	Returns "true" if this ICO conduct whitelisting.
data.main.category	string	Category name in which placed this ICO.
data.main.type	string	Type of the ICO.
data.main.mvp	boolean	Returns "true" if this ICO has MVP.
data.main.location	string	Country name in which located this ICO.
data.main.kyc_passed	boolean	Returns "true" if team of this ICO passed KYC procedure.
data.links	object[]	Links to resources and social media of the ICO.
data.links.url	string	URL to Foundico.com page about the ICO.
data.links.website	string	URL to official website of the ICO.
data.links.whitepaper	string	URL to Whitepaper of the ICO.
data.links.social	object	Links to social media of the ICO.
data.links.social['n']	string	URL to the current social media.
data.links.video	string	URL to video presentation about the ICO.
data.finance	object[]	Financial information about the ICO.
data.finance.ticker	string	Token ticker.
data.finance.tokens_for_sale	int	Number of tokens available for sale during the ICO.
data.finance.token_price	float	Token price. During the ICO returns fixed value. After the ICO returns actual value from CoinMarketCap.
data.finance.token_price_unit	string	Units in which displayed token price.
data.finance.min_purchase	int or float	Minimum required amount of contribution.
data.finance.max_purchase	int or float	Maximium required amount of contribution.
data.finance.purchase_unit	string	Units in which displayed minimum and maximum purchase amount.
data.finance.token_type	string	Type of token (only for Ethereum based projects).
data.finance.soft_cap	int or float	Softcap of the ICO. Can be empty.
data.finance.hard_cap	int or float	Hardcap of the ICO.
data.finance.caps_unit	string	Units in which displayed softcap and hardcap.
data.finance.escrow	boolean	Returns "true" this ICO has escrow.
data.finance.markets	array	List of exchanges on which token of this ICO will be placed.
data.finance.markets[n]	string	URL to the current exchange.
data.finance.distribution	object	Token distribution parts during the ICO.
data.finance.distribution['n']	string	Percentage value of the current distribution part.
data.finance.restricted_areas	array	List of countries in which the ICO is not allowed.
data.finance.restricted_areas[n]	array string	Name of the current country.
data.finance.accepting	array	List of currencies, accepted during the ICO.
data.finance.accepting[n]	string	Ticker of the current currency, e.g. "ETH".
data.dates	object[]	End and start dates of the current stage of this ICO.
data.dates.start_datetime	string DD.MM.YYYY HH:MM:SS	Start date and time.
data.dates.end_datetime	string DD.MM.YYYY HH:MM:SS	End date and time.
data.dates.tba	boolean	Returns "true" if dates of this ICO are not defined.
data.additional	object[]	Additional information about the ICO.
data.additional.bonuses	object	List of bonuses during the ICO.
data.additional.bonuses['n']	string	Terms of current bonus.
data.additional.airdrop	boolean	Returns "true" if this ICO has airdrop program.
data.additional.bounty	boolean	Returns "true" if this ICO has bounty program.
data.roadmap	object	List of project's roadmap items.
data.roadmap['n']	string	Description of the current roadmap item.
data.team	object[]	List of team members of the ICO.
data.team[n].name	string	Name of current team member.
data.team[n].role	string	Role of current team member.
data.team[n].photo	string	URL to photo of the current team member.
data.team[n].social	object	Links to social media of the current team member.
data.team[n].social['n']	string	URL to the current social media.
data.advisors	object[]	List of advisors of the ICO.
data.advisors[n].name	string	Name of current advisor.
data.advisors[n].role	string	Role of current advisor.
data.advisors[n].photo	string	URL to photo of the current advisor.
data.advisors[n].social	object	Links to social media of the current advisor.
data.advisors[n].social['n']	string	URL to the current social media.

Errors

Error code	Description
480	Private or public key is not valid. User must include valid private and public keys to any requests to Foundico API gateway.
481	Method not exists. User has requested nonexistent endpoint.
482	Projects not found. Didn't find any ICOs by requested parameters.
483	Gateway received invalid value. Request parameters has invalid symbols.
484	Required parameter not exists. Request was sent without required parameter.
485	Out of API limits. You have exceeded the allowed requests amount limit per day.