Price Discovery (value) API

Bancor provides public API methods which take HTTP GET requests and return JSON.

Please note that making more than 6 calls per second to the public API, or repeatedly and needlessly fetching excessive amounts of data, can result in your IP being banned.

What is the “Price Discover” API?

The “Price Discover” API returns the expected amount of tokens you will receive when executing a transaction of a certain size using the Bancor Price Discovery formula.

URL format:

Requesting amount needed in the "To" token:

https://api.bancor.network/0.1/currencies/{FromCurrencyID}/value?toCurrencyId={ToCurrencyID}&toAmount={Amount}

Requesting amount needed in the "From" token:

https://api.bancor.network/0.1/currencies/{FromCurrencyID}/value?toCurrencyId={ToCurrencyID}&fromAmount={Amount}

URL Values:

You will require to pass 3 values in order for the API to successfully work:

• {FromCurrencyID} - this value is a unique currency ID that will indicate the token you would like to convert from. This is the token you currently have and would like to convert.
• {ToCurrencyID} - this unique currency ID indicate the token you would like to convert to. This is the token you currently do not own and would like to receive at the end of the conversion process.
• {Amount} - this integer value represents the smallest unit (wei) of the amount you would like to convert and receive indication for from the API.

Sample Call:

https://api.bancor.network/0.1/currencies/5937d635231e97001f744267/value?toCurrencyId=594bb7e468a95e00203b048d&toAmount=1000000000000000000

• {FromCurrencyID} -  5937d635231e97001f744267 (indicate ETH)
• {ToCurrencyID} - 594bb7e468a95e00203b048d (indicate BNT)
• {Amount} - 1000000000000000000 (indicate 1 ETH in Wei). This integer value represents the smallest unit (wei) of the amount you would like to convert and receive indication for from the API.
  There are two options for the value indication:
  • toAmount={Amount} - when appending this to the API call, you will indicate the amount of tokens you wish to receive as a result of the transaction. The API will return the expected units to use in order to receive this return.
  • fromAmount={Amount} - when appending this to the API call, you will indicate the amount of tokens you wish to receive as a result of the transaction. The API will return the expected units to use in order to receive this return.

Sample Response:

{"data":"5607837548991896"}

• What is '5607837548991896'?
  This value is the amount of BNT tokens you are expected to receive as a result of converting 1 ETH to BNT. 

Note - execution amount may vary due to external changes. The calculation is dynamic and is relevant for the time of sampling. Since actual execution may be done with a delay, the result amount can change (up or down) given the data on the exact time of execution

Keep in mind:

Bancor API is currently in alpha and is likely to break or be slow to response.

Prices may vary during the process, and should be considered as estimation only. 

We offer several APIs for our partners, for more information please visit our API Documentation