Crypto Tools

A collection of cryptocurrency tools for Kraken, Binance, and SwissBorg exchanges. Built with Next.js, React, and Tailwind CSS.

Live version: https://crypto-tools.andstuff.dev

Features

Kraken

• Order Batch — Create multiple buy or sell post-limit orders for a trading pair with configurable price and volume distribution functions. Supports dry-run mode for safe testing.
• Closed Orders — View and filter closed orders by asset and date range. Displays buy and sell orders grouped by trading pair with volume, cost, and average price summaries.
• Balances — View spot and staking account balances.
• xStocks — AI-powered classification of Kraken tokenized assets (stocks and ETFs) using Anthropic Claude. Generates descriptions with configurable word count and supports filtering by asset type.

Binance

• Staking Overview — Overview of spot wallet balances and locked staking positions, including available and sold-out staking products for each asset. Shows next redemptions sorted by date, per-asset breakdowns with fiat valuations, and staking product details with quota analysis.

SwissBorg

• Smart Yield — Interactive chart of SwissBorg Smart Yield rates over time with configurable yield rate types, line types, and time frames. Toggle individual yield lines via the chart legend — hidden yields are also removed from the averages table below.
• Community Index — Historical chart of the SwissBorg Community Index score.

Desktop App

A standalone desktop app is available for macOS (Apple Silicon, no Node.js or Git required):

1. Download CryptoTools-{version}-arm64.dmg from the releases page
2. Open the DMG and drag CryptoTools.app to your Applications folder
3. Double-click CryptoTools in Applications to launch

macOS Gatekeeper

Because the app is not signed with an Apple Developer certificate, macOS will block it on first launch. To allow it:

1. Try to open the app — macOS will show a warning and block it
2. Open System Settings → Privacy & Security
3. Scroll down to the security section — you will see "CryptoTools was blocked from use because it is not from an identified developer"
4. Click Open Anyway, then confirm in the dialog

You only need to do this once per installation.

Debugging a crash

If the app launches but immediately quits without showing a window, run it from Terminal to see the full log output:

/Applications/CryptoTools.app/Contents/MacOS/CryptoTools

You can also check Console.app or crash reports in ~/Library/Logs/DiagnosticReports/.

API keys can be configured in the app on the Settings page (stored in localStorage).

Building the desktop app

pnpm electron:build   # produces dist/CryptoTools-{version}-arm64.dmg

To test the desktop app locally without building a distributable:

pnpm electron:dev

Web App Installation

1. Install Node.js and pnpm
2. Clone the repository

   git clone https://github.com/nyg/crypto-tools.git
   cd crypto-tools

3. Install dependencies

   pnpm install

4. (Optional) Copy .env.development.local.example to .env.development.local and fill in your API keys
5. Start the development server

   pnpm dev

6. Open http://localhost:3000

Mocked Mode

Run the app with mock data (no API keys or database required):

pnpm mocked

This sets NEXT_PUBLIC_MOCK_DATA=true, which intercepts all API calls with a mock fetcher and auto-initializes localStorage with fake credentials. Useful for development and demos.

Usage

Navigate via the top menu bar to access each exchange's tools. Each exchange section has sub-navigation for its specific features.

API keys for Kraken, Binance, and Anthropic can be configured on the Settings page (stored in localStorage) or via environment variables.

Project Structure

pages/                  File-based routing (Next.js Pages Router)
├── api/                Server-side API routes
│   ├── binance/        Binance API proxy routes
│   ├── kraken/         Kraken API proxy routes
│   └── swissborg/      SwissBorg API & cron routes
├── binance/            Binance pages
├── kraken/             Kraken pages
├── swissborg/          SwissBorg pages
└── settings.js         API key management
components/             React components
├── binance/            Binance-specific components
├── kraken/             Kraken-specific components
├── swissborg/          SwissBorg-specific components
├── lib/                Custom wrapper components
└── ui/                 shadcn/ui primitives
lib/
├── adapters/           External API adapters (Binance, Kraken, Anthropic)
│   └── http-requester/ HTTP transport abstraction (got for server, fetch for browser)
└── services/           Business logic (rate finder using Dijkstra's algorithm)
utils/                  Utility functions (crypto, formatting, event bus)

Disclaimer

Use at your own risk.

License

MIT