Articles in this section

Price Ticker 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 “Ticker” API?

The “Ticker” API returns all relevant data (name, symbol, code, decimals, price 24h high, price 24h low, price, price 24h, volume 24h, total supply) for the specific pair.

 

“Volume” and “total supply” values are indicated in the smallest unit of the token (example: Wei for ETH) which means you will need to format it correctly based on the {toToken} decimal digit settings.

 

Ticker API URL Format:

GET:
https://api.bancor.network/0.1/currencies/{toToken}/ticker?fromCurrencyCode={fromToken}&displayCurrencyCode={displayCurrency}

 

Values you are required to pass:

  • toToken - this needs to be the token code (ETH, BNT, etc). 
  • fromToken - this needs to be the token code (ETH, BNT, eth).

Note - toToken & fromToken will define the pair you are aiming to receive data for. The response will return all values for the indicated pair including volume and price.

  • displayCurrency - we support 3 display currencies: ETH, USD or EUR.

 

For accuracy of data we advise using the following pairs:

  • BNT/ETH
  • {token}/BNT

 

Sample URL format: BNT/ETH

https://api.bancor.network/0.1/currencies/BNT/ticker?fromCurrencyCode=ETH&displayCurrencyCode=ETH

 

Sample output:

{
"data": {
"name": "Bancor",
"symbol": "BNT",
"code": "BNT",
"decimals": 18,
"totalSupply": "78484266561094012877746246",
"price24h": 0.006597180383137444,
"volume24h": "2887858753166105000000",
"displayCurrency": "ETH",
"price": 0.006608204569155241
}
}

 

Sample URL format: GNO/BNT

https://api.bancor.network/0.1/currencies/GNO/ticker?fromCurrencyCode=BNT&displayCurrencyCode=USD

 

Sample output:

{
"data": {
"name": "Gnosis",
"symbol": "GNO",
"code": "GNO",
"decimals": 18,
"totalSupply": "10000000000000000000000000",
"price": 21.739506617308834,
"volume24h": "11641320610427583000000",
"displayCurrency": "USD",
"price24h": 25.640709006574166
}
}

 

  • Token indication must be in upper case and match the token code from the “Pairs” API.

 

 

Keep in mind:

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

 

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




Was this article helpful?
11 out of 12 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