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 “Tokens” API?
The “Tokens” API returns all the available data we have for the tokens on the Bancor network.
Base URL format:
https://api.bancor.network/0.1/currencies/{TokenType}?
URL Values:
The following values can be appended to the API call :
- TokenType= indicate the type of tokens you wish to receive in the response
- Tokens - returns ERC20 and smart tokens
- Relays - returns relay tokens
- fromCurrencyCode=ETH - will result in receiving data back in ETH currency.
- orderBy= define the order of items returned. Available values:
- liquidityDepth - the size of the connector balance
- change24 - the change of token price in the last 24 hours
- price - the current token price
- volume24 - the conversion volume during the last 24 hours
- code - token name
- sortOrder= define the sort order of the list received. Available values:
- desc - descending order
- asc - ascending order
- limit= 1-100 (default is 30). Determine the amount of records to receive.
- skip= 1-100 (default is 0). Determine the amount of records to skip.
- includeTotal= boolean value. Indicate if you with to receive the total amount of available tokens in the response.
Sample Call:
https://api.bancor.network/0.1/currencies/tokens?limit=1&skip=0&fromCurrencyCode=ETH&includeTotal=false&orderBy=liquidityDepth&sortOrder=desc
- TokenType = tokens
- fromCurrencyCode = ETH
- orderBy = liquidityDepth
- sortOrder = desc
- limit = 1
- skip = 0
- includeTotal = false
Sample Response:
{"data":{"currencies":{"page":[{"_id":"594bb7e468a95e00203b048d","symbol":"BNT","type":"ethereum","details":{"type":"bancor","subType":"smart","contractAddress":"0x1f573d6fb3f13d689ff844b4ce37794d79a7ff1c","supply":"74775281083523725963087643","changer":{"type":"bancor","version":"0.4","contractAddress":"0xb626a5facc4de1c813f5293ec3be31979f1d1c78","isActive":true,"activatedAt":"2017-06-22T07:00:00.000Z"},"reserves":{"5937d635231e97001f744267":{"contractAddress":"0xc0829421c1d260bd3cb3e0f06cfe2d52db2ce315","currencySymbol":"Ξ","ratio":100000,"numDecimalDigits":18,"balance":"44001842276537681939982"}}},"status":"published","stage":"traded","createdAt":"2017-06-22T07:00:00.000Z","numDecimalDigits":18,"primaryCommunityId":"5967699a4a93370018b7b891","primaryCommunityImageName":"f80f2a40-eaf5-11e7-9b5e-179c6e04aa7c.png","code":"BNT","name":"Bancor","isDeleted":false,"order":300,"isDiscoverable":true,"originalCurrencyId":"594bb7e468a95e00203b048d","price":0.005601948072580547,"change24h":-0.6927365621230122,"priceHistory":[0.005402214902240569,0.005395380959829653,0.0054027228791513554,0.0054169721726570474,0.0054272558732494725,0.0054234447922943,0.0054256918705245655,0.005419196473339037,0.0054195260470858726,0.00542393109888581,0.005433983220550033,0.005435785025313575,0.005435071993213968,0.0054502152560918435,0.005447085549911717,0.0054397489445132015,0.005463829323492751,0.005475718311665864,0.005475466185906546,0.0054534762232103596,0.005450748963320758,0.005451612821505865,0.005456316854898109,0.005467503711667849,0.005485213677786707,0.005501352403946525,0.005525593220170024,0.005534737592615986,0.005555501277436367,0.005552760820968491,0.005566772054779846,0.005567294658638708,0.005571357777393569,0.005560060801339513,0.005557953818332825,0.005551088917596285,0.005557303523568499,0.005558133679529753,0.005566770994687679,0.005559758505937668,0.005557084465769369,0.005544213639711774,0.005544536527212457,0.005535616682424168,0.005523581819591813,0.005547400042541659,0.0055475868540789544,0.005590264466342692,0.00559541396855827,0.005658817134091754,0.005632167018431435,0.005643135907305748,0.005646084780015642,0.0056585932591831116,0.0056418755953388635,0.005638314737897357,0.0056513698573625966,0.005662544088444798,0.005661265574116641,0.005653969409466006,0.005652117425167114,0.0056462777065744985,0.005638624666218799,0.005635814193803256,0.0056268269985472385,0.0056435161130367235,0.005638570273774624,0.005638833871678745,0.0056327140962071556,0.005640749251955607,0.005630719491806917,0.005636679264776472,0.0056398200939225245,0.005634291123598607,0.005610972908172535,0.005610486451837161,0.0056220528437875535,0.00562100195980044,0.005625097792147517,0.0056279860274193304,0.005616184633673924,0.005603983721681358,0.0056022903752504915,0.005601947733604986],"liquidityDepth":"41660.285828770192714362","volume24h":"3568920174802531095496"}]}}}
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