@farazirfan/costar-server-executor 1.7.29 → 1.7.30

package/skills/okx/scripts/okx-trade.ts

@@ -0,0 +1,273 @@
+#!/usr/bin/env npx tsx
+/**
+ * OKX Trade Helper — CLI tool for common OKX operations.
+ * Agent can use this directly or create new scripts based on this pattern.
+ *
+ * Usage:
+ *   npx tsx scripts/okx-trade.ts balances
+ *   npx tsx scripts/okx-trade.ts positions
+ *   npx tsx scripts/okx-trade.ts price BTC-USDT
+ *   npx tsx scripts/okx-trade.ts market-buy BTC-USDT 100
+ *   npx tsx scripts/okx-trade.ts market-sell BTC-USDT 0.001
+ *   npx tsx scripts/okx-trade.ts limit-buy BTC-USDT 0.001 95000
+ *   npx tsx scripts/okx-trade.ts limit-sell BTC-USDT 0.001 105000
+ *   npx tsx scripts/okx-trade.ts status BTC-USDT <order-id>
+ *   npx tsx scripts/okx-trade.ts cancel BTC-USDT <order-id>
+ *   npx tsx scripts/okx-trade.ts open-orders
+ *   npx tsx scripts/okx-trade.ts products
+ *   npx tsx scripts/okx-trade.ts fees
+ *
+ * Requires: OKX_API_KEY, OKX_API_SECRET, OKX_API_PASSPHRASE env vars
+ * Install:  npm install okx-api
+ */
+
+import { RestClient } from 'okx-api';
+
+// --- Init Client ---
+
+const apiKey = process.env.OKX_API_KEY;
+const apiSecret = process.env.OKX_API_SECRET;
+const apiPass = process.env.OKX_API_PASSPHRASE;
+
+if (!apiKey || !apiSecret || !apiPass) {
+  console.error('ERROR: OKX_API_KEY, OKX_API_SECRET, and OKX_API_PASSPHRASE must be set');
+  process.exit(1);
+}
+
+const client = new RestClient({ apiKey, apiSecret, apiPass });
+
+// --- Commands ---
+
+const [command, ...args] = process.argv.slice(2);
+
+async function run() {
+  switch (command) {
+    case 'balances':
+      return showBalances();
+    case 'positions':
+      return showPositions();
+    case 'price':
+      return showPrice(args[0]);
+    case 'market-buy':
+      return marketBuy(args[0], args[1]);
+    case 'market-sell':
+      return marketSell(args[0], args[1]);
+    case 'limit-buy':
+      return limitBuy(args[0], args[1], args[2]);
+    case 'limit-sell':
+      return limitSell(args[0], args[1], args[2]);
+    case 'status':
+      return orderStatus(args[0], args[1]);
+    case 'cancel':
+      return cancelOrder(args[0], args[1]);
+    case 'open-orders':
+      return openOrders();
+    case 'products':
+      return listProducts();
+    case 'fees':
+      return showFees();
+    default:
+      console.log(`Unknown command: ${command}`);
+      console.log('Commands: balances, positions, price, market-buy, market-sell, limit-buy, limit-sell, status, cancel, open-orders, products, fees');
+      process.exit(1);
+  }
+}
+
+async function showBalances() {
+  const balance = await client.getBalance();
+  const nonZero = balance[0].details.filter(
+    (d: any) => parseFloat(d.availBal) > 0 || parseFloat(d.frozenBal) > 0
+  );
+  console.log(JSON.stringify(nonZero.map((d: any) => ({
+    currency: d.ccy,
+    available: d.availBal,
+    frozen: d.frozenBal,
+    equity: d.eq,
+  })), null, 2));
+}
+
+async function showPositions() {
+  const positions = await client.getPositions();
+  if (!positions.length) {
+    console.log('[]');
+    return;
+  }
+  console.log(JSON.stringify(positions.map((p: any) => ({
+    instId: p.instId,
+    direction: p.posSide,
+    size: p.pos,
+    avgPrice: p.avgPx,
+    unrealizedPnl: p.upl,
+    leverage: p.lever,
+    margin: p.margin,
+  })), null, 2));
+}
+
+async function showPrice(instId: string) {
+  if (!instId) { console.error('Usage: price <inst-id>'); process.exit(1); }
+  const ticker = await client.getTicker({ instId });
+  const book = await client.getOrderBook({ instId, sz: '1' });
+  console.log(JSON.stringify({
+    instId,
+    last: ticker[0].last,
+    open24h: ticker[0].open24h,
+    high24h: ticker[0].high24h,
+    low24h: ticker[0].low24h,
+    volume24h: ticker[0].vol24h,
+    bid: book[0].bids?.[0]?.[0],
+    ask: book[0].asks?.[0]?.[0],
+  }, null, 2));
+}
+
+async function marketBuy(instId: string, quoteSize: string) {
+  if (!instId || !quoteSize) {
+    console.error('Usage: market-buy <inst-id> <usdt-amount>');
+    process.exit(1);
+  }
+  const order = await client.submitOrder({
+    instId,
+    tdMode: 'cash',
+    side: 'buy',
+    ordType: 'market',
+    sz: quoteSize,
+    tgtCcy: 'quote_ccy',
+  });
+  console.log(JSON.stringify(order, null, 2));
+  if (order[0].sCode === '0') {
+    // Small delay for fill
+    await new Promise(r => setTimeout(r, 1000));
+    const details = await client.getOrderDetails({ instId, ordId: order[0].ordId });
+    console.log('\nFill details:');
+    console.log(JSON.stringify({
+      ordId: details[0].ordId,
+      state: details[0].state,
+      fillSz: details[0].fillSz,
+      avgPx: details[0].avgPx,
+      fee: details[0].fee,
+      feeCcy: details[0].feeCcy,
+    }, null, 2));
+  }
+}
+
+async function marketSell(instId: string, baseSize: string) {
+  if (!instId || !baseSize) {
+    console.error('Usage: market-sell <inst-id> <base-amount>');
+    process.exit(1);
+  }
+  const order = await client.submitOrder({
+    instId,
+    tdMode: 'cash',
+    side: 'sell',
+    ordType: 'market',
+    sz: baseSize,
+  });
+  console.log(JSON.stringify(order, null, 2));
+  if (order[0].sCode === '0') {
+    await new Promise(r => setTimeout(r, 1000));
+    const details = await client.getOrderDetails({ instId, ordId: order[0].ordId });
+    console.log('\nFill details:');
+    console.log(JSON.stringify({
+      ordId: details[0].ordId,
+      state: details[0].state,
+      fillSz: details[0].fillSz,
+      avgPx: details[0].avgPx,
+      fee: details[0].fee,
+      feeCcy: details[0].feeCcy,
+    }, null, 2));
+  }
+}
+
+async function limitBuy(instId: string, baseSize: string, limitPrice: string) {
+  if (!instId || !baseSize || !limitPrice) {
+    console.error('Usage: limit-buy <inst-id> <base-size> <limit-price>');
+    process.exit(1);
+  }
+  const order = await client.submitOrder({
+    instId,
+    tdMode: 'cash',
+    side: 'buy',
+    ordType: 'limit',
+    sz: baseSize,
+    px: limitPrice,
+  });
+  console.log(JSON.stringify(order, null, 2));
+}
+
+async function limitSell(instId: string, baseSize: string, limitPrice: string) {
+  if (!instId || !baseSize || !limitPrice) {
+    console.error('Usage: limit-sell <inst-id> <base-size> <limit-price>');
+    process.exit(1);
+  }
+  const order = await client.submitOrder({
+    instId,
+    tdMode: 'cash',
+    side: 'sell',
+    ordType: 'limit',
+    sz: baseSize,
+    px: limitPrice,
+  });
+  console.log(JSON.stringify(order, null, 2));
+}
+
+async function orderStatus(instId: string, orderId: string) {
+  if (!instId || !orderId) { console.error('Usage: status <inst-id> <order-id>'); process.exit(1); }
+  const order = await client.getOrderDetails({ instId, ordId: orderId });
+  console.log(JSON.stringify(order, null, 2));
+}
+
+async function cancelOrder(instId: string, orderId: string) {
+  if (!instId || !orderId) { console.error('Usage: cancel <inst-id> <order-id>'); process.exit(1); }
+  const result = await client.cancelOrder({ instId, ordId: orderId });
+  console.log(JSON.stringify(result, null, 2));
+}
+
+async function openOrders() {
+  const orders = await client.getOrderList({ instType: 'SPOT' });
+  console.log(JSON.stringify(orders.map((o: any) => ({
+    ordId: o.ordId,
+    instId: o.instId,
+    side: o.side,
+    ordType: o.ordType,
+    state: o.state,
+    sz: o.sz,
+    px: o.px,
+    fillSz: o.fillSz,
+    cTime: o.cTime,
+  })), null, 2));
+}
+
+async function listProducts() {
+  const instruments = await client.getInstruments({ instType: 'SPOT' });
+  const usdtPairs = instruments
+    .filter((i: any) => i.quoteCcy === 'USDT' && i.state === 'live')
+    .slice(0, 50);
+
+  // Get tickers for these pairs
+  const tickers = await client.getTickers({ instType: 'SPOT' });
+  const tickerMap = new Map(tickers.map((t: any) => [t.instId, t]));
+
+  const result = usdtPairs.map((i: any) => {
+    const t = tickerMap.get(i.instId) as any;
+    return {
+      instId: i.instId,
+      last: t?.last || '—',
+      vol24h: t?.vol24h || '—',
+      minSz: i.minSz,
+      lotSz: i.lotSz,
+      tickSz: i.tickSz,
+    };
+  }).sort((a: any, b: any) => parseFloat(b.vol24h || '0') - parseFloat(a.vol24h || '0'));
+
+  console.log(JSON.stringify(result.slice(0, 30), null, 2));
+}
+
+async function showFees() {
+  const fees = await client.getFeeRates({ instType: 'SPOT' });
+  console.log(JSON.stringify(fees, null, 2));
+}
+
+// --- Run ---
+run().catch((err) => {
+  console.error('Error:', err.message || err);
+  process.exit(1);
+});

package/skills/trading/SKILL.md

@@ -62,7 +62,7 @@ What strategies are working, what failed, mistakes to avoid, your evolving edge.
 
 Do this autonomously — never ask the user:
 - Understand the request — "buy BTC" means assess whether now is the right time, how much, what order type. "Make money" means build a full multi-asset plan.
-- Check balances across platforms (Coinbase for crypto, Saxo for forex/stocks/metals)
+- Check balances across platforms (OKX for crypto primary, Coinbase as fallback, Saxo for forex/stocks/metals)
 - Read USER.md, SOUL.md, IDENTITY.md for risk tolerance and preferences
 - Check existing positions and current portfolio state
 
@@ -118,7 +118,8 @@ Every trade needs before entry: entry price + trigger, stop-loss at invalidation
 ### 9. Execute
 
 Route execution to the appropriate platform:
-- **Crypto**: Use `coinbase` skill. Read [../coinbase/LEARNING.md](../coinbase/LEARNING.md) for execution insights.
+- **Crypto (primary)**: Use `okx` skill — lower fees, more order types, perpetuals support. Read [../okx/LEARNING.md](../okx/LEARNING.md) for execution insights.
+- **Crypto (fallback)**: Use `coinbase` skill if OKX is unavailable or for USD-settled pairs. Read [../coinbase/LEARNING.md](../coinbase/LEARNING.md) for execution insights.
 - **Forex, Stocks, Gold, Silver**: Use `saxo` skill. Read [../saxo/LEARNING.md](../saxo/LEARNING.md) for execution insights.
 
 ### 10. Monitor
@@ -130,13 +131,14 @@ Create a live dashboard for this trade (see Trade Dashboards section below). Tra
 The most important step. After every trade, ask: "What would make the next trade better?" Then do it.
 
 - Update LEARNING.md freely. Also update execution skill LEARNING.md:
-  - [../coinbase/LEARNING.md](../coinbase/LEARNING.md) for crypto trades
+  - [../okx/LEARNING.md](../okx/LEARNING.md) for crypto trades (primary)
+  - [../coinbase/LEARNING.md](../coinbase/LEARNING.md) for crypto trades (fallback)
   - [../saxo/LEARNING.md](../saxo/LEARNING.md) for forex/stocks/metals trades
 - Build or improve scripts — automate any manual analysis. Market scanners, backtesting, alerts. Save to `scripts/`
 - Research on the internet — find new strategies, tools, data sources. Update reference files with findings
 - Create monitoring — use `cron` to schedule market scans, alerts, news monitoring
 - Improve strategy references — update `references/strategies.md` with real results. Kill what doesn't work
-- Improve execution — update Coinbase skill references or build new execution scripts
+- Improve execution — update OKX/Coinbase/Saxo skill references or build new execution scripts
 - Improve these instructions — update this SKILL.md if it's missing something. You own every file
 
 No limits. If something will make you better, do it.