Public bananode RPC API for the BANANO network
This is a free bananode as-a-service for easy access to the BANANO network. You can use it for manual experiments, or integrate it for automated queries into your apps.
Link to RPC documentation. See also the other guides on the nanoo.tools website.
Specification
- API URL: api-beta.banano.cc
- DNS records for IPv4 and IPv6
- You can connect via http (port 7070) or https (port 443)
- You can either POST ( Content-Type: application/x-www-form-urlencoded or Content-Type: application/json ) or GET
- Banano Node V.23 with decimals enabled
- 2GB of RAM
- Location: Hetzner datacenter Virginia
- 1 CPU core
Limitations
- "account_history", "ledger" are being cut off after 1000 results at a time, but most of them allow pagination.
- Callback/Websocket is not publicly available at the moment.
- If you use wallet_create without providing a seed, you can't retrieve the seed later.
- "stop", "bootstrap", "node_id_delete" , "stats_clear" and peer-altering commands are not available
- Timestamps are absolutely not reliable, especially when it comes to ancient blocks
- Works with ban_ addresses only
- Only one CPU thread is dedicated to work generation.
- It's a bit slower than running a local node when doing chain analytics.
- Generated wallets might not be persistent forever. Use at your own risk. If you use wallet_create without providing a seed, you can't retrieve the seed later.
- "representatives", "delegators" don't show decimal amounts. Use representatives_decimal and delegators_decimal instead.
Non-standard responses (list may be incomplete)
- Error 500 { "error": "Internal server error. Could not reach node." } when node is not responding.
- Error 400 { "error": "Malformed request. No action recognized." } when "action" parameter is not set
- Error 400 { "error": "Requested RPC action is forbidden on this node." } when action is not allowed
- Error 400 { "error": "Incorrect connection attempt. Read API manual for correct ports." } when port is wrong
Future plans
- additional, non-standard responses
- Websockets and non-async HTTP callback
- More performance
- API keys
- IPv6
- Historic timestamps
- Example apps and snippets
Usage examples
POST JSON via HTTP CURL:
curl -g -d '{
"action": "account_info",
"account": "ban_1bananobh5rat99qfgt1ptpieie5swmoth87thi74qgbfrij7dcgjiij94xr"
}' 'http://api-beta.banano.cc:7070'
POST JSON via HTTPS CURL:
curl -g -d '{
"action": "account_info",
"account": "ban_1bananobh5rat99qfgt1ptpieie5swmoth87thi74qgbfrij7dcgjiij94xr"
}' 'https://api-beta.banano.cc:443'
POST as application/x-www-form-urlencoded.
Header:
Host: api-beta.banano.cc:443 User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:64.0) Gecko/20100101 Firefox/64.0 Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8 Accept-Language: en Accept-Encoding: gzip, deflate Pragma: no-cache Content-Type: application/x-www-form-urlencoded Cache-Control: no-cache
Body:
action=account_info&account=ban_1bananobh5rat99qfgt1ptpieie5swmoth87thi74qgbfrij7dcgjiij94xr