Skip to content
Light API for EOSIO networks
Perl Shell
Branch: master
Clone or download
Latest commit 7a95444 Jul 24, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
scripts bugfix in fork handling Jul 20, 2019
setup added wax and xec Jul 23, 2019
sql return head block data in API requests Jun 24, 2019
systemd systemd unit: start dbwriter after mariadb Jul 23, 2019 README updated Jul 24, 2019


API description

The API is providing information about EOSIO blockchain accounts and token balances. It is deployed for several blockchains, such as EOS, Telos, BOS, WAX, and Europechain. Also an endpoint for Jungle testnet is available.

In below examples, "eos" stands for the name of the network where API is taking the data.

  • http://apihost.domain/api/networks lists all known networks and their information.

  • Retrieve all token balances, resources and authorization information for an account: http://apihost.domain/api/account/eos/ACCOUNT

  • Retrieve only token balances for an account: http://apihost.domain/api/balances/eos/ACCOUNT

  • Retrieve all account information except token balances: http://apihost.domain/api/accinfo/eos/ACCOUNT

  • Retrieve all accounts in all known EOS networks dependent on a public key: http://apihost.domain/api/key/KEY

  • http://apihost.domain/api/sync/eos returns a plain text with delay in seconds that this server's blockchain database is behind the real time, and a status: OK if the delay is within 180 seconds, or 'OUT_OF_SYNC' otherwise.

  • http://apihost.domain/api/tokenbalance/eos/ACCOUNT/CONTRACT/TOKEN returns a plain text with numeric output indicating the token balance. Zero is returned if the token is not present or does not exist.

  • http://apihost.domain/api/topholders/eos/CONTRACT/TOKEN/NUM returns top NUM holders of a specified token in a JSON array containing arrays of (account, amount) pairs. NUM must not be less than 10 or more than 1000.

  • http://apihost.domain/api/usercount/eos returns a plain text with total number of accounts in the network.

  • http://apihost.domain/api/topram/eos/NUM returns top NUM RAM buyers in a JSON array containing arrays of (account, bytes) pairs. NUM must not be less than 10 or more than 1000.

  • http://apihost.domain/api/topstake/eos/NUM returns top NUM stake holders by sum of CPU and Net stakes, in a JSON array containing arrays of (account, cpu_weight, net_weight) tuples. NUM must not be less than 10 or more than 1000.

  • http://apihost.domain/api/codehash/SHA256 retrieves all accounts in all known EOS networks by contract hash.

In addition, adding ?pretty=1 to the URL, you get the resulting JSON sorted and formatted for human viewing.

User discussion and support in Telegram:

Public endpoints

A list of public API endpoints is served by IPFS, and available with the following links:

Project sponsors

  • GetScatter ( engineering, hosting and maintenance.

  • EOS Cafe Block ( new features.

  • Telos community: development of additional features in Chronicle.

  • EOS Amsterdam and Newdex: development of Version 2.

  • EOS Amsterdam: hosting for BOS, WAX and Europechain.


sudo apt-get install git make cpanminus gcc g++ mariadb-server \
libmysqlclient-dev libdbi-perl libjson-xs-perl libjson-perl

sudo cpanm DBD::MariaDB
sudo cpanm Starman
sudo cpanm Net::WebSocket::Server
sudo cpanm Crypt::Digest::RIPEMD160;

git clone -b v2 /opt/eosio_light_api
cd /opt/eosio_light_api

sudo mysql <sql/lightapi_dbcreate.sql
sh setup/

vi /etc/default/lightapi_eos
# add the Chronicle consumer socket details:
# DBWRITE_OPTS=--port=8100

# Optionally, edit /etc/default/lightapi_api and adjust variables
# that are predefined in systemd/lightapi_api.service

cd systemd
sh eos

# Now Starman is serving HTTP requests and you can build your HTTP service
# with nginx or exposing Starman directly

Copyright and License

Copyright 2018-2019

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Donations and paid service

ETH address: 0x7137bfe007B15F05d3BF7819d28419EAFCD6501E

EOS account: cc32dninexxx

You can’t perform that action at this time.