A web application made with Rust and React.
You can see an area chart with all your cryptocurrencies in the same chart. And a full pie chart whereas the one Binance offers groups every little amount of crypto in a single "Others" section...
You can use this web application with docker-compose.
Edit the .env file at the root of the project with your personal API keys.
Once done, simply do the following:
docker-compose build
docker-compose up -dThis will start mongo (the database), mongo-express (a web interface to manage the database) and crypto-balance.
You can access:
- The web app via http://127.0.0.1/
- The MongoDB web interface via http://127.0.0.1:8081/
- The database via the port 27017
Note: You might need to build with either DOCKER_BUILDKIT=1 or COMPOSE_DOCKER_CLI_BUILD=1 depending on your docker-compose version. Upgrade to at least v2.0.0 to build without any of these flags.
The backend (in Rust) gets daily snapshots of your wallets and the price history for each cryptocurrency you have in your wallets.
Used APIs:
- Binance API for the wallets snapshots (with the Daily Account Snapshot endpoint)
- Nomics API for the price history (with the Currencies Sparkline endpoint)
The Binance API does not give the fiat amount corresponding to each cryptocurrency you have, hence the need of the Nomics API to get the price history.
A MongoDB database is used to store this data as NoSQL. So when we ask for data in a time range, only the missing data is requested to APIs. The database contains daily data points and it is normalized to be at midnight (00:00) for each day.
- Binance API saves snapshots each day at 23:59 (stored in MongoDB as +1 minute, which is the next day)
- Nomics API gives a price history with data points at 00:00 (stored in MongoDB as is)
Because that's what I use personally! 😅
Maximum time range for one request: 30 days.
Go here to know how to create a Binance API key.
It's the only API I found which can give an history anywhere in time for free. And the free plan accepts 1 request per second, which is reasonable.
Maximum time range for one request: 45 days.
Go here to know how to create a Nomics API key.
- Receives an API request from the frontend
- Gets data stored in the MongoDB database
- Computes the time range of this data
- Computes the needed timespans to fill in the blanks (returns vector of timespans)
- If the vector is empty
- It's up to date
- Aggregates data (wallet snapshots with price history) and returns as JSON
- If the vector contains 1 (before or after) or 2 (before and after) timespans
- Split the timespans in multiple timespans of N days maximum (because of API's time range limit)
- Do as many API requests as timespans
- Upload the results to the database (the time is a primary key)
- Aggregates data (wallet snapshots with price history) and returns as JSON