MarketCap API
Last updated
Was this helpful?
Last updated
Was this helpful?
The purpose of MarketCap API is to provide API endpoints for queries that need responses in bespoke formats required by a particular client or set of clients. The motivation for this software is primarily to provide an API for market cap aggregator sites, who in general do not specialize their queries for each project but instead require the projects conform to their own request standards. Towards that end, the Marketcap API is a simple and concise REST API that supplies data on max and circulating supply and token rich lists, and could be extended to include other queries. Responses are structured to conform to the requirements of each market cap aggregator site that is served. This API is not intended for general public use, nor does it offer a comprehensive set of queries. In particular, it is not suited for use as a block explorer. Rather, it is for automated polling by a limited number of aggregator sites or statistics recording services, or other special purposes for which a custom API format is needed.
Functionally, the MarketCap API is a wrapper or "facade" that sits in front of the Peerplays core public API nodes, and and simply reformats the responses to fit the needs of the clients served.
Installation and setup instructions are detailed in the , but a summary of the steps is as follows:
Execute the below CLI in the terminal on the machine on which you will run the service:
The MarketCap API is a simple python3 script. Execute it with the below CLI commands to activate the interface.
The API is explained via a Swagger-UI interface, which documents each available API call as well as its parameters and return values. Swagger is an interactive API documentation that also lets you "try out" the API calls. It will give you a curl command that you can run to query the API, and also show you the results of a live query right in the interface.
After running the API, point a browser at http://[host]:[port]/api/docs to access the UI.
Click the below browser link to access the UI,
The below images will showcase the interface for one of the API calls in swagger. The Asset ID is vital to get the output.
Click on the Try it out option to execute the API Call,
Click the Execute button to run the API call and the output for the respective API call will be listed below. The sample output is provided below,
The response for any API call consists of two methods to get the output,
Curl command - It uses "GET" command as CLI to retrieve the output in the terminal.
Requested URL - The URL will be generated for the executed API call. Paste the URL in the browser and click Enter to get the plain text output in the browser.
The output for CURL and plain text URL is attached below (respectively),
There are three categories of API calls featured in the swagger,
Supply
Plain-text supply
Rich list
The command retrieve the complete supply data of an asset using the Asset ID in JSON format. The supply data includes total, maximum, and circulating value of an asset.
Curl Command
Plain text URL
Asset ID: The Asset ID or token symbol of the account
The max_supply API call will return the maximum number of coins or token that has ever been created for any asset. Once the maximum supply is reached there cannot be any new coins/token that can be mined, minted or produced. the output is as a fixed point plain text using Asset ID as parameter.
Curl Command
Plain text URL
Asset ID: The Asset ID or token symbol of the account
The total_supply API call will return the cumulative supply of coins or tokens of a specific asset that has been created/mined which includes locked/reserved asset. The output is the plain text fixed number using Asset ID as parameter.
Curl Command
Plain text URL
Asset ID: The Asset ID or token symbol of the account
The circulating_supply API call returns the total number of coins or token actively available for trade. The output is the plain text fixed number using the asset ID as parameter.
Curl Command
Plain text URL
Asset ID: The Asset ID or token symbol of the account
The top_balances API call will return the top holders of asset for the asset ID with the given number of counts to return the holders.
Curl Command
Plain text URL
Asset ID: The Asset ID or token symbol of the account
Number: Number of top holders to return for the given asset ID
Edit conf/explorer-conf.yaml
The API needs the URL of a Peerplays core node API with assets API enabled. Note that the assets API is not enabled by default. For instructions on enabling it, see .
It is a good idea to run the API in some form of persistent session manager, such as a GNU Screen session, or . The latter, if configured correctly, can even enable automated restart on system reboots.
In the case of the API maintained for Peerplays by the PBSA, the UI can be explored here:
