Articles in this section

Conversion Path API

Bancor provides public API methods which take HTTPS 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 “Conversion Path” API?

At the heart of the Bancor Protocol is Bancor's conversion functionality. This unique feature allows you to convert any token to any token in a single and simple action.

When building a "quickConvert" transaction directly on the blockchain, you will need to pass an array of addresses that indicate the path between two defined tokens. For ease of use, the conversionPath API will allow you to check the array to use instead of identifying this from the blockchain.

 

Basic URL format: 

(GET) https://api.bancor.network/0.1/transactions/conversionPath?{FromToken}&{ToToken}

Appended Values:

This API call requires you to pass the two tokens you would like to convert in the following way:

FromToken:

Indicate the FromToken in the following ways:

  • fromCurrencyCode - Pass the code of the token in our system. Example: ETH, BNT, DAI, EOS
  • fromCurrencyID - Pass the bancor identifier of the token. Example: 5c9a078447a87f2e3cf108b1

ToToken:

Indicate the ToToken in the following ways:

  • toCurrencyCode - Pass the code of the token in our system. Example: ETH, BNT, DAI, EOS
  • toCurrencyID - Pass the bancor identifier of the token. Example: 5c9a078447a87f2e3cf108b1

NOTE - You must use the same value format in the call. Meaning, either pass fromCurrencyId & toCurrecyId, or fromCurrencyCode & toCurrencyCode.

Sample Call:

https://api.bancor.network/0.1/transactions/conversionPath?fromCurrencyCode=BNT&toCurrencyCode=SAI

Sample Response:

{"data":["0x1f573d6fb3f13d689ff844b4ce37794d79a7ff1c","0xee01b3ab5f6728adc137be101d99c678938e6e72","0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359"]}

 

How to use this response data?

Use the response data (array of addresses) when following the process outlined here. 

Was this article helpful?
1 out of 4 found this helpful
Have more questions? Submit a request
Return to top
Disclaimer: When reading this article, please keep in mind the following: (1) Important to notice that wherever referring to any sensitive information of yours, including private keys, key-pairs or other account information, that information is yours. We can only make limited suggestions to how such information may be treated and protected, but the responsibility is yours. You should always make sure your information is protected and kept private, in the best available way; (2) that the information contained herein is a simplified extract of detailed information and sources generally available on the internet. This basic information was collected and displayed in attempt to provide you with better understanding of certain processes and aspects which relate to content and applications on Bancor’s site. Although we do our best to keep this information up-to-date, we cannot always guaranty that. This is since the information originates from third parties or relates to third party services, applications and technologies (such as Metamask, Scatter, EOSToolkit, or EOS), which are unrelated or unaffiliated with Bancor. These third parties’ applications, services and technologies are available on the internet, and may be subjected to applicable terms and conditions. Accordingly, though the said information and third applications, services and technologies (“Third Parties Content”) are believed to be reliable, Bancor provides no warranties regarding them (including their accuracy or completeness). IN NO EVENT WILL BANCOR BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL OR CONSEQUENTIAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST REVENUES, LOST PROFITS OR LOSS OF PROSPECTIVE ECONOMIC ADVANTAGE RESULTING FROM THE USE OF THE THIRD PARTIES CONTENT EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM BY ANOTHER PARTY.

Related articles