Spacemesh explorer backend designed to provide data for explorer-frontends
The explorer backend provides a public REST API that can be used to get data about a Spacemesh network. Follow these steps to use the API for a public Spacemesh network:
- Obtain a currently available explorer API endpoint from the Spacemesh public web services endpoint. This endpoint lists all available Spacemesh networks.
- Build a REST request using the endpoint. For example, explorer api url for mainnet is
https://mainnet-explorer-api.spacemesh.network/
then the network-info data is available athttps://mainnet-explorer-api.spacemesh.network/network-info
. - Issue an http 'GET' request to get the data. e.g.
curl https://mainnet-explorer-api.spacemesh.network/network-info
. - Live long and prosper.
- Use the
pagesize
andpage
params to get paginated results. The first page number is 1, so for example, to get the first 20 layers call:https://mainnet-explorer-api.spacemesh.network/layers?pagesize=20&page=1
and to get the next 20 layers use:https://mainnet-explorer-api.spacemesh.network/layers?pagesize=20&page=2
- API results which support pagination include pagination data in the response json. e.g.:
{"totalCount":1020,"pageCount":51,"perPage":20,"next":2,"hasNext":true,"current":1,"previous":1,"hasPrevious":false}}
Use this pagination data to figure out how many calls you need to make and which what params in order to get all the data.
The API is not properly documented yet. The best way to identity the supported API methods is via the api server source code.
- Get layer details: https://mainnet-explorer-api.spacemesh.network/layers/52410
- Get mainnet current network info: https://mainnet-explorer-api.spacemesh.network/