toobit-trade-cli 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1,491 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import {
+  loadConfig,
+  ToobitRestClient,
+  createToolRunner,
+  toToolErrorPayload,
+  configFilePath as configFilePath2
+} from "@toobit_agent/agent-toobitkit-core";
+
+// src/parser.ts
+import { parseArgs } from "util";
+function parseCli(argv = process.argv.slice(2)) {
+  const STRING_OPTIONS = /* @__PURE__ */ new Set([
+    "profile",
+    "symbol",
+    "interval",
+    "limit",
+    "side",
+    "type",
+    "quantity",
+    "price",
+    "orderId",
+    "clientOrderId",
+    "leverage",
+    "orderType",
+    "tokenId",
+    "instId",
+    "period",
+    "bar",
+    "startTime",
+    "endTime",
+    "marginType"
+  ]);
+  let command = "help";
+  let subcommand = "";
+  const flagArgs = [];
+  let positionalCount = 0;
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg.startsWith("-")) {
+      flagArgs.push(arg);
+      const optName = arg.replace(/^--?/, "");
+      if (STRING_OPTIONS.has(optName) && i + 1 < argv.length && !argv[i + 1].startsWith("-")) {
+        flagArgs.push(argv[++i]);
+      }
+    } else {
+      if (positionalCount === 0) command = arg;
+      else if (positionalCount === 1) subcommand = arg;
+      positionalCount++;
+    }
+  }
+  const parsed = parseArgs({
+    args: flagArgs,
+    options: {
+      profile: { type: "string" },
+      json: { type: "boolean", default: false },
+      "read-only": { type: "boolean", default: false },
+      symbol: { type: "string" },
+      interval: { type: "string" },
+      limit: { type: "string" },
+      side: { type: "string" },
+      type: { type: "string" },
+      quantity: { type: "string" },
+      price: { type: "string" },
+      orderId: { type: "string" },
+      clientOrderId: { type: "string" },
+      leverage: { type: "string" },
+      orderType: { type: "string" },
+      tokenId: { type: "string" },
+      instId: { type: "string" },
+      period: { type: "string" },
+      bar: { type: "string" },
+      startTime: { type: "string" },
+      endTime: { type: "string" },
+      marginType: { type: "string" }
+    },
+    strict: false,
+    allowPositionals: true
+  });
+  return {
+    command,
+    subcommand,
+    profile: parsed.values.profile,
+    json: parsed.values.json ?? false,
+    readOnly: parsed.values["read-only"] ?? false,
+    flags: parsed.values,
+    positionals: parsed.positionals
+  };
+}
+
+// src/formatter.ts
+function formatJson(data, json) {
+  if (json) return JSON.stringify(data, null, 2);
+  if (data === null || data === void 0) return "No data.";
+  if (typeof data !== "object") return String(data);
+  return JSON.stringify(data, null, 2);
+}
+
+// src/commands/market.ts
+async function handleMarketCommand(cli, run) {
+  const f = cli.flags;
+  let result;
+  switch (cli.subcommand) {
+    case "time":
+      result = await run("market_get_server_time", {});
+      break;
+    case "info":
+      result = await run("market_get_exchange_info", {});
+      break;
+    case "ticker":
+      result = await run("market_get_ticker_price", { symbol: f.symbol });
+      break;
+    case "ticker-24hr":
+      result = await run("market_get_ticker_24hr", { symbol: f.symbol });
+      break;
+    case "depth":
+      result = await run("market_get_depth", { symbol: f.symbol, limit: f.limit ? Number(f.limit) : void 0 });
+      break;
+    case "trades":
+      result = await run("market_get_trades", { symbol: f.symbol, limit: f.limit ? Number(f.limit) : void 0 });
+      break;
+    case "klines":
+    case "candles":
+      result = await run("market_get_klines", {
+        symbol: f.symbol,
+        interval: f.interval ?? f.bar ?? "1h",
+        limit: f.limit ? Number(f.limit) : void 0,
+        startTime: f.startTime ? Number(f.startTime) : void 0,
+        endTime: f.endTime ? Number(f.endTime) : void 0
+      });
+      break;
+    case "book-ticker":
+      result = await run("market_get_book_ticker", { symbol: f.symbol });
+      break;
+    case "mark-price":
+      result = await run("market_get_mark_price", { symbol: f.symbol });
+      break;
+    case "funding-rate":
+      result = await run("market_get_funding_rate", { symbol: f.symbol });
+      break;
+    case "funding-rate-history":
+      result = await run("market_get_funding_rate_history", {
+        symbol: f.symbol,
+        limit: f.limit ? Number(f.limit) : void 0
+      });
+      break;
+    case "open-interest":
+      result = await run("market_get_open_interest", { symbol: f.symbol });
+      break;
+    case "index":
+      result = await run("market_get_index_price", { symbol: f.symbol });
+      break;
+    case "contract-ticker":
+      result = await run("market_get_contract_ticker_24hr", { symbol: f.symbol });
+      break;
+    case "long-short-ratio":
+      result = await run("market_get_long_short_ratio", { symbol: f.symbol, period: f.period ?? "1h" });
+      break;
+    default:
+      process.stdout.write(`Unknown market subcommand: ${cli.subcommand}
+Available: time, info, ticker, ticker-24hr, depth, trades, klines, candles, book-ticker, mark-price, funding-rate, funding-rate-history, open-interest, index, contract-ticker, long-short-ratio
+`);
+      return;
+  }
+  process.stdout.write(formatJson(result, cli.json) + "\n");
+}
+
+// src/commands/spot.ts
+async function handleSpotCommand(cli, run) {
+  const f = cli.flags;
+  let result;
+  switch (cli.subcommand) {
+    case "place":
+      result = await run("spot_place_order", {
+        symbol: f.symbol,
+        side: f.side,
+        type: f.type ?? "MARKET",
+        quantity: f.quantity,
+        price: f.price
+      });
+      break;
+    case "cancel":
+      result = await run("spot_cancel_order", { orderId: f.orderId, clientOrderId: f.clientOrderId });
+      break;
+    case "cancel-all":
+      result = await run("spot_cancel_open_orders", { symbol: f.symbol });
+      break;
+    case "get":
+      result = await run("spot_get_order", { orderId: f.orderId, clientOrderId: f.clientOrderId });
+      break;
+    case "open-orders":
+    case "orders":
+      result = await run("spot_get_open_orders", { symbol: f.symbol, limit: f.limit ? Number(f.limit) : void 0 });
+      break;
+    case "history":
+      result = await run("spot_get_trade_orders", {
+        symbol: f.symbol,
+        limit: f.limit ? Number(f.limit) : void 0,
+        startTime: f.startTime ? Number(f.startTime) : void 0,
+        endTime: f.endTime ? Number(f.endTime) : void 0
+      });
+      break;
+    case "fills":
+      result = await run("spot_get_fills", {
+        symbol: f.symbol,
+        limit: f.limit ? Number(f.limit) : void 0
+      });
+      break;
+    default:
+      process.stdout.write(`Unknown spot subcommand: ${cli.subcommand}
+Available: place, cancel, cancel-all, get, orders, open-orders, history, fills
+`);
+      return;
+  }
+  process.stdout.write(formatJson(result, cli.json) + "\n");
+}
+
+// src/commands/futures.ts
+async function handleFuturesCommand(cli, run) {
+  const f = cli.flags;
+  let result;
+  switch (cli.subcommand) {
+    case "place":
+      result = await run("futures_place_order", {
+        symbol: f.symbol,
+        side: f.side,
+        orderType: f.orderType ?? f.type ?? "MARKET",
+        quantity: f.quantity,
+        price: f.price,
+        leverage: f.leverage
+      });
+      break;
+    case "cancel":
+      result = await run("futures_cancel_order", { orderId: f.orderId, clientOrderId: f.clientOrderId });
+      break;
+    case "cancel-all":
+      result = await run("futures_cancel_all_orders", { symbol: f.symbol });
+      break;
+    case "amend":
+      result = await run("futures_amend_order", { orderId: f.orderId, quantity: f.quantity, price: f.price });
+      break;
+    case "get":
+      result = await run("futures_get_order", { orderId: f.orderId, clientOrderId: f.clientOrderId });
+      break;
+    case "orders":
+    case "open-orders":
+      result = await run("futures_get_open_orders", { symbol: f.symbol });
+      break;
+    case "history":
+      result = await run("futures_get_history_orders", {
+        symbol: f.symbol,
+        limit: f.limit ? Number(f.limit) : void 0
+      });
+      break;
+    case "positions":
+      result = await run("futures_get_positions", { symbol: f.symbol });
+      break;
+    case "history-positions":
+      result = await run("futures_get_history_positions", { symbol: f.symbol });
+      break;
+    case "leverage":
+      if (f.leverage) {
+        result = await run("futures_set_leverage", { symbol: f.symbol, leverage: Number(f.leverage) });
+      } else {
+        result = await run("futures_get_leverage", { symbol: f.symbol });
+      }
+      break;
+    case "margin-type":
+      result = await run("futures_set_margin_type", { symbol: f.symbol, marginType: f.marginType });
+      break;
+    case "flash-close":
+      result = await run("futures_flash_close", { symbol: f.symbol, side: f.side });
+      break;
+    case "balance":
+      result = await run("futures_get_balance", {});
+      break;
+    case "fills":
+      result = await run("futures_get_fills", { symbol: f.symbol, limit: f.limit ? Number(f.limit) : void 0 });
+      break;
+    case "pnl":
+      result = await run("futures_get_today_pnl", {});
+      break;
+    case "commission":
+      result = await run("futures_get_commission_rate", { symbol: f.symbol });
+      break;
+    default:
+      process.stdout.write(`Unknown futures subcommand: ${cli.subcommand}
+Available: place, cancel, cancel-all, amend, get, orders, history, positions, history-positions, leverage, margin-type, flash-close, balance, fills, pnl, commission
+`);
+      return;
+  }
+  process.stdout.write(formatJson(result, cli.json) + "\n");
+}
+
+// src/commands/account.ts
+async function handleAccountCommand(cli, run) {
+  const f = cli.flags;
+  let result;
+  switch (cli.subcommand) {
+    case "balance":
+    case "info":
+    case "":
+      result = await run("account_get_info", {});
+      break;
+    case "balance-flow":
+      result = await run("account_get_balance_flow", {
+        tokenId: f.tokenId,
+        limit: f.limit ? Number(f.limit) : void 0
+      });
+      break;
+    case "sub-accounts":
+      result = await run("account_get_sub_accounts", {});
+      break;
+    case "check-api-key":
+      result = await run("account_check_api_key", {});
+      break;
+    case "deposit-address":
+      result = await run("account_get_deposit_address", { tokenId: f.tokenId });
+      break;
+    case "deposits":
+      result = await run("account_get_deposit_orders", {
+        tokenId: f.tokenId,
+        limit: f.limit ? Number(f.limit) : void 0
+      });
+      break;
+    case "withdrawals":
+      result = await run("account_get_withdraw_orders", {
+        tokenId: f.tokenId,
+        limit: f.limit ? Number(f.limit) : void 0
+      });
+      break;
+    case "audit":
+      result = await run("trade_get_history", { limit: f.limit ? Number(f.limit) : void 0 });
+      break;
+    default:
+      process.stdout.write(`Unknown account subcommand: ${cli.subcommand}
+Available: balance, info, balance-flow, sub-accounts, check-api-key, deposit-address, deposits, withdrawals, audit
+`);
+      return;
+  }
+  process.stdout.write(formatJson(result, cli.json) + "\n");
+}
+
+// src/commands/config.ts
+import * as readline from "readline";
+import {
+  configFilePath,
+  readFullConfig,
+  writeFullConfig
+} from "@toobit_agent/agent-toobitkit-core";
+function prompt(question) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+async function handleConfigCommand(cli) {
+  switch (cli.subcommand) {
+    case "init": {
+      process.stdout.write("Toobit API Configuration Wizard\n\n");
+      const profileName = await prompt("Profile name (default: live): ") || "live";
+      const apiKey = await prompt("API Key: ");
+      const secretKey = await prompt("Secret Key: ");
+      if (!apiKey || !secretKey) {
+        process.stdout.write("API Key and Secret Key are required.\n");
+        return;
+      }
+      const config = readFullConfig();
+      config.default_profile = config.default_profile ?? profileName;
+      if (!config.profiles) config.profiles = {};
+      config.profiles[profileName] = { api_key: apiKey, secret_key: secretKey };
+      writeFullConfig(config);
+      process.stdout.write(`
+\u2713 Saved to ${configFilePath()}
+  Profile: ${profileName}
+`);
+      break;
+    }
+    case "show": {
+      const config = readFullConfig();
+      process.stdout.write(`Config file: ${configFilePath()}
+
+`);
+      process.stdout.write(`Default profile: ${config.default_profile ?? "(none)"}
+`);
+      process.stdout.write(`Profiles: ${Object.keys(config.profiles ?? {}).join(", ") || "(none)"}
+`);
+      break;
+    }
+    case "list-profiles":
+    case "list": {
+      const config = readFullConfig();
+      const profiles = Object.keys(config.profiles ?? {});
+      if (profiles.length === 0) {
+        process.stdout.write("No profiles configured.\n");
+      } else {
+        for (const name of profiles) {
+          const marker = name === config.default_profile ? " (default)" : "";
+          process.stdout.write(`  ${name}${marker}
+`);
+        }
+      }
+      break;
+    }
+    default:
+      process.stdout.write(`Unknown config subcommand: ${cli.subcommand}
+Available: init, show, list
+`);
+  }
+}
+
+// src/index.ts
+function printHelp() {
+  const help = `
+Toobit Trade CLI \u2014 Trade from your terminal
+
+Usage: toobit <command> <subcommand> [options]
+
+Commands:
+  market       Market data (ticker, depth, klines, funding-rate, etc.)
+  spot         Spot trading (place, cancel, orders, fills)
+  futures      USDT-M futures (place, cancel, positions, leverage, etc.)
+  account      Account info (balance, deposits, withdrawals, audit)
+  config       Configuration management (init, show, list)
+
+Global Options:
+  --profile <name>   Profile from ${configFilePath2()}
+  --json             Output raw JSON
+  --read-only        Disable write operations
+  --help             Show this help
+
+Examples:
+  toobit market ticker --symbol BTCUSDT
+  toobit market candles --symbol BTCUSDT --interval 1h --limit 10
+  toobit market funding-rate --symbol BTCUSDT
+  toobit spot place --symbol BTCUSDT --side BUY --type MARKET --quantity 0.001
+  toobit futures positions --symbol BTCUSDT
+  toobit account balance
+  toobit config init
+`;
+  process.stdout.write(help);
+}
+async function main() {
+  const cli = parseCli();
+  if (cli.command === "help" || cli.flags.help) {
+    printHelp();
+    return;
+  }
+  if (cli.command === "config") {
+    await handleConfigCommand(cli);
+    return;
+  }
+  const config = loadConfig({
+    modules: "all",
+    profile: cli.profile,
+    readOnly: cli.readOnly,
+    userAgent: "toobit-trade-cli/1.0.0",
+    sourceTag: "CLI"
+  });
+  const client = new ToobitRestClient(config);
+  const run = createToolRunner(client, config);
+  switch (cli.command) {
+    case "market":
+      await handleMarketCommand(cli, run);
+      break;
+    case "spot":
+      await handleSpotCommand(cli, run);
+      break;
+    case "futures":
+      await handleFuturesCommand(cli, run);
+      break;
+    case "account":
+      await handleAccountCommand(cli, run);
+      break;
+    default:
+      process.stdout.write(`Unknown command: ${cli.command}
+`);
+      printHelp();
+  }
+}
+main().catch((error) => {
+  const payload = toToolErrorPayload(error);
+  process.stderr.write(`${JSON.stringify(payload, null, 2)}
+`);
+  process.exitCode = 1;
+});

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "toobit-trade-cli",
+  "version": "1.0.0",
+  "type": "module",
+  "bin": {
+    "toobit": "dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@toobit_agent/agent-toobitkit-core": "workspace:*",
+    "smol-toml": "^1.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0"
+  }
+}

package/src/commands/account.ts

@@ -0,0 +1,51 @@
+import type { ToolRunner } from "@toobit_agent/agent-toobitkit-core";
+import type { CliParsed } from "../parser.js";
+import { formatJson } from "../formatter.js";
+
+export async function handleAccountCommand(cli: CliParsed, run: ToolRunner): Promise<void> {
+  const f = cli.flags;
+  let result;
+
+  switch (cli.subcommand) {
+    case "balance":
+    case "info":
+    case "":
+      result = await run("account_get_info", {});
+      break;
+    case "balance-flow":
+      result = await run("account_get_balance_flow", {
+        tokenId: f.tokenId,
+        limit: f.limit ? Number(f.limit) : undefined,
+      });
+      break;
+    case "sub-accounts":
+      result = await run("account_get_sub_accounts", {});
+      break;
+    case "check-api-key":
+      result = await run("account_check_api_key", {});
+      break;
+    case "deposit-address":
+      result = await run("account_get_deposit_address", { tokenId: f.tokenId });
+      break;
+    case "deposits":
+      result = await run("account_get_deposit_orders", {
+        tokenId: f.tokenId,
+        limit: f.limit ? Number(f.limit) : undefined,
+      });
+      break;
+    case "withdrawals":
+      result = await run("account_get_withdraw_orders", {
+        tokenId: f.tokenId,
+        limit: f.limit ? Number(f.limit) : undefined,
+      });
+      break;
+    case "audit":
+      result = await run("trade_get_history", { limit: f.limit ? Number(f.limit) : undefined });
+      break;
+    default:
+      process.stdout.write(`Unknown account subcommand: ${cli.subcommand}\nAvailable: balance, info, balance-flow, sub-accounts, check-api-key, deposit-address, deposits, withdrawals, audit\n`);
+      return;
+  }
+
+  process.stdout.write(formatJson(result, cli.json) + "\n");
+}

package/src/commands/config.ts

@@ -0,0 +1,64 @@
+import * as readline from "node:readline";
+import {
+  configFilePath,
+  readFullConfig,
+  writeFullConfig,
+} from "@toobit_agent/agent-toobitkit-core";
+import type { CliParsed } from "../parser.js";
+
+function prompt(question: string): Promise<string> {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+export async function handleConfigCommand(cli: CliParsed): Promise<void> {
+  switch (cli.subcommand) {
+    case "init": {
+      process.stdout.write("Toobit API Configuration Wizard\n\n");
+      const profileName = (await prompt("Profile name (default: live): ")) || "live";
+      const apiKey = await prompt("API Key: ");
+      const secretKey = await prompt("Secret Key: ");
+
+      if (!apiKey || !secretKey) {
+        process.stdout.write("API Key and Secret Key are required.\n");
+        return;
+      }
+
+      const config = readFullConfig();
+      config.default_profile = config.default_profile ?? profileName;
+      if (!config.profiles) config.profiles = {};
+      config.profiles[profileName] = { api_key: apiKey, secret_key: secretKey };
+      writeFullConfig(config);
+      process.stdout.write(`\n✓ Saved to ${configFilePath()}\n  Profile: ${profileName}\n`);
+      break;
+    }
+    case "show": {
+      const config = readFullConfig();
+      process.stdout.write(`Config file: ${configFilePath()}\n\n`);
+      process.stdout.write(`Default profile: ${config.default_profile ?? "(none)"}\n`);
+      process.stdout.write(`Profiles: ${Object.keys(config.profiles ?? {}).join(", ") || "(none)"}\n`);
+      break;
+    }
+    case "list-profiles":
+    case "list": {
+      const config = readFullConfig();
+      const profiles = Object.keys(config.profiles ?? {});
+      if (profiles.length === 0) {
+        process.stdout.write("No profiles configured.\n");
+      } else {
+        for (const name of profiles) {
+          const marker = name === config.default_profile ? " (default)" : "";
+          process.stdout.write(`  ${name}${marker}\n`);
+        }
+      }
+      break;
+    }
+    default:
+      process.stdout.write(`Unknown config subcommand: ${cli.subcommand}\nAvailable: init, show, list\n`);
+  }
+}

package/src/commands/futures.ts

@@ -0,0 +1,79 @@
+import type { ToolRunner } from "@toobit_agent/agent-toobitkit-core";
+import type { CliParsed } from "../parser.js";
+import { formatJson } from "../formatter.js";
+
+export async function handleFuturesCommand(cli: CliParsed, run: ToolRunner): Promise<void> {
+  const f = cli.flags;
+  let result;
+
+  switch (cli.subcommand) {
+    case "place":
+      result = await run("futures_place_order", {
+        symbol: f.symbol,
+        side: f.side,
+        orderType: f.orderType ?? f.type ?? "MARKET",
+        quantity: f.quantity,
+        price: f.price,
+        leverage: f.leverage,
+      });
+      break;
+    case "cancel":
+      result = await run("futures_cancel_order", { orderId: f.orderId, clientOrderId: f.clientOrderId });
+      break;
+    case "cancel-all":
+      result = await run("futures_cancel_all_orders", { symbol: f.symbol });
+      break;
+    case "amend":
+      result = await run("futures_amend_order", { orderId: f.orderId, quantity: f.quantity, price: f.price });
+      break;
+    case "get":
+      result = await run("futures_get_order", { orderId: f.orderId, clientOrderId: f.clientOrderId });
+      break;
+    case "orders":
+    case "open-orders":
+      result = await run("futures_get_open_orders", { symbol: f.symbol });
+      break;
+    case "history":
+      result = await run("futures_get_history_orders", {
+        symbol: f.symbol,
+        limit: f.limit ? Number(f.limit) : undefined,
+      });
+      break;
+    case "positions":
+      result = await run("futures_get_positions", { symbol: f.symbol });
+      break;
+    case "history-positions":
+      result = await run("futures_get_history_positions", { symbol: f.symbol });
+      break;
+    case "leverage":
+      if (f.leverage) {
+        result = await run("futures_set_leverage", { symbol: f.symbol, leverage: Number(f.leverage) });
+      } else {
+        result = await run("futures_get_leverage", { symbol: f.symbol });
+      }
+      break;
+    case "margin-type":
+      result = await run("futures_set_margin_type", { symbol: f.symbol, marginType: f.marginType });
+      break;
+    case "flash-close":
+      result = await run("futures_flash_close", { symbol: f.symbol, side: f.side });
+      break;
+    case "balance":
+      result = await run("futures_get_balance", {});
+      break;
+    case "fills":
+      result = await run("futures_get_fills", { symbol: f.symbol, limit: f.limit ? Number(f.limit) : undefined });
+      break;
+    case "pnl":
+      result = await run("futures_get_today_pnl", {});
+      break;
+    case "commission":
+      result = await run("futures_get_commission_rate", { symbol: f.symbol });
+      break;
+    default:
+      process.stdout.write(`Unknown futures subcommand: ${cli.subcommand}\nAvailable: place, cancel, cancel-all, amend, get, orders, history, positions, history-positions, leverage, margin-type, flash-close, balance, fills, pnl, commission\n`);
+      return;
+  }
+
+  process.stdout.write(formatJson(result, cli.json) + "\n");
+}

package/src/commands/market.ts

@@ -0,0 +1,71 @@
+import type { ToolRunner } from "@toobit_agent/agent-toobitkit-core";
+import type { CliParsed } from "../parser.js";
+import { formatJson } from "../formatter.js";
+
+export async function handleMarketCommand(cli: CliParsed, run: ToolRunner): Promise<void> {
+  const f = cli.flags;
+  let result;
+
+  switch (cli.subcommand) {
+    case "time":
+      result = await run("market_get_server_time", {});
+      break;
+    case "info":
+      result = await run("market_get_exchange_info", {});
+      break;
+    case "ticker":
+      result = await run("market_get_ticker_price", { symbol: f.symbol });
+      break;
+    case "ticker-24hr":
+      result = await run("market_get_ticker_24hr", { symbol: f.symbol });
+      break;
+    case "depth":
+      result = await run("market_get_depth", { symbol: f.symbol, limit: f.limit ? Number(f.limit) : undefined });
+      break;
+    case "trades":
+      result = await run("market_get_trades", { symbol: f.symbol, limit: f.limit ? Number(f.limit) : undefined });
+      break;
+    case "klines":
+    case "candles":
+      result = await run("market_get_klines", {
+        symbol: f.symbol,
+        interval: f.interval ?? f.bar ?? "1h",
+        limit: f.limit ? Number(f.limit) : undefined,
+        startTime: f.startTime ? Number(f.startTime) : undefined,
+        endTime: f.endTime ? Number(f.endTime) : undefined,
+      });
+      break;
+    case "book-ticker":
+      result = await run("market_get_book_ticker", { symbol: f.symbol });
+      break;
+    case "mark-price":
+      result = await run("market_get_mark_price", { symbol: f.symbol });
+      break;
+    case "funding-rate":
+      result = await run("market_get_funding_rate", { symbol: f.symbol });
+      break;
+    case "funding-rate-history":
+      result = await run("market_get_funding_rate_history", {
+        symbol: f.symbol,
+        limit: f.limit ? Number(f.limit) : undefined,
+      });
+      break;
+    case "open-interest":
+      result = await run("market_get_open_interest", { symbol: f.symbol });
+      break;
+    case "index":
+      result = await run("market_get_index_price", { symbol: f.symbol });
+      break;
+    case "contract-ticker":
+      result = await run("market_get_contract_ticker_24hr", { symbol: f.symbol });
+      break;
+    case "long-short-ratio":
+      result = await run("market_get_long_short_ratio", { symbol: f.symbol, period: f.period ?? "1h" });
+      break;
+    default:
+      process.stdout.write(`Unknown market subcommand: ${cli.subcommand}\nAvailable: time, info, ticker, ticker-24hr, depth, trades, klines, candles, book-ticker, mark-price, funding-rate, funding-rate-history, open-interest, index, contract-ticker, long-short-ratio\n`);
+      return;
+  }
+
+  process.stdout.write(formatJson(result, cli.json) + "\n");
+}

package/src/commands/spot.ts

@@ -0,0 +1,52 @@
+import type { ToolRunner } from "@toobit_agent/agent-toobitkit-core";
+import type { CliParsed } from "../parser.js";
+import { formatJson } from "../formatter.js";
+
+export async function handleSpotCommand(cli: CliParsed, run: ToolRunner): Promise<void> {
+  const f = cli.flags;
+  let result;
+
+  switch (cli.subcommand) {
+    case "place":
+      result = await run("spot_place_order", {
+        symbol: f.symbol,
+        side: f.side,
+        type: f.type ?? "MARKET",
+        quantity: f.quantity,
+        price: f.price,
+      });
+      break;
+    case "cancel":
+      result = await run("spot_cancel_order", { orderId: f.orderId, clientOrderId: f.clientOrderId });
+      break;
+    case "cancel-all":
+      result = await run("spot_cancel_open_orders", { symbol: f.symbol });
+      break;
+    case "get":
+      result = await run("spot_get_order", { orderId: f.orderId, clientOrderId: f.clientOrderId });
+      break;
+    case "open-orders":
+    case "orders":
+      result = await run("spot_get_open_orders", { symbol: f.symbol, limit: f.limit ? Number(f.limit) : undefined });
+      break;
+    case "history":
+      result = await run("spot_get_trade_orders", {
+        symbol: f.symbol,
+        limit: f.limit ? Number(f.limit) : undefined,
+        startTime: f.startTime ? Number(f.startTime) : undefined,
+        endTime: f.endTime ? Number(f.endTime) : undefined,
+      });
+      break;
+    case "fills":
+      result = await run("spot_get_fills", {
+        symbol: f.symbol,
+        limit: f.limit ? Number(f.limit) : undefined,
+      });
+      break;
+    default:
+      process.stdout.write(`Unknown spot subcommand: ${cli.subcommand}\nAvailable: place, cancel, cancel-all, get, orders, open-orders, history, fills\n`);
+      return;
+  }
+
+  process.stdout.write(formatJson(result, cli.json) + "\n");
+}

package/src/formatter.ts

@@ -0,0 +1,22 @@
+export function formatJson(data: unknown, json: boolean): string {
+  if (json) return JSON.stringify(data, null, 2);
+  if (data === null || data === undefined) return "No data.";
+  if (typeof data !== "object") return String(data);
+  return JSON.stringify(data, null, 2);
+}
+
+export function formatTable(rows: Record<string, unknown>[], columns?: string[]): string {
+  if (rows.length === 0) return "No data.";
+  const keys = columns ?? Object.keys(rows[0]);
+  const widths = keys.map((k) =>
+    Math.max(k.length, ...rows.map((r) => String(r[k] ?? "").length)),
+  );
+
+  const header = keys.map((k, i) => k.padEnd(widths[i])).join("  ");
+  const separator = widths.map((w) => "-".repeat(w)).join("  ");
+  const body = rows.map((row) =>
+    keys.map((k, i) => String(row[k] ?? "").padEnd(widths[i])).join("  "),
+  ).join("\n");
+
+  return `${header}\n${separator}\n${body}`;
+}

package/src/index.ts

@@ -0,0 +1,93 @@
+import {
+  loadConfig,
+  ToobitRestClient,
+  createToolRunner,
+  toToolErrorPayload,
+  configFilePath,
+} from "@toobit_agent/agent-toobitkit-core";
+import { parseCli } from "./parser.js";
+import { handleMarketCommand } from "./commands/market.js";
+import { handleSpotCommand } from "./commands/spot.js";
+import { handleFuturesCommand } from "./commands/futures.js";
+import { handleAccountCommand } from "./commands/account.js";
+import { handleConfigCommand } from "./commands/config.js";
+
+function printHelp(): void {
+  const help = `
+Toobit Trade CLI — Trade from your terminal
+
+Usage: toobit <command> <subcommand> [options]
+
+Commands:
+  market       Market data (ticker, depth, klines, funding-rate, etc.)
+  spot         Spot trading (place, cancel, orders, fills)
+  futures      USDT-M futures (place, cancel, positions, leverage, etc.)
+  account      Account info (balance, deposits, withdrawals, audit)
+  config       Configuration management (init, show, list)
+
+Global Options:
+  --profile <name>   Profile from ${configFilePath()}
+  --json             Output raw JSON
+  --read-only        Disable write operations
+  --help             Show this help
+
+Examples:
+  toobit market ticker --symbol BTCUSDT
+  toobit market candles --symbol BTCUSDT --interval 1h --limit 10
+  toobit market funding-rate --symbol BTCUSDT
+  toobit spot place --symbol BTCUSDT --side BUY --type MARKET --quantity 0.001
+  toobit futures positions --symbol BTCUSDT
+  toobit account balance
+  toobit config init
+`;
+  process.stdout.write(help);
+}
+
+async function main(): Promise<void> {
+  const cli = parseCli();
+
+  if (cli.command === "help" || cli.flags.help) {
+    printHelp();
+    return;
+  }
+
+  if (cli.command === "config") {
+    await handleConfigCommand(cli);
+    return;
+  }
+
+  const config = loadConfig({
+    modules: "all",
+    profile: cli.profile,
+    readOnly: cli.readOnly,
+    userAgent: "toobit-trade-cli/1.0.0",
+    sourceTag: "CLI",
+  });
+
+  const client = new ToobitRestClient(config);
+  const run = createToolRunner(client, config);
+
+  switch (cli.command) {
+    case "market":
+      await handleMarketCommand(cli, run);
+      break;
+    case "spot":
+      await handleSpotCommand(cli, run);
+      break;
+    case "futures":
+      await handleFuturesCommand(cli, run);
+      break;
+    case "account":
+      await handleAccountCommand(cli, run);
+      break;
+    default:
+      process.stdout.write(`Unknown command: ${cli.command}\n`);
+      printHelp();
+  }
+}
+
+main().catch((error: unknown) => {
+  const payload = toToolErrorPayload(error);
+  process.stderr.write(`${JSON.stringify(payload, null, 2)}\n`);
+  process.exitCode = 1;
+});

package/src/parser.ts

@@ -0,0 +1,79 @@
+import { parseArgs } from "node:util";
+
+export interface CliParsed {
+  command: string;
+  subcommand: string;
+  profile?: string;
+  json: boolean;
+  readOnly: boolean;
+  flags: Record<string, string | boolean | undefined>;
+  positionals: string[];
+}
+
+export function parseCli(argv = process.argv.slice(2)): CliParsed {
+  const STRING_OPTIONS = new Set([
+    "profile", "symbol", "interval", "limit", "side", "type",
+    "quantity", "price", "orderId", "clientOrderId", "leverage",
+    "orderType", "tokenId", "instId", "period", "bar",
+    "startTime", "endTime", "marginType",
+  ]);
+
+  let command = "help";
+  let subcommand = "";
+  const flagArgs: string[] = [];
+  let positionalCount = 0;
+
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg.startsWith("-")) {
+      flagArgs.push(arg);
+      const optName = arg.replace(/^--?/, "");
+      if (STRING_OPTIONS.has(optName) && i + 1 < argv.length && !argv[i + 1].startsWith("-")) {
+        flagArgs.push(argv[++i]);
+      }
+    } else {
+      if (positionalCount === 0) command = arg;
+      else if (positionalCount === 1) subcommand = arg;
+      positionalCount++;
+    }
+  }
+
+  const parsed = parseArgs({
+    args: flagArgs,
+    options: {
+      profile: { type: "string" },
+      json: { type: "boolean", default: false },
+      "read-only": { type: "boolean", default: false },
+      symbol: { type: "string" },
+      interval: { type: "string" },
+      limit: { type: "string" },
+      side: { type: "string" },
+      type: { type: "string" },
+      quantity: { type: "string" },
+      price: { type: "string" },
+      orderId: { type: "string" },
+      clientOrderId: { type: "string" },
+      leverage: { type: "string" },
+      orderType: { type: "string" },
+      tokenId: { type: "string" },
+      instId: { type: "string" },
+      period: { type: "string" },
+      bar: { type: "string" },
+      startTime: { type: "string" },
+      endTime: { type: "string" },
+      marginType: { type: "string" },
+    },
+    strict: false,
+    allowPositionals: true,
+  });
+
+  return {
+    command,
+    subcommand,
+    profile: parsed.values.profile as string | undefined,
+    json: (parsed.values.json as boolean) ?? false,
+    readOnly: (parsed.values["read-only"] as boolean) ?? false,
+    flags: parsed.values as Record<string, string | boolean | undefined>,
+    positionals: parsed.positionals as string[],
+  };
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"]
+}

package/tsup.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+  entry: ["src/index.ts"],
+  format: ["esm"],
+  dts: true,
+  clean: true,
+  banner: { js: "#!/usr/bin/env node" },
+});