kryptokuznia.pl

A live BTC and crypto market dashboard, built with Next.js

kryptokuznia.pl is a lightweight, single-page crypto market dashboard built with Next.js, React, and Tailwind CSS. It aggregates data from Binance, CoinGecko, and Alternative.me into one view and auto-refreshes every minute, without reloading the page.

📊 Features

• live BTC/USDT price from Binance — price, 24h change, high/low, volume
• top-crypto market table (BTC, ETH, SOL, BNB) from CoinGecko — 24h / 7d / 30d change
• global market cap and BTC dominance
• Fear & Greed Index gauge
• ATH (all-time high) card for tracked assets
• BTC valuation chart — price vs. 200-week moving average with Very Cheap / Cheap / Fair Value / Expensive / Very Expensive zones, built on weekly Binance candles
• background auto-refresh every 60 seconds
• independent fetching per source (Promise.allSettled) — one API failing doesn't take down the rest of the dashboard
• GET /api/dashboard endpoint returning the aggregated data as JSON
• GET /api/bitcoin-valuation endpoint returning the 200-week MA valuation series as JSON

📋 Requirements

• Node.js 20+
• npm

🛠️ Installation

git clone https://github.com/KryptoKuznia/kryptokuznia.pl.git
cd kryptokuznia.pl
npm install

❄️ Using devenv

The project ships a devenv config that pulls in Node.js and npm for you:

devenv shell

📖 Usage

npm run dev

The app starts on http://localhost:3000.

Command	Description
npm run dev	start the dev server
npm run build	production build
npm run start	run the production build
npm run lint	lint the codebase

🗂️ Data Sources

• Binance API — BTC/USDT price, volume, and weekly candles for the 200W MA valuation chart
• CoinGecko API — market and global data
• Alternative.me — Fear & Greed Index

👨🏻‍💻 Development

The development environment is built around devenv and direnv.

1. Clone the repository

   git clone https://github.com/KryptoKuznia/kryptokuznia.pl.git
   cd kryptokuznia.pl

2. Activate the environment

   If you have Nix and direnv installed, the environment activates automatically when you enter the directory. Otherwise:

   direnv allow

3. Run the server

   devenv defines a web process that runs npm run dev:

   devenv up

⚠️ Disclaimer

Data is provided for informational purposes only and does not constitute investment advice.

📜 License

This project is licensed under the MIT License. See the LICENSE file for details.