ICObench API

Get started

Auth and examples

ICOs - All

ICOs - Search and Filters

ICOs - Trending

ICOs - Ratings

ICO - Profile

People - All

People - Search and Filters

Stats

Terms & Conditions

Get started

ICObench Data API allows you to get various information and data from the platform including ICO listings, ratings, and stats. This tutorial provides instructions on how to identify the API calls, and walks you through a simple scenario using the API.

Some interesting projects that already use our API

Authentication

The API uses the HMAC method with SHA384 algorithm to authenticate the query. Once you are registered and given access to private and public keys for the API, you can request the data from the endpoint. For detailed instructions, view our authentication guide.

To use the ICObench Data API you need to have both "Private Key" and "Public Key".
- Public Key is used to identify the API user and is sent via request header as "X-ICObench-Key".
- Private Key is used to sign every request together with JSON. Both are hashed by HMAC SHA384, converted to base64 and sent via request header as "X-ICObench-Sig".

Please make sure to send data using POST method and from the IP that you have whitelisted in your API settings.

PHP Example - Show all active ICOs and order them by Rating DESC

PHP Example - Show details on ICO ID 472

$api = new ICObenchAPI();
$api->getICO(472);
echo $api->result;

ICOs - All

/icos/all

This endpoint returns up to 12 ICOs per page with the amount of pages based on the search criteria and the filters provided. The response provides some basic information about the ICOs. For detailed information you can use the ID returned and call /ico/{id|url}.

Request

POST https://icobench.com/api/v1/icos/all

Parameters

No parameters are needed. To set filters and search parameters please use Search and Filters.

ICOs - Search

/icos/all

This endpoint returns up to 12 ICOs per page with the number of pages based on the search criteria and the filters provided. The response provides some basic information about the ICOs. For detailed information you can use use the ID returned and call endpoint /ico/{id|url}.

Request

POST https://icobench.com/api/v1/icos/all

Parameters

Name

Type

Possible values

Description

orderDesc

string

- rating- start- end- raised- name

Put the list of ICOs in order by rating, start, end, raised or name descendingly.

orderAsc

string

- rating- start- end- raised- name

Put the list of ICOs in order by rating, start, end, raised or name ascendingly.

page

int

page number

List the ICOs from a certain page of your search query.

category

int

category ID

List the ICOs from a certain category, e.g. "1" (Internet).

platform

string

custom string

List the ICOs supported by a certain platform, e.g. "Ethereum".

accepting

string

custom string

List the ICOs those are accepting a certain currency, e.g. "BTC".

country

string

custom string

List the ICOs located in a certain country, e.g. "Australia" or "UK".

status

string

- active- ongoing- upcoming- ended

List the ICOs those are either active (not ended), ongoing, upcoming or ended.

published

string

- this week- last week- this month- last month

API v2 - List the ICOs published recently

search

string

custom query

List the ICOs those have a certain string in the name, token name, tagline or short description, e.g. "VIB" or "gaming".

bonus

string

- yes

List the ICOs that have a bonus.

bounty

string

- yes

List the ICOs that have a bounty.

team

string

- yes

List the ICOs that have a public team.

expert

string

- yes

List the ICOs that have at least one expert rating.

rating

int

- 1- 2- 3- 4

List the ICOs that have rating 1+, 2+, 3+, 4+.

startAfter

string

yyyy-mm-dd

List the ICOs starting from selected date.

endBefore

string

yyyy-mm-dd

List the ICOs ending before the date.

registration

int

- 1- 2- 3- 4- 5- 6

List the ICOs based on registration type and requirements - KYC / Whitelist.1 = With whitelist2 = Without whitelist3 = With KYC4 = Without KYC5 = With KYC and Whitelist6 = None

excludeRestrictedCountry

string

custom query

List the ICOs excluding all ICOs with restriction on that country.

Response

ICOs - Trending

/icos/trending

This endpoint returns up to 8 ICOs that are currently "Hot and Trending" on ICObench. Response provides some basic information about ICOs. For detailed information use id returned here and endpoint /ico/{id|url}.

The list of the currencies accepted during the token sale. The currencies are separated by colon (,). For fiat options (USD, EUR, etc.) the word "Fiat" is used. If a large list of cryptocurrencies is accepted, the word "Various" is used.

dates

object[]

The Pre-ICO and the ICO start and end dates.

dates.preIcoStart

string ("yyyy-mm-dd hh-mm-ss")

The PreICO start date.

dates.preIcoEnd

string ("yyyy-mm-dd hh-mm-ss")

The Pre-ICO end date.

dates.icoStart

string ("yyyy-mm-dd hh-mm-ss")

The ICO start date.

dates.icoEnd

string ("yyyy-mm-dd hh-mm-ss")

The ICO end date.

team

object[]

The list of team members and advisors.

team[x].name

string

The team member's name.

team[x].title

string

The team member's title.

team[x].socials

object[]

The links for the team member's social media accounts.

socials[x].site

string

The site name - options: twitter, facebook, linkedin, other.

socials[x].url

string

The URL to the social profile.

team[x].group

string

The team member's group, e.g. "Team" or "Advisors".

team[x].photo

string

The URL for the ICObench page on which you can find the team member's photo.

team[x].iss

decimal

The team member's ICO Success Score.

ratings

object[]

The list of all the ratings the ICO has received from the experts.

ratings[x].date

string ("yyyy-mm-dd")

The date of review.

ratings[x].name

string

The expert's name.

ratings[x].title

string

The expert's title.

ratings[x].photo

string

The URL for the ICObench page on which you can find the expert's photo.

ratings[x].team

int

Rating from 1 to 5 that was given for the team.

ratings[x].vision

int

Rating from 1 to 5 that was given for the vision.

ratings[x].product

int

Rating from 1 to 5 that was given for the product.

ratings[x].profile

int

Rating from 1 to 5 that was given for the ICO profile (Benchy only).

ratings[x].review

string

The written review the expert has provided.

ratings[x].weight

string

The percent of weight towards total rating.

ratings[x].agree

int

The number of agrees on this rating.

categories

object[]

The list of all categories the ICO is listed in.

categories[x].id

int

The category ID.

categories[x].name

string

The category name.

exchanges

object[]

The list of all exchanges the token is listed on.

exchanges[x].id

int

The exchange ID.

exchanges[x].name

string

The exchange name.

exchanges[x].logo

string

The exchange logo.

exchanges[x].price

decimal

The price of token on exchange.

exchanges[x].currency

string

The currency price is in.

exchanges[x].roi

string

Return on investment of token bought in ICO.

People - All

/people/{all|expert|registered}

This endpoint returns up to 12 people per page with the amount of pages based on the search criteria and the filters provided. The response provides some basic information about the person.

Request

POST https://icobench.com/api/v1/people/all

Parameters

No parameters are needed. To set filters and search parameters please use Search and Filters.

Top 5 countries by the number of ICOs per million people. Only the countries with more ICOs than the ratio are considered.

countriesByIcosPerMillion[x].country

string

The name of the country.

countriesByIcosPerMillion[x].count

decimal

The number of ICOs located in a certain country per million people.

topRaised

object[]

Top 5 ICOs by the value of tokens sold during the ICO.

topRaised[x].id

int

The ICO ID.

topRaised[x].name

string

The ICO name.

topRaised[x].url

string

The URL for the ICObench page on which you can find the ICO.

topRaised[x].raised

int

The value of the tokens raised in the ICO in USD.

icos

int

The total number of all ICOs published on ICObench.

members

int

The number of team members registered at ICObench.

topIss

object[]

Top 5 registered users by their ICO Success Score.

topIss[x].iss

decimal

The user's ICO Success Score.

topIss[x].name

string

The user's name.

Terms & Conditions

This document governs your relationship with ICObench when you use our API. You must read the terms and conditions of this agreement before using the API provided by ICObench. By accessing or using the API or any other ICObench content, you agree to the terms and conditions appearing below, which we may update from time to time.

Purpose

The API is provided by ICObench to enable you access to the data available to and provided by ICObench.

Changes

We reserve the right to change, update, and modify these terms and conditions and the API at any time. If we believe that the change might be significant for you, we will notify you about the changes and updates using the email address you have provided within the request for the API key. If you do not agree with the changes made, you must stop using the API within ten (10) days after receiving the email informing about the changes.

API request process

In order to use the API provided by ICObench you need to first register your personal account and require the API key. In order to request the keys you need to provide:
- The list of sources where you plan to use the API (website URL, mobile app, etc.)
- The incoming IP that will access the API.

You agree to keep your API key information confidential and that you will not share it with any third party. Otherwise, you won't be able to finish the registration.

License

We reserve the right to review and evaluate all of the usage of the API and check regularly if you are using the API in accordance with these terms and conditions. Violating the terms will result in ban from use of the ICObench API. You agree that you will stop using the API and destroy any content belonging to ICObench within twenty-four (24) hours of receiving the email notifying you about the fact of ban or immediately if in any case your email account becomes unavailable for any reason.

If the data provided in the API is used for publishing (web, print or any other media) it must be explicitly shown or mentioned that data is or was provided by ICObench. Otherwise we would have to ask you to update the information (if it is online) or publish an update with a mention of ICObench in the next issue of print media where the data was used.

If the part of the API was used to deploy the system of application on your site or in your app it must be explicitly shown or mentioned that data is or was provided by ICObench. Otherwise we would have to ask you to update the information in twenty-four (24) hours or to take down this part of website or app until the information can be updated if it cannot be provided in the time frame specified.

Restrictions

You agree that you will not and will not assist to or enable any third parties to:
- Cache, record or store any of content belonging to ICObench for a period longer than twenty-four (24) hours;
- Modify the content belonging to ICObench or use it to update or create your own database of ICO listings without our additional approval;
- Use the API on behalf of a third party;
- Copy, rent out, lease, sell, transfer, assign, sublicense, disassemble, reverse engineer or decompile, modify or alter any part of the API;
- Use the API in a manner that can harm ICObench and its servers stability;
- Display any content belonging to ICObench in a manner that defames ICObench or its products and services or infringes (and) ICObench’s intellectual property or any other rights;
- Use the API or content belonging to ICObench in a manner that may violate any laws or regulations, or any rights (e.g. intellectual property rights, rights of privacy and/or rights of personality) of any individual;
- Use the API or content belonging to ICObench in connection with or to promote any illegal or inappropriate content.

No warranties; No support

The API is available “as is”, “with all faults” and “as available” without a warranty. You agree that you will use of the API at your own risk.

Limitation of Liability

The API is being provided free of charge. Accordingly, you agree that ICObench shall have no liability arising from, relating to or based on your use of the API.

Governing law; Dispute resolution

You agree that all matters relating to your access to or use of the API, including all disputes, will be governed by the laws of Russian Federation. You agree to the personal jurisdiction by and venue in the regional and district courts in Saint Petersburg, Russia, and waive any objection to such jurisdiction or venue.

Contact and violations

If you detect any violations regarding the ICObench API or if you have any additional questions, contact us through this form.