https://github.com/zenodeapp/cosmos-supply-endpoints

A simple Node.js project that creates endpoints for the circulating supply and the total supply using the Cosmos SDK API. Useful for platforms like CoinMarketCap or CoinGecko.
https://github.com/zenodeapp/cosmos-supply-endpoints

blockchain coingecko coinmarketcap cosmos endpoints minimalism sdk

Last synced: 8 months ago
JSON representation

A simple Node.js project that creates endpoints for the circulating supply and the total supply using the Cosmos SDK API. Useful for platforms like CoinMarketCap or CoinGecko.

• Host: GitHub
• URL: https://github.com/zenodeapp/cosmos-supply-endpoints
• Owner: zenodeapp
• License: mit
• Created: 2023-12-12T21:44:33.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-02-07T16:08:56.000Z (over 2 years ago)
• Last Synced: 2025-04-14T23:08:06.978Z (about 1 year ago)
• Topics: blockchain, coingecko, coinmarketcap, cosmos, endpoints, minimalism, sdk
• Language: JavaScript
• Homepage:
• Size: 19.5 KB
• Stars: 2
• Watchers: 1
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
# Cosmos Supply Endpoints

A simple Node.js project that creates endpoints for the circulating supply and the total supply using the Cosmos SDK API. Useful for platforms like CoinMarketCap or CoinGecko.

This has been written by ZENODE and is licensed under the MIT-license (see [LICENSE](./LICENSE)).

## Installation (Local)

1. First create an `.env` file in the root of the repository.

2. Copy and paste the content of the `.env.example` into the `.env` file.

3. Change the `API_ENDPOINT` to one that is up-to-date and stable (no trailing slash!).

4. Change the `COIN_DENOM` Make sure to use the correct denominator for `COIN_DENOM`. It is usually the smallest denom.

5. Change the `COIN_DECIMALS` to make sure your end result gets shown in the right amount of decimals. Defaults to 1, which leaves the API results as is.

6. Run `npm install`.

7. Turn on the server by running `npm start`.

8. Once the server is started, browse to the endpoints `localhost:3000/total-supply` and `localhost:3000/circulating-supply` to see the outcomes.

> [!IMPORTANT]

> **LOGIC: Total Supply - Community Pool = Circulating Supply.**

> 

> The logic or API may not match with your chain, so make the necessary changes if the outcome appears to be incorrect or invalid.

— ZEN

Copyright (c) 2023 ZENODE