@ibidathoillah/bittime-cli 0.1.7

package/README.md

@@ -0,0 +1,294 @@
+# bittime-cli
+
+Unofficial Rust CLI for the Bittime exchange. Use it to inspect markets, manage account data, place spot orders, stream live WebSocket events, and expose the same command surface to agents through MCP.
+
+[![Rust](https://img.shields.io/badge/Rust-2021-000000?logo=rust)](https://www.rust-lang.org/)
+[![CLI](https://img.shields.io/badge/interface-terminal-2f855a)](#quick-start)
+[![WebSocket](https://img.shields.io/badge/websocket-live-2563eb)](#websocket-streaming)
+[![MCP](https://img.shields.io/badge/MCP-ready-7c3aed)](#mcp-server)
+
+## Highlights
+
+- Public market data: ping, server time, exchange info, tickers, order book, trades, aggregate trades.
+- Private account data: balances, account info, assets, order history, trade history.
+- Spot trading: market and limit buy/sell, query order, cancel order, open orders.
+- Funding and OTC: crypto deposit/withdraw history, OTC VA code, OTC IDR deposit and withdrawal history.
+- Real-time streams: market depth, private order events, private balance events, raw user channels.
+- Paper trading: local simulated balances and orders stored in `~/.config/bittime/paper_state.json`.
+- Automation-friendly output: human tables by default, JSON envelopes with `-o json`.
+- Credential resolution: CLI flags, environment variables, or `~/.config/bittime/config.toml`.
+- Agent support: MCP server mode for tool discovery and JSON-RPC execution.
+
+## Installation
+
+Install from source:
+
+```bash
+git clone https://github.com/ibidathoillah/bittime-cli.git
+cd bittime-cli
+cargo install --path .
+```
+
+Install from crates.io:
+
+```bash
+cargo install bittime-cli
+```
+
+Install from npm:
+
+```bash
+npm install -g bittime-cli
+```
+
+Run with Docker:
+
+```bash
+docker run --rm ibidathoillah/bittime-cli --help
+docker run --rm -e BITTIME_API_KEY -e BITTIME_API_SECRET ibidathoillah/bittime-cli balance
+```
+
+Run from the checkout:
+
+```bash
+cargo build
+./target/debug/bittime --help
+```
+
+## Quick Start
+
+Market data does not require credentials:
+
+```bash
+bittime ping
+bittime ticker usdt/idr
+bittime orderbook usdt/idr --count 10
+bittime -o json book-ticker usdt/idr
+```
+
+Configure private API credentials:
+
+```bash
+bittime auth set --api-key YOUR_API_KEY --api-secret YOUR_API_SECRET
+bittime auth test
+```
+
+Or use environment variables:
+
+```bash
+export BITTIME_API_KEY=your_api_key
+export BITTIME_API_SECRET=your_api_secret
+```
+
+Credential priority:
+
+1. `--api-key` and `--api-secret`
+2. `BITTIME_API_KEY` and `BITTIME_API_SECRET`
+3. `~/.config/bittime/config.toml`
+
+## Command Reference
+
+Global options:
+
+```text
+bittime [OPTIONS] <COMMAND>
+
+Options:
+  -o, --output <table|json>      Output format [default: table]
+      --api-key <API_KEY>        API key override
+      --api-secret <API_SECRET>  API secret override
+  -v, --verbose                  Enable verbose logs
+      --host <HOST>              Override API host
+```
+
+### Market
+
+```bash
+bittime ping
+bittime server-time
+bittime exchange-info
+bittime ticker usdt/idr
+bittime ticker-all
+bittime price usdt/idr
+bittime book-ticker usdt/idr
+bittime orderbook usdt/idr --count 10
+bittime trades usdt/idr --count 5
+bittime agg-trades usdt/idr --count 5
+bittime historical-trades usdt/idr --count 5
+```
+
+### Account
+
+```bash
+bittime account-info
+bittime balance
+bittime account-info-v2
+bittime assets usdt
+bittime trades-history usdt/idr
+bittime trades-history-v2 usdt/idr --since 123
+bittime trades-legacy usdt/idr
+```
+
+### Trading
+
+```bash
+bittime order buy usdt/idr -t LIMIT -p 16000 --volume 1
+bittime order sell usdt/idr -t MARKET --volume 1
+bittime order cancel usdt/idr --order-id 123456
+bittime order query usdt/idr --order-id 123456
+bittime order open-orders usdt/idr
+bittime order all-orders usdt/idr
+bittime order pending-orders usdt/idr
+bittime order book-orders usdt/idr --count 5
+```
+
+Notes:
+
+- `pending-orders` is a compatibility alias for Bittime's documented `openOrders` endpoint.
+- `book-orders` returns public order book depth from Bittime's documented `depth` endpoint.
+
+### Funding
+
+```bash
+bittime withdraw --asset USDT --volume 100 --address 0x... --network ERC20
+bittime withdrawal status --asset usdt
+bittime deposit status --asset usdt
+bittime deposit va --bank-id 7
+bittime deposit otc-status --count 10
+bittime withdrawal otc-status --count 10
+```
+
+### Paper Trading
+
+```bash
+bittime paper init --pair usdt/idr --quote-balance 100000000 --base-balance 1
+bittime paper balance
+bittime paper buy usdt/idr --price 16000 --volume 1
+bittime paper sell usdt/idr --price 17000 --volume 1
+bittime paper fill 1
+bittime paper orders
+bittime paper orders --all
+bittime paper cancel 2
+bittime paper cancel-all --pair usdt/idr
+bittime paper topup IDR 5000000
+bittime paper history
+bittime paper status
+bittime paper reset
+```
+
+Use `--fill` on `paper buy` or `paper sell` to immediately settle an order at the supplied price.
+
+### WebSocket Streaming
+
+Market depth:
+
+```bash
+bittime ws depth usdt/idr
+bittime ws depth usdt/idr --limit 1 --seconds 15
+```
+
+Private streams:
+
+```bash
+bittime ws orders
+bittime ws balances
+bittime ws user user_order_update
+bittime ws user user_balance_update
+```
+
+The WebSocket client handles Bittime's market gzip frames, market ping/pong, user-stream ping/pong, listen-key creation, and listen-key keepalive.
+
+### Interactive Shell
+
+```bash
+bittime shell
+```
+
+### MCP Server
+
+```bash
+bittime mcp
+```
+
+The MCP server exposes CLI commands as machine-readable tools over JSON-RPC stdio.
+
+## E2E Testing
+
+The repository includes live API smoke tests:
+
+```bash
+./scripts/e2e_test.sh --public
+./scripts/e2e_test.sh --private
+./scripts/e2e_test.sh --ws
+```
+
+Environment knobs:
+
+```bash
+BITTIME_TEST_PAIR=usdt/idr
+BITTIME_TEST_COIN=usdt
+BITTIME_BIN=./target/debug/bittime
+```
+
+Latest local verification:
+
+```text
+cargo test: 16 passed
+./scripts/e2e_test.sh --public: 22 passed
+./scripts/e2e_test.sh --private: 19 passed
+./scripts/e2e_test.sh --ws: 4 passed
+```
+
+## API Coverage
+
+- REST base: `https://openapi.bittime.com`
+- Market WebSocket: `wss://ws.bittime.com/market/ws`
+- User WebSocket: `wss://wsapi.bittime.com`
+- API docs: https://bittime-docs.github.io/
+
+## Architecture
+
+```mermaid
+graph TD
+    A[bittime binary] --> B[Clap command dispatcher]
+    B --> C[AppContext]
+    C --> D[BittimeClient]
+    C --> E[Output dispatcher JSON/Table]
+    D --> F[Bittime REST API]
+    D --> G[Bittime WebSocket streams]
+    B --> H[Interactive shell REPL]
+    B --> I[Model Context Protocol server]
+```
+
+## Security
+
+- Credentials are stored with `0600` permissions when using `bittime auth set`.
+- Prefer read-only API keys for account inspection and WebSocket monitoring.
+- Use IP restrictions on exchange API keys when possible.
+- Never commit real API keys, secrets, or listen keys.
+
+## Development
+
+```bash
+cargo fmt
+cargo test
+cargo build
+```
+
+## Related Projects
+
+If you use multiple exchanges, check out these related CLI tools built with the same architecture:
+
+- [indodax-cli](https://github.com/ibidathoillah/indodax-cli) - CLI for Indodax
+- [bittime-cli](https://github.com/ibidathoillah/bittime-cli) - CLI for Bittime
+- [binance-cli](https://github.com/ibidathoillah/binance-cli) - CLI for Binance Spot
+- [tokocrypto-cli](https://github.com/ibidathoillah/tokocrypto-cli) - CLI for Tokocrypto
+- [kraken-cli](https://github.com/ibidathoillah/kraken-cli) - CLI for Kraken (Spot, Margin, Futures)
+
+## License
+
+MIT
+
+## Disclaimer
+
+This project is unofficial and is not affiliated with or endorsed by Bittime. Cryptocurrency trading is risky; review commands carefully before using write-capable API keys.

package/RELEASE_NOTES.md

@@ -0,0 +1,15 @@
+## 🚀 Welcome to bittime-cli CLI v0.1.7
+
+The unofficial, fast, and feature-rich command-line interface for **Bittime**.
+
+### 🆕 What's New in v0.1.7
+
+- **🔄 Standardized Workflow**: Aligned with the Indodax-CLI development and release lifecycle.
+- **🛡️ Security**: Improved credential management and SSL/TLS handling.
+- **✨ Core Features**: Market data, private trading, and MCP support for AI agents.
+
+### ✨ Core Features
+
+- **🤖 AI Agent Integration (MCP)**: Built-in Model Context Protocol server.
+- **📈 Real-time Data**: WebSocket support for live market updates.
+- **🛠️ Paper Trading**: Local simulated environment for testing strategies.

package/bin/bittime.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const binName = process.platform === 'win32' ? 'bittime.exe' : 'bittime';
+const binPath = path.join(__dirname, binName);
+
+if (!fs.existsSync(binPath)) {
+  console.error('\x1b[31mError: bittime native binary not found.\x1b[0m');
+  console.error(`Expected at: ${binPath}`);
+  console.error('\nTry reinstalling with: npm install -g bittime-cli');
+  console.error('Or install from Cargo: cargo install bittime-cli');
+  process.exit(1);
+}
+
+const child = spawn(binPath, process.argv.slice(2), {
+  stdio: 'inherit',
+});
+
+child.on('exit', (code) => {
+  process.exit(code || 0);
+});
+
+child.on('error', (err) => {
+  console.error(`\x1b[31mError spawning bittime binary:\x1b[0m ${err.message}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@ibidathoillah/bittime-cli",
+  "version": "0.1.7",
+  "description": "Unofficial command-line interface for the Bittime cryptocurrency exchange",
+  "bin": {
+    "bittime": "./bin/bittime.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/install.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ibidathoillah/bittime-cli.git"
+  },
+  "keywords": [
+    "bittime",
+    "crypto",
+    "cli",
+    "trading",
+    "websocket",
+    "mcp"
+  ],
+  "author": "Ibida Thoillah",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/ibidathoillah/bittime-cli/issues"
+  },
+  "homepage": "https://github.com/ibidathoillah/bittime-cli#readme",
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/install.js

@@ -0,0 +1,87 @@
+const fs = require('fs');
+const https = require('https');
+const os = require('os');
+const path = require('path');
+
+const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
+const repo = 'ibidathoillah/bittime-cli';
+
+function targetName() {
+  const platform = os.platform();
+  const arch = os.arch();
+
+  const platforms = {
+    linux: 'linux',
+    darwin: 'macos',
+    win32: 'windows',
+  };
+
+  const arches = {
+    x64: 'x86_64',
+    arm64: 'aarch64',
+  };
+
+  if (!platforms[platform] || !arches[arch]) {
+    return null;
+  }
+
+  const ext = platform === 'win32' ? '.exe' : '';
+  return `bittime-${platforms[platform]}-${arches[arch]}${ext}`;
+}
+
+const artifact = targetName();
+const binDir = path.join(__dirname, '..', 'bin');
+const binName = os.platform() === 'win32' ? 'bittime.exe' : 'bittime';
+const binPath = path.join(binDir, binName);
+
+if (!artifact) {
+  console.warn(`Unsupported platform for prebuilt bittime binary: ${os.platform()} ${os.arch()}`);
+  process.exit(0);
+}
+
+fs.mkdirSync(binDir, { recursive: true });
+
+const url = `https://github.com/${repo}/releases/download/v${pkg.version}/${artifact}`;
+
+function download(source, destination, redirects = 0) {
+  console.log(`Downloading bittime-cli binary from ${source}...`);
+
+  const file = fs.createWriteStream(destination);
+  https
+    .get(source, (response) => {
+      if ([301, 302, 303, 307, 308].includes(response.statusCode)) {
+        file.close();
+        fs.unlink(destination, () => {});
+        if (redirects > 5) {
+          console.warn('Too many redirects while downloading bittime-cli binary.');
+          process.exit(0);
+        }
+        download(response.headers.location, destination, redirects + 1);
+        return;
+      }
+
+      if (response.statusCode !== 200) {
+        file.close();
+        fs.unlink(destination, () => {});
+        console.warn(`Binary download returned HTTP ${response.statusCode}.`);
+        console.warn('npm install will complete, but install Cargo manually if needed: cargo install bittime-cli');
+        process.exit(0);
+      }
+
+      response.pipe(file);
+      file.on('finish', () => {
+        file.close();
+        fs.chmodSync(destination, 0o755);
+        console.log('\x1b[32mbittime-cli binary installed successfully.\x1b[0m');
+      });
+    })
+    .on('error', (err) => {
+      file.close();
+      fs.unlink(destination, () => {});
+      console.warn(`Failed to download bittime-cli binary: ${err.message}`);
+      console.warn('npm install will complete, but install Cargo manually if needed: cargo install bittime-cli');
+      process.exit(0);
+    });
+}
+
+download(url, binPath);

package/scripts/release.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+set -e
+PROJECT_NAME=$(grep "^name =" Cargo.toml | head -n1 | cut -d"\"" -f2)
+if [ -z "$1" ]; then
+    VERSION=$(grep "^version =" Cargo.toml | head -n1 | cut -d"\"" -f2)
+else
+    VERSION=$1
+    sed -i "s/^version = \".*\"/version = \"$VERSION\"/" Cargo.toml
+fi
+if [ -f "package.json" ]; then sed -i "s/\"version\": \".*\"/\"version\": \"$VERSION\"/" package.json; fi
+if [ -f "RELEASE_NOTES.md" ]; then
+    sed -i "s/Welcome to .* CLI v[0-9.]*/Welcome to $PROJECT_NAME CLI v$VERSION/" RELEASE_NOTES.md
+    sed -i "s/What's New in v[0-9.]*/What's New in v$VERSION/" RELEASE_NOTES.md
+fi
+echo "✅ $PROJECT_NAME updated to v$VERSION"
+if command -v gh &> /dev/null; then
+    echo "Updating GitHub release v$VERSION..."
+    gh release edit "v$VERSION" --notes-file RELEASE_NOTES.md || \
+    gh release create "v$VERSION" --title "v$VERSION" --notes-file RELEASE_NOTES.md
+fi
+