TacoClaw Trading Platform Skill

Setup

Config is stored at ~/.openclaw/workspace/tacoclaw/config.json. Unlike the base taco skill, this skill connects to TacoClaw natively and does not require explicit trader_ids per exchange.

{
  "user_id": "<tacoclaw user id>",
  "api_token": "<tacoclaw api token>"
}

If config does not exist, ask the user for user_id and api_token, or run:

node scripts/tacoclaw_client.js init

Before any authenticated API call, check that ~/.openclaw/workspace/tacoclaw/config.json exists. If not, guide the user through setup first.

Runtime Requirement

Use the CLI at scripts/tacoclaw_client.js.

Before running it:

1. Detect Node.js:

command -v node

2. Ensure Node.js is v18+ because the script uses native fetch.

node --version

Usage

Run commands from this skill directory unless using absolute paths:

node scripts/tacoclaw_client.js <command> [options]

Config defaults to ~/.openclaw/workspace/tacoclaw/config.json. Override with --config <path> if needed.

Commands

Initialize config

node scripts/tacoclaw_client.js init

Open position

node scripts/tacoclaw_client.js open-position \
  --exchange Taco --symbol BTCUSDT --notional 100 --side Long \
  --leverage 3 --stop-loss 80000 --take-profit 100000

• --side can be Long or Short.
• --notional is the position size in USDT.
• --stop-loss, --take-profit, --limit-price, and --leverage are optional.

Close position

node scripts/tacoclaw_client.js close-position \
  --exchange Taco --symbol BTCUSDT --notional 100 --side Short

Optional: --limit-price <price>

Set leverage

node scripts/tacoclaw_client.js set-leverage \
  --exchange Taco --symbol BTCUSDT --leverage 5

Set margin mode

# Cross margin
node scripts/tacoclaw_client.js set-margin-mode \
  --exchange Taco --symbol BTCUSDT --cross

# Isolated margin
node scripts/tacoclaw_client.js set-margin-mode \
  --exchange Taco --symbol BTCUSDT

Set stop loss / take profit

node scripts/tacoclaw_client.js set-stop-loss \
  --exchange Taco --symbol BTCUSDT --side Long --notional 100 --price 85000

node scripts/tacoclaw_client.js set-take-profit \
  --exchange Taco --symbol BTCUSDT --side Long --notional 100 --price 95000

Cancel orders

node scripts/tacoclaw_client.js cancel-stop-loss --exchange Taco --symbol BTCUSDT
node scripts/tacoclaw_client.js cancel-take-profit --exchange Taco --symbol BTCUSDT
node scripts/tacoclaw_client.js cancel-stops --exchange Taco --symbol BTCUSDT
node scripts/tacoclaw_client.js cancel-all --exchange Taco --symbol BTCUSDT
node scripts/tacoclaw_client.js cancel-order --exchange Taco --symbol BTCUSDT --order-id "12345"

Get filled order

node scripts/tacoclaw_client.js get-filled-order \
  --exchange Taco --symbol BTCUSDT --order-id "12345"

Add --algo if the order ID is an algorithmic order ID.

Get positions

Returns all open positions for the specified exchange.

node scripts/tacoclaw_client.js get-positions --exchange Taco

Get open orders

Returns all open orders for the specified exchange.

node scripts/tacoclaw_client.js get-open-orders --exchange Taco

Get kline data

No auth required. Returns up to 100 klines per request.

node scripts/tacoclaw_client.js get-kline \
  --exchange Taco --symbol BTCUSDT --interval 1h

Optional:

• --start-time <unix_ms>
• --end-time <unix_ms>

Valid intervals: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M