openbroker 1.3.2 → 1.5.0

package/dist/info/order-status.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env npx tsx
+// Check status of a specific order on Hyperliquid
+import { getClient } from '../core/client.js';
+import { formatUsd, parseArgs } from '../core/utils.js';
+function printUsage() {
+    console.log(`
+Usage: openbroker order-status --oid <order-id>
+
+Options:
+  --oid <id>          Order ID (number) or client order ID (hex string) — required
+  --address <0x...>   Look up order on another account
+  --json              Output as JSON (machine-readable)
+  --help, -h          Show this help
+
+Examples:
+  openbroker order-status --oid 123456789
+  openbroker order-status --oid 0x1234abcd...
+  openbroker order-status --oid 123456789 --address 0xabc...
+`);
+}
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    if (args.help || args.h) {
+        printUsage();
+        process.exit(0);
+    }
+    const oidArg = args.oid;
+    if (!oidArg) {
+        console.error('Error: --oid is required');
+        printUsage();
+        process.exit(1);
+    }
+    const oid = oidArg.startsWith('0x') ? oidArg : parseInt(oidArg);
+    const targetAddress = args.address;
+    const jsonOutput = args.json;
+    const client = getClient();
+    const lookupAddress = targetAddress?.toLowerCase();
+    if (!jsonOutput) {
+        console.log('Open Broker - Order Status');
+        console.log('=========================\n');
+    }
+    try {
+        const result = await client.getOrderStatus(oid, lookupAddress);
+        if (jsonOutput) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        if (result.status === 'unknownOid') {
+            console.log(`Order ${oidArg} not found`);
+            return;
+        }
+        if (result.order) {
+            const o = result.order.order;
+            const time = new Date(o.timestamp).toLocaleString();
+            const statusTime = new Date(result.order.statusTimestamp).toLocaleString();
+            const side = o.side === 'B' ? 'BUY' : 'SELL';
+            console.log(`${o.coin} - ${o.orderType}`);
+            console.log('─'.repeat(40));
+            console.log(`Order ID:       ${o.oid}`);
+            if (o.cloid)
+                console.log(`Client OID:     ${o.cloid}`);
+            console.log(`Side:           ${side}`);
+            console.log(`Size:           ${o.sz} (orig: ${o.origSz})`);
+            console.log(`Limit Price:    ${formatUsd(parseFloat(o.limitPx))}`);
+            console.log(`Type:           ${o.orderType}`);
+            if (o.tif)
+                console.log(`Time in Force:  ${o.tif}`);
+            console.log(`Reduce Only:    ${o.reduceOnly ? 'Yes' : 'No'}`);
+            if (o.isTrigger) {
+                console.log(`Trigger Price:  ${formatUsd(parseFloat(o.triggerPx))}`);
+                console.log(`Trigger Cond:   ${o.triggerCondition}`);
+            }
+            if (o.isPositionTpsl)
+                console.log(`Position TP/SL: Yes`);
+            console.log(`Status:         ${result.order.status}`);
+            console.log(`Created:        ${time}`);
+            console.log(`Status Updated: ${statusTime}`);
+        }
+    }
+    catch (error) {
+        console.error('Error fetching order status:', error);
+        process.exit(1);
+    }
+}
+main();

package/dist/info/orders.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env npx tsx
+export {};
+//# sourceMappingURL=orders.d.ts.map

package/dist/info/orders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orders.d.ts","sourceRoot":"","sources":["../../scripts/info/orders.ts"],"names":[],"mappings":""}

package/dist/info/orders.js

@@ -0,0 +1,162 @@
+#!/usr/bin/env npx tsx
+// View historical orders from Hyperliquid
+import { getClient } from '../core/client.js';
+import { formatUsd, parseArgs, normalizeCoin } from '../core/utils.js';
+function printUsage() {
+    console.log(`
+Usage: openbroker orders [options]
+
+Options:
+  --coin <symbol>     Filter by coin (e.g. ETH, BTC)
+  --status <status>   Filter by status (filled, canceled, open, triggered, rejected, etc.)
+  --open              Show only currently open orders
+  --top <n>           Show last N orders (default: 20)
+  --address <0x...>   Look up another account's orders
+  --help, -h          Show this help
+
+Examples:
+  openbroker orders
+  openbroker orders --open
+  openbroker orders --open --coin ETH
+  openbroker orders --coin ETH --status filled
+  openbroker orders --top 50
+  openbroker orders --address 0xabc... --open
+`);
+}
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    if (args.help || args.h) {
+        printUsage();
+        process.exit(0);
+    }
+    const filterCoin = args.coin;
+    const filterStatus = args.status;
+    const openOnly = args.open;
+    const top = parseInt(args.top) || 20;
+    const jsonOutput = args.json;
+    const targetAddress = args.address;
+    const client = getClient();
+    const lookupAddress = targetAddress?.toLowerCase();
+    try {
+        // On testnet, load specific HIP-3 dex on demand if filtering by dex:COIN
+        if (client.isTestnet && filterCoin?.includes(':')) {
+            await client.loadSingleHip3Dex(filterCoin.split(':')[0]);
+        }
+        if (openOnly) {
+            // Use the dedicated open orders endpoint
+            let openOrders = await client.getOpenOrders(lookupAddress);
+            if (filterCoin) {
+                openOrders = openOrders.filter(o => o.coin === normalizeCoin(filterCoin));
+            }
+            openOrders.sort((a, b) => b.timestamp - a.timestamp);
+            openOrders = openOrders.slice(0, top);
+            if (jsonOutput) {
+                console.log(JSON.stringify(openOrders.map(o => ({
+                    time: new Date(o.timestamp).toISOString(),
+                    coin: o.coin,
+                    side: o.side === 'B' ? 'buy' : 'sell',
+                    orderType: o.orderType,
+                    size: o.sz,
+                    origSize: o.origSz,
+                    price: o.limitPx,
+                    status: 'open',
+                    oid: o.oid,
+                })), null, 2));
+                return;
+            }
+            console.log('Open Broker - Open Orders');
+            console.log('=========================\n');
+            if (targetAddress) {
+                console.log(`Lookup: ${lookupAddress}\n`);
+            }
+            if (openOrders.length === 0) {
+                console.log('No open orders found');
+                return;
+            }
+            // Table header
+            console.log('Time'.padEnd(20) +
+                'Coin'.padEnd(10) +
+                'Side'.padEnd(6) +
+                'Type'.padEnd(14) +
+                'Size'.padEnd(12) +
+                'Price'.padEnd(14) +
+                'OID');
+            console.log('─'.repeat(90));
+            for (const o of openOrders) {
+                const time = new Date(o.timestamp).toLocaleString();
+                const side = o.side === 'B' ? 'BUY' : 'SELL';
+                console.log(time.padEnd(20) +
+                    o.coin.padEnd(10) +
+                    side.padEnd(6) +
+                    o.orderType.padEnd(14) +
+                    o.sz.padEnd(12) +
+                    formatUsd(parseFloat(o.limitPx)).padEnd(14) +
+                    String(o.oid));
+            }
+            console.log('─'.repeat(90));
+            console.log(`Showing ${openOrders.length} open orders`);
+            return;
+        }
+        let orders = await client.getHistoricalOrders(lookupAddress);
+        if (filterCoin) {
+            orders = orders.filter(o => o.order.coin === normalizeCoin(filterCoin));
+        }
+        if (filterStatus) {
+            const s = filterStatus.toLowerCase();
+            orders = orders.filter(o => o.status.toLowerCase().includes(s));
+        }
+        // Most recent first
+        orders.sort((a, b) => b.order.timestamp - a.order.timestamp);
+        orders = orders.slice(0, top);
+        if (jsonOutput) {
+            console.log(JSON.stringify(orders.map(entry => ({
+                time: new Date(entry.order.timestamp).toISOString(),
+                coin: entry.order.coin,
+                side: entry.order.side === 'B' ? 'buy' : 'sell',
+                orderType: entry.order.orderType,
+                size: entry.order.sz,
+                price: entry.order.limitPx,
+                status: entry.status,
+                oid: entry.order.oid,
+            })), null, 2));
+            return;
+        }
+        console.log('Open Broker - Order History');
+        console.log('==========================\n');
+        if (targetAddress) {
+            console.log(`Lookup: ${lookupAddress}\n`);
+        }
+        if (orders.length === 0) {
+            console.log('No orders found');
+            return;
+        }
+        // Table header
+        console.log('Time'.padEnd(20) +
+            'Coin'.padEnd(10) +
+            'Side'.padEnd(6) +
+            'Type'.padEnd(14) +
+            'Size'.padEnd(12) +
+            'Price'.padEnd(14) +
+            'Status');
+        console.log('─'.repeat(90));
+        for (const entry of orders) {
+            const o = entry.order;
+            const time = new Date(o.timestamp).toLocaleString();
+            const side = o.side === 'B' ? 'BUY' : 'SELL';
+            console.log(time.padEnd(20) +
+                o.coin.padEnd(10) +
+                side.padEnd(6) +
+                o.orderType.padEnd(14) +
+                o.sz.padEnd(12) +
+                formatUsd(parseFloat(o.limitPx)).padEnd(14) +
+                entry.status);
+        }
+        console.log('─'.repeat(90));
+        console.log(`Showing ${orders.length} orders`);
+    }
+    catch (error) {
+        console.error('Error fetching orders:', error);
+        process.exit(1);
+    }
+}
+main();

package/dist/info/outcomes.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env tsx
+export {};
+//# sourceMappingURL=outcomes.d.ts.map

package/dist/info/outcomes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcomes.d.ts","sourceRoot":"","sources":["../../scripts/info/outcomes.ts"],"names":[],"mappings":""}

package/dist/info/outcomes.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env tsx
+// HIP-4 Outcomes - search and inspect prediction markets
+import { getClient } from '../core/client.js';
+function parseArgs() {
+    const args = {};
+    for (let i = 2; i < process.argv.length; i++) {
+        const arg = process.argv[i];
+        if ((arg === '--query' || arg === '-q') && process.argv[i + 1]) {
+            args.query = process.argv[++i];
+        }
+        else if ((arg === '--outcome' || arg === '--id') && process.argv[i + 1]) {
+            args.outcome = process.argv[++i];
+        }
+        else if (arg === '--side' && process.argv[i + 1]) {
+            args.side = process.argv[++i];
+        }
+        else if (arg === '--balances') {
+            args.balances = true;
+        }
+        else if (arg === '--top' && process.argv[i + 1]) {
+            args.top = parseInt(process.argv[++i], 10);
+        }
+        else if (arg === '--verbose') {
+            args.verbose = true;
+        }
+        else if (arg === '--json') {
+            args.json = true;
+        }
+        else if (arg === '--help' || arg === '-h') {
+            printUsage();
+            process.exit(0);
+        }
+        else if (!args.query && !arg.startsWith('-')) {
+            args.query = arg;
+        }
+    }
+    return args;
+}
+function printUsage() {
+    console.log(`
+Open Broker - HIP-4 Outcomes
+============================
+
+Search and inspect Hyperliquid outcome markets.
+
+Usage:
+  openbroker outcomes [--query <text>] [--outcome <id|#encoding|+encoding>] [options]
+
+Options:
+  --query, -q <text>       Search market name, description, underlying, expiry, target
+  --outcome, --id <ref>    Show one outcome by id or encoded coin (#1230 / +1230)
+  --side <yes|no|0|1>      Select a side when using a plain outcome id
+  --balances               Show outcome token balances for the configured account
+  --top <n>                Show only top N matches
+  --json                   Output as JSON
+  --verbose                Include raw descriptions and question metadata
+
+Examples:
+  openbroker outcomes --query BTC
+  openbroker outcomes --outcome 123
+  openbroker outcomes --outcome 123 --side yes --json
+  openbroker outcomes --balances
+`);
+}
+function formatPrice(value) {
+    if (!value)
+        return '-';
+    const n = parseFloat(value);
+    if (!Number.isFinite(n))
+        return value;
+    return n.toFixed(4);
+}
+function formatVolume(value) {
+    if (!value)
+        return '-';
+    const n = parseFloat(value);
+    if (!Number.isFinite(n))
+        return value;
+    if (n >= 1_000_000)
+        return `$${(n / 1_000_000).toFixed(2)}M`;
+    if (n >= 1_000)
+        return `$${(n / 1_000).toFixed(2)}K`;
+    return `$${n.toFixed(2)}`;
+}
+async function main() {
+    const args = parseArgs();
+    const client = getClient();
+    client.verbose = args.verbose ?? false;
+    if (!args.json) {
+        console.log('Open Broker - HIP-4 Outcomes');
+        console.log('============================\n');
+    }
+    try {
+        if (args.balances) {
+            const balances = await client.getSpotBalances();
+            const outcomeBalances = (balances.balances ?? []).filter((b) => b.coin.startsWith('+') || b.coin.startsWith('#'));
+            if (args.json) {
+                console.log(JSON.stringify(outcomeBalances, null, 2));
+                return;
+            }
+            if (outcomeBalances.length === 0) {
+                console.log('No outcome token balances found.');
+                return;
+            }
+            console.log('Outcome Balances');
+            console.log('----------------');
+            console.log('Token        Total              Hold               Entry Value');
+            console.log('-'.repeat(70));
+            for (const b of outcomeBalances) {
+                console.log(`${b.coin.padEnd(12)} ${parseFloat(b.total).toFixed(6).padStart(18)} ` +
+                    `${parseFloat(b.hold).toFixed(6).padStart(18)} ${formatVolume(b.entryNtl).padStart(15)}`);
+            }
+            return;
+        }
+        let markets = await client.getOutcomeMarkets();
+        if (args.outcome) {
+            const resolved = client.resolveOutcomeRef(args.outcome, args.side);
+            markets = markets.filter((market) => market.outcome === resolved.outcome);
+            for (const market of markets) {
+                market.sides = market.sides.filter((side) => side.side === resolved.side);
+            }
+        }
+        if (args.query) {
+            const query = args.query.toUpperCase();
+            markets = markets.filter((market) => {
+                const parsed = Object.values(market.parsedDescription).join(' ');
+                const searchable = `${market.name} ${market.description} ${parsed}`.toUpperCase();
+                return searchable.includes(query);
+            });
+        }
+        markets.sort((a, b) => {
+            const aVol = Math.max(...a.sides.map((s) => parseFloat(s.dayNtlVlm ?? '0')));
+            const bVol = Math.max(...b.sides.map((s) => parseFloat(s.dayNtlVlm ?? '0')));
+            return bVol - aVol;
+        });
+        const displayMarkets = args.top ? markets.slice(0, args.top) : markets;
+        if (args.json) {
+            console.log(JSON.stringify(displayMarkets, null, 2));
+            return;
+        }
+        if (displayMarkets.length === 0) {
+            console.log('No outcome markets found.');
+            return;
+        }
+        console.log(`Found ${displayMarkets.length} outcome market(s)\n`);
+        console.log('Outcome   Side  Coin       AssetID      Price    24h Volume   Market');
+        console.log('-'.repeat(98));
+        for (const market of displayMarkets) {
+            const spec = market.parsedDescription;
+            const labelParts = [
+                spec.underlying,
+                spec.expiry ? `exp ${spec.expiry}` : undefined,
+                spec.targetPrice ? `target ${spec.targetPrice}` : undefined,
+            ].filter(Boolean);
+            const label = labelParts.length > 0 ? labelParts.join(' | ') : market.description;
+            for (const side of market.sides) {
+                console.log(`${String(market.outcome).padStart(7)}   ${side.name.padEnd(4)}  ${side.coin.padEnd(9)} ` +
+                    `${String(side.assetId).padStart(10)}   ${formatPrice(side.midPx ?? side.markPx).padStart(7)} ` +
+                    `${formatVolume(side.dayNtlVlm).padStart(13)}   ${label}`);
+            }
+            if (args.verbose) {
+                console.log(`          Description: ${market.description}`);
+                if (market.question)
+                    console.log(`          Question: ${market.question.name}`);
+            }
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`Error: ${message}`);
+        console.error('Note: Hyperliquid currently documents outcomeMeta as testnet-only.');
+        process.exit(1);
+    }
+}
+main();

package/dist/info/positions.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env npx tsx
+export {};
+//# sourceMappingURL=positions.d.ts.map

package/dist/info/positions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positions.d.ts","sourceRoot":"","sources":["../../scripts/info/positions.ts"],"names":[],"mappings":""}

package/dist/info/positions.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env npx tsx
+// Get detailed position info from Hyperliquid
+import { getClient } from '../core/client.js';
+import { formatUsd, formatPercent, parseArgs } from '../core/utils.js';
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    const filterCoin = args.coin;
+    const jsonOutput = args.json;
+    const targetAddress = args.address;
+    const client = getClient();
+    if (args.verbose) {
+        client.verbose = true;
+    }
+    const lookupAddress = targetAddress?.toLowerCase();
+    const isOtherAccount = !!targetAddress;
+    try {
+        const [state, mids, fundingHistory] = await Promise.all([
+            client.getUserStateAll(lookupAddress),
+            client.getAllMids(),
+            client.getUserFunding(lookupAddress),
+        ]);
+        const positions = state.assetPositions.filter(ap => {
+            const size = parseFloat(ap.position.szi);
+            if (Math.abs(size) < 0.0001)
+                return false;
+            if (filterCoin && ap.position.coin !== filterCoin)
+                return false;
+            return true;
+        });
+        // Sum cumulative funding per coin
+        const fundingByCoin = new Map();
+        for (const entry of fundingHistory) {
+            const coin = entry.delta.coin;
+            const usdc = parseFloat(entry.delta.usdc);
+            fundingByCoin.set(coin, (fundingByCoin.get(coin) ?? 0) + usdc);
+        }
+        // JSON output
+        if (jsonOutput) {
+            const result = positions.map(ap => {
+                const pos = ap.position;
+                const size = parseFloat(pos.szi);
+                const markPx = parseFloat(mids[pos.coin] || '0');
+                const liqPx = pos.liquidationPx ? parseFloat(pos.liquidationPx) : null;
+                return {
+                    coin: pos.coin,
+                    side: size > 0 ? 'long' : 'short',
+                    size: pos.szi,
+                    entryPrice: pos.entryPx,
+                    markPrice: markPx,
+                    notional: Math.abs(parseFloat(pos.positionValue)),
+                    unrealizedPnl: parseFloat(pos.unrealizedPnl),
+                    returnOnEquity: parseFloat(pos.returnOnEquity),
+                    cumulativeFunding: fundingByCoin.get(pos.coin) ?? 0,
+                    marginUsed: parseFloat(pos.marginUsed),
+                    leverage: `${pos.leverage.value}x`,
+                    leverageType: pos.leverage.type,
+                    liquidationPrice: liqPx,
+                    liquidationDistance: liqPx && markPx ? Math.abs((markPx - liqPx) / markPx) : null,
+                    maxLeverage: pos.maxLeverage,
+                };
+            });
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        // Human-readable output
+        console.log('Open Broker - Positions');
+        console.log('=======================\n');
+        if (isOtherAccount) {
+            console.log(`Lookup: ${lookupAddress}\n`);
+        }
+        if (positions.length === 0) {
+            console.log(filterCoin ? `No position in ${filterCoin}` : 'No open positions');
+            if (!filterCoin && !isOtherAccount && !client.isApiWallet) {
+                console.log('\n⚠️  If this account is traded via an API wallet, set HYPERLIQUID_ACCOUNT_ADDRESS');
+                console.log('   in ~/.openbroker/.env to the master account address.');
+            }
+            return;
+        }
+        for (const ap of positions) {
+            const pos = ap.position;
+            const size = parseFloat(pos.szi);
+            const entryPx = parseFloat(pos.entryPx);
+            const notional = parseFloat(pos.positionValue);
+            const pnl = parseFloat(pos.unrealizedPnl);
+            const marginUsed = parseFloat(pos.marginUsed);
+            const roe = parseFloat(pos.returnOnEquity);
+            const markPx = parseFloat(mids[pos.coin] || '0');
+            const side = size > 0 ? 'LONG' : 'SHORT';
+            const sideEmoji = size > 0 ? '+' : '-';
+            const cumulativeFunding = fundingByCoin.get(pos.coin) ?? 0;
+            console.log(`${pos.coin} - ${side}`);
+            console.log('─'.repeat(40));
+            console.log(`Size:           ${sideEmoji}${Math.abs(size).toFixed(6)}`);
+            console.log(`Entry Price:    ${formatUsd(entryPx)}`);
+            console.log(`Mark Price:     ${formatUsd(markPx)}`);
+            console.log(`Notional:       ${formatUsd(Math.abs(notional))}`);
+            console.log(`Unrealized PnL: ${formatUsd(pnl)} (${formatPercent(roe)})`);
+            console.log(`Cum. Funding:   ${formatUsd(cumulativeFunding)}${cumulativeFunding >= 0 ? ' (received)' : ' (paid)'}`);
+            console.log(`Margin Used:    ${formatUsd(marginUsed)}`);
+            console.log(`Leverage:       ${pos.leverage.value}x (${pos.leverage.type})`);
+            if (pos.liquidationPx) {
+                const liqPx = parseFloat(pos.liquidationPx);
+                const liqDistance = Math.abs((markPx - liqPx) / markPx);
+                console.log(`Liquidation:    ${formatUsd(liqPx)} (${formatPercent(liqDistance)} away)`);
+            }
+            console.log(`Max Leverage:   ${pos.maxLeverage}x`);
+            console.log('');
+        }
+        // Summary
+        const totalFunding = Array.from(fundingByCoin.values()).reduce((sum, v) => sum + v, 0);
+        if (positions.length > 1) {
+            const totalPnl = positions.reduce((sum, ap) => sum + parseFloat(ap.position.unrealizedPnl), 0);
+            const totalNotional = positions.reduce((sum, ap) => sum + Math.abs(parseFloat(ap.position.positionValue)), 0);
+            console.log('Summary');
+            console.log('─'.repeat(40));
+            console.log(`Total Positions: ${positions.length}`);
+            console.log(`Total Notional:  ${formatUsd(totalNotional)}`);
+            console.log(`Total PnL:       ${formatUsd(totalPnl)}`);
+            console.log(`Total Funding:   ${formatUsd(totalFunding)}${totalFunding >= 0 ? ' (received)' : ' (paid)'}`);
+        }
+    }
+    catch (error) {
+        console.error('Error fetching positions:', error);
+        process.exit(1);
+    }
+}
+main();

package/dist/info/rate-limit.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env npx tsx
+export {};
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/info/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../scripts/info/rate-limit.ts"],"names":[],"mappings":""}

package/dist/info/rate-limit.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env npx tsx
+// View API rate limit status on Hyperliquid
+import { getClient } from '../core/client.js';
+import { formatUsd, parseArgs } from '../core/utils.js';
+function printUsage() {
+    console.log(`
+Usage: openbroker rate-limit [options]
+
+Options:
+  --json        Output as JSON (machine-readable)
+  --help, -h    Show this help
+
+Examples:
+  openbroker rate-limit
+`);
+}
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    if (args.help || args.h) {
+        printUsage();
+        process.exit(0);
+    }
+    const jsonOutput = args.json;
+    const client = getClient();
+    if (!jsonOutput) {
+        console.log('Open Broker - API Rate Limit');
+        console.log('===========================\n');
+    }
+    try {
+        const rl = await client.getUserRateLimit();
+        if (jsonOutput) {
+            console.log(JSON.stringify(rl, null, 2));
+            return;
+        }
+        const used = rl.nRequestsUsed;
+        const cap = rl.nRequestsCap;
+        const surplus = rl.nRequestsSurplus;
+        const pct = cap > 0 ? (used / cap * 100) : 0;
+        // Progress bar
+        const barWidth = 30;
+        const filled = Math.round(barWidth * Math.min(pct, 100) / 100);
+        const bar = '\u2588'.repeat(filled) + '\u2591'.repeat(barWidth - filled);
+        console.log('Rate Limit Status');
+        console.log('─'.repeat(40));
+        console.log(`Requests Used:    ${used.toLocaleString()} / ${cap.toLocaleString()}`);
+        console.log(`Usage:            [${bar}] ${pct.toFixed(1)}%`);
+        console.log(`Surplus:          ${surplus.toLocaleString()}`);
+        console.log(`Cum. Volume:      ${formatUsd(parseFloat(rl.cumVlm))}`);
+        if (pct > 80) {
+            console.log('\nWarning: API usage above 80% of capacity');
+        }
+    }
+    catch (error) {
+        console.error('Error fetching rate limit:', error);
+        process.exit(1);
+    }
+}
+main();

package/dist/info/search-markets.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env tsx
+export {};
+//# sourceMappingURL=search-markets.d.ts.map

package/dist/info/search-markets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-markets.d.ts","sourceRoot":"","sources":["../../scripts/info/search-markets.ts"],"names":[],"mappings":""}