AiCoin

Crypto data & trading toolkit powered by AiCoin Open API.

Version: 1.5.21 | Last Updated: 2026-03-04

Data Sources: AiCoin aggregates data from 200+ exchanges. Price data is real-time, K-lines updated every second, funding rates every 8h.

Supported Exchanges for Trading: Binance, OKX, Bybit, Bitget, Gate.io, HTX, KuCoin, MEXC, Coinbase (requires API keys in

.env

Quick Start Examples:

# Check BTC price
node scripts/coin.mjs coin_ticker '{"coin_list":"bitcoin"}'

# Get 1h K-line
node scripts/market.mjs kline '{"symbol":"btcusdt:okex","period":"3600","size":"10"}'

# Check balance (requires exchange API keys)
node scripts/exchange.mjs balance '{"exchange":"okx"}'

Quick Reference — Most Common Commands

Run all scripts from the aicoin skill directory. Use

exec

tool, NOT

process

. API keys are pre-configured. Do NOT ask the user for keys. Do NOT run

env

/

printenv

. Do NOT use curl, web_fetch, or browser for crypto data. Always use these scripts. 🚨 TRADING SAFETY: NEVER place orders without user confirmation. ALWAYS show order details and ask "确认下单？" FIRST. NEVER auto-adjust order size or parameters. ⚡ PERFORMANCE: Use batch queries when possible.

coin_ticker

supports multiple coins in one call (e.g.,

"coin_list":"bitcoin,ethereum,solana"

).

node scripts/coin.mjs coin_ticker '{"coin_list":"bitcoin"}'

node scripts/coin.mjs coin_ticker '{"coin_list":"bitcoin,ethereum,solana"}'

node scripts/market.mjs kline '{"symbol":"btcusdt:okex","period":"3600","size":"100"}'

node scripts/coin.mjs funding_rate '{"symbol":"BTC"}'

node scripts/exchange.mjs funding_rate '{"exchange":"binance","symbol":"ETH/USDT:USDT"}'

node scripts/coin.mjs open_interest '{"symbol":"BTC","interval":"15m"}'

node scripts/features.mjs ls_ratio

node scripts/features.mjs big_orders '{"symbol":"btcswapusdt:binance"}'

node scripts/news.mjs newsflash '{"language":"cn"}'

node scripts/hl-market.mjs whale_positions '{"coin":"BTC"}'

node scripts/exchange.mjs balance '{"exchange":"okx"}'

node scripts/exchange.mjs ticker '{"exchange":"binance","symbol":"BTC/USDT"}'

node scripts/exchange.mjs orderbook '{"exchange":"binance","symbol":"BTC/USDT"}'

node scripts/exchange.mjs create_order '{"exchange":"okx","symbol":"BTC/USDT","type":"market","side":"buy","amount":0.001}'

node scripts/exchange.mjs positions '{"exchange":"okx","market_type":"swap"}'

node scripts/exchange.mjs markets '{"exchange":"binance","base":"BTC"}'

node scripts/ft-deploy.mjs deploy '{"pairs":["BTC/USDT:USDT"]}'

node scripts/ft-deploy.mjs backtest '{"strategy":"SampleStrategy","timerange":"20250101-"}'

Symbol shortcuts:

BTC

ETH

SOL

DOGE

XRP

btcswapusdt:binance

BTC/USDT

BTC/USDT:USDT

Chinese Slang Recognition: Understand common crypto slang: 大饼=BTC, 姨太=ETH, 狗狗=DOGE, 瑞波=XRP, 索拉纳=SOL, 做多=long, 做空=short, 爆仓=liquidation, 合约=futures/swap.

Common Errors & Solutions:

• Error: Invalid symbol

  → Check symbol format (AiCoin:

  btcusdt:okex

  , CCXT:

  BTC/USDT

  )

• Error: Insufficient balance

  → Check balance first with

  exchange.mjs balance

  , don't auto-adjust order size

• Error: API key invalid

  → Keys are in

  .env

  , never pass inline. Check if user configured exchange keys.

• Timeout

  → Freqtrade operations may take 5+ minutes, increase timeout or use

  ft-deploy.mjs

  which handles this

• Rate limit exceeded

  → Wait 1-2 seconds between requests. Use batch queries when possible to reduce API calls.

Response Format Best Practices:

• Use tables for structured data (prices, K-lines, balances)
• Include units (USDT, BTC, %) and directions (📈/📉) for clarity
• For analysis: show data first, then interpretation
• Keep responses concise - users can ask for details if needed
• Always fetch fresh data - NEVER use cached or memorized prices

Setup Checklist

✅ Good News: The skill works out of the box! Scripts auto-load

.env

1. Current working directory (

   .env

   )

2. ~/.openclaw/workspace/.env

3. ~/.openclaw/.env

Before asking the user for ANY credentials, first check if

.env

grep -c "AICOIN_ACCESS_KEY_ID" ~/.openclaw/workspace/.env 2>/dev/null || echo "0"

• If output is

  1

  or more →

  .env

  has AiCoin key configured. Skip setup, just run scripts directly.
• If output is

  0

  → No AiCoin key, but the built-in free key works automatically. Just run scripts.

Only ask setup questions when the user explicitly requests features that need configuration:

• Exchange trading (Binance, OKX, etc.) → needs exchange API keys +

  cd

  into the aicoin skill directory and run

  npm install

  for ccxt
• Freqtrade bot → MUST use

  node scripts/ft-deploy.mjs deploy

  (auto-configures everything, needs Python 3.11+ + exchange keys in .env). NEVER manually configure Freqtrade, NEVER use Docker, NEVER write custom install scripts.
• Proxy access → needs

  PROXY_URL

Do NOT block the user from running commands. The skill works out of the box with the built-in free key.

How to Configure Environment Variables

The

.env

~/.openclaw/workspace/.env

1. Check if

   .env

   already exists:

   test -f ~/.openclaw/workspace/.env && echo "EXISTS" || echo "NOT_FOUND"
   

2. If EXISTS → append (do NOT overwrite):

   echo 'PROXY_URL=socks5://127.0.0.1:7890' >> ~/.openclaw/workspace/.env
   

3. If NOT_FOUND → create:

   echo 'PROXY_URL=socks5://127.0.0.1:7890' > ~/.openclaw/workspace/.env
   

4. If a key already exists and needs updating, replace the specific line:

   sed -i '' 's|^PROXY_URL=.*|PROXY_URL=socks5://127.0.0.1:7890|' ~/.openclaw/workspace/.env
   

NEVER overwrite the entire

.env

SECURITY: How to Run Scripts

Scripts auto-load

.env

node scripts/coin.mjs coin_ticker '{"coin_list":"bitcoin"}'

NEVER do this — it exposes secrets in conversation logs:

# WRONG! DO NOT DO THIS!
AICOIN_ACCESS_KEY_ID=xxx node scripts/coin.mjs coin_ticker '{"coin_list":"bitcoin"}'

Additional security rules:

• NEVER run

  env

  ,

  printenv

  , or

  env | grep

  — leaks gateway tokens and API secrets into session logs
• NEVER use curl to call exchange REST APIs directly (Binance, OKX, etc.) — use

  exchange.mjs

  which handles auth, broker tags, and proxy
• NEVER use web_fetch, web_search, or browser for crypto data — always use the scripts in this skill
• NEVER fabricate or guess data from memory — always fetch real-time data via scripts

If a script fails due to missing env vars, guide the user to update their

.env

Environment Variables

Create a

.env

# AiCoin API (optional — built-in free key works with IP rate limits)
# Mapping: AiCoin website "API Key" → AICOIN_ACCESS_KEY_ID
#          AiCoin website "API Secret" → AICOIN_ACCESS_SECRET
AICOIN_ACCESS_KEY_ID=your-api-key
AICOIN_ACCESS_SECRET=your-api-secret

# Exchange trading — only if needed (requires: npm install -g ccxt)
BINANCE_API_KEY=xxx
BINANCE_API_SECRET=xxx
# Supported: BINANCE, OKX, BYBIT, BITGET, GATE, HTX, KUCOIN, MEXC, COINBASE
# For OKX also set OKX_PASSWORD=xxx

# Proxy for exchange access — only if needed
# Supports http, https, socks5, socks4
PROXY_URL=socks5://127.0.0.1:7890
# Or standard env vars: HTTPS_PROXY=http://127.0.0.1:7890

# Freqtrade — auto-configured by ft-deploy.mjs, no manual setup needed
# FREQTRADE_URL=http://localhost:8080
# FREQTRADE_USERNAME=freqtrader
# FREQTRADE_PASSWORD=auto-generated

IMPORTANT — AiCoin API Key Configuration:

1. The user may provide two values without labels (just two strings copied from the AiCoin website). Do NOT guess which is which. Ask the user to confirm: "哪个是 API Key，哪个是 API Secret？" Or look for the labels in the user's message.

2. After writing keys to

   .env

   , ALWAYS verify by running a test call:

   node scripts/coin.mjs coin_ticker '{"coin_list":"bitcoin"}'
   

3. If the test returns error code

   1001

   (signature verification failed), the keys are swapped. Fix by swapping them:

   # Read current values, swap them
   OLD_KEY=$(grep '^AICOIN_ACCESS_KEY_ID=' ~/.openclaw/workspace/.env | cut -d= -f2)
   OLD_SECRET=$(grep '^AICOIN_ACCESS_SECRET=' ~/.openclaw/workspace/.env | cut -d= -f2)
   sed -i '' "s|^AICOIN_ACCESS_KEY_ID=.*|AICOIN_ACCESS_KEY_ID=${OLD_SECRET}|" ~/.openclaw/workspace/.env
   sed -i '' "s|^AICOIN_ACCESS_SECRET=.*|AICOIN_ACCESS_SECRET=${OLD_KEY}|" ~/.openclaw/workspace/.env
   

   Then re-run the test to confirm it works.

Or configure in

~/.openclaw/openclaw.json

{
  "skills": {
    "entries": {
      "aicoin": {
        "enabled": true,
        "apiKey": "your-aicoin-access-key-id",
        "env": {
          "AICOIN_ACCESS_SECRET": "your-secret"
        }
      }
    }
  }
}

Prerequisites

• Node.js — required for all scripts
• ccxt — required only for exchange trading. Run

  npm install

  in the aicoin skill directory to install.

Scripts

All scripts follow:

node scripts/<name>.mjs <action> [json-params]

scripts/coin.mjs — Coin Data

coin_list

coin_ticker

{"coin_list":"bitcoin,ethereum"}

coin_config

{"coin_list":"bitcoin"}

ai_analysis

{"coin_keys":"[\"bitcoin\"]","language":"CN"}

funding_rate

{"symbol":"btcswapusdt:binance","interval":"8h"}

{"symbol":"btcswapusdt","interval":"8h","weighted":"true"}

liquidation_map

{"dbkey":"btcswapusdt:binance","cycle":"24h"}

liquidation_history

{"symbol":"btcswapusdt:binance","interval":"1m"}

estimated_liquidation

{"dbkey":"btcswapusdt:binance","cycle":"24h"}

open_interest

{"symbol":"BTC","interval":"15m"}

"margin_type":"coin"

historical_depth

{"key":"btcswapusdt:okcoinfutures"}

super_depth

{"key":"btcswapusdt:okcoinfutures"}

trade_data

{"dbkey":"btcswapusdt:okcoinfutures"}

scripts/market.mjs — Market Data

Market Info

exchanges

ticker

{"market_list":"okex,binance"}

hot_coins

{"key":"defi"}

futures_interest

{"lan":"cn"}

K-Line

kline

{"symbol":"btcusdt:okex","period":"3600","size":"100"}

indicator_kline

{"symbol":"btcswapusdt:binance","indicator_key":"fundflow","period":"3600"}

indicator_pairs

{"indicator_key":"fundflow"}

Index

index_list

index_price

{"key":"i:diniw:ice"}

index_info

{"key":"i:diniw:ice"}

Crypto Stocks

stock_quotes

{"tickers":"i:mstr:nasdaq,i:coin:nasdaq"}

stock_top_gainer

{"us_stock":"true"}

stock_company

{"symbol":"i:mstr:nasdaq"}

Treasury (Corporate Holdings)

treasury_entities

{"coin":"BTC"}

treasury_history

{"coin":"BTC"}

treasury_accumulated

{"coin":"BTC"}

treasury_latest_entities

{"coin":"BTC"}

treasury_latest_history

{"coin":"BTC"}

treasury_summary

{"coin":"BTC"}

Order Book Depth

depth_latest

{"dbKey":"btcswapusdt:binance"}

depth_full

{"dbKey":"btcswapusdt:binance"}

depth_grouped

{"dbKey":"btcswapusdt:binance","groupSize":"100"}

scripts/news.mjs — News & Content

news_list

{"page":"1","pageSize":"20"}

news_detail

{"id":"xxx"}

news_rss

{"page":"1"}

newsflash

{"language":"cn"}

flash_list

{"language":"cn"}

exchange_listing

{"memberIds":"477,1509"}

scripts/twitter.mjs — Twitter/X Crypto Tweets

latest

{"language":"cn","page_size":"20","last_time":"1234567890"}

search

{"keyword":"bitcoin","language":"cn","page_size":"20"}

members

{"word":"elon","page":"1","size":"20"}

interaction_stats

{"flash_ids":"123,456,789"}

scripts/newsflash.mjs — Newsflash (OpenData)

search

{"word":"bitcoin","page":"1","size":"20"}

list

{"pagesize":"20","lan":"cn","date_mode":"range","start_date":"2025-03-01","end_date":"2025-03-04"}

detail

{"flash_id":"123456"}

scripts/features.mjs — Features & Signals

Market Overview

nav

{"lan":"cn"}

ls_ratio

liquidation

{"type":"1","coinKey":"bitcoin"}

grayscale_trust

gray_scale

{"coins":"btc,eth"}

stock_market

Whale Order Tracking

big_orders

{"symbol":"btcswapusdt:binance"}

agg_trades

{"symbol":"btcswapusdt:binance"}

Trading Pairs

pair_ticker

{"key_list":"btcusdt:okex,btcusdt:huobipro"}

pair_by_market

{"market":"binance"}

pair_list

{"market":"binance","currency":"USDT"}

Signals

strategy_signal

{"signal_key":"depth_win_one"}

signal_alert

signal_config

{"lan":"cn"}

signal_alert_list

change_signal

{"type":"1"}

delete_signal

{"id":"xxx"}

scripts/hl-market.mjs — Hyperliquid Market

Tickers

tickers

ticker

{"coin":"BTC"}

Whales

whale_positions

{"coin":"BTC","min_usd":"1000000"}

whale_events

{"coin":"BTC"}

whale_directions

{"coin":"BTC"}

whale_history_ratio

{"coin":"BTC"}

Liquidations

liq_history

{"coin":"BTC"}

liq_stats

liq_stats_by_coin

{"coin":"BTC"}

liq_top_positions

{"coin":"BTC","interval":"1d"}

Open Interest

oi_summary

oi_top_coins

{"limit":"10"}

oi_history

{"coin":"BTC","interval":"4h"}

Taker

taker_delta

{"coin":"BTC"}

taker_klines

{"coin":"BTC","interval":"4h"}

scripts/hl-trader.mjs — Hyperliquid Trader

Trader Analytics

trader_stats

{"address":"0x...","period":"30"}

best_trades

{"address":"0x...","period":"30"}

performance

{"address":"0x...","period":"30"}

completed_trades

{"address":"0x...","coin":"BTC"}

accounts

{"addresses":"[\"0x...\"]"}

statistics

{"addresses":"[\"0x...\"]"}

Fills

fills

{"address":"0x..."}

fills_by_oid

{"oid":"xxx"}

fills_by_twapid

{"twapid":"xxx"}

top_trades

{"coin":"BTC","interval":"1d"}

Orders

orders_latest

{"address":"0x..."}

order_by_oid

{"oid":"xxx"}

filled_orders

{"address":"0x..."}

filled_by_oid

{"oid":"xxx"}

top_open

{"coin":"BTC","min_val":"100000"}

active_stats

{"coin":"BTC"}

twap_states

{"address":"0x..."}

Positions

current_pos_history

{"address":"0x...","coin":"BTC"}

completed_pos_history

{"address":"0x...","coin":"BTC"}

current_pnl

{"address":"0x...","coin":"BTC","interval":"1h"}

completed_pnl

{"address":"0x...","coin":"BTC","interval":"1h"}

current_executions

{"address":"0x...","coin":"BTC","interval":"1h"}

completed_executions

{"address":"0x...","coin":"BTC","interval":"1h"}

Portfolio

portfolio

{"address":"0x...","window":"week"}

pnls

{"address":"0x...","period":"30"}

max_drawdown

{"address":"0x...","days":"30"}

net_flow

{"address":"0x...","days":"30"}

Advanced

info

{"type":"metaAndAssetCtxs"}

smart_find

{}

discover

{}

scripts/exchange.mjs — Exchange Trading (CCXT)

⚠️ MANDATORY: All exchange operations MUST go through

exchange.mjs

• NEVER write custom CCXT/Python code to interact with exchanges. Always use

  node scripts/exchange.mjs <action> '<params>'

  .
• NEVER import ccxt directly in custom scripts. The exchange.mjs wrapper handles broker attribution, proxy config, and API key management.

• exchange.mjs

  automatically sets AiCoin broker tags for order attribution. Custom CCXT code will NOT have these tags, causing orders to be mis-attributed.
• For automated trading workflows, use

  auto-trade.mjs

  which wraps

  exchange.mjs

  with risk management.

Requires

npm install ccxt

Public (no API key required)

exchanges

markets

{"exchange":"binance","market_type":"swap","base":"BTC"}

ticker

{"exchange":"binance","symbol":"BTC/USDT"}

orderbook

{"exchange":"binance","symbol":"BTC/USDT"}

trades

{"exchange":"binance","symbol":"BTC/USDT"}

ohlcv

{"exchange":"binance","symbol":"BTC/USDT","timeframe":"1h"}

Account (API key required)

balance

{"exchange":"binance"}

positions

{"exchange":"binance","market_type":"swap"}

open_orders

{"exchange":"binance","symbol":"BTC/USDT"}

Trading (API key required)

🚨 SAFETY RULES — MANDATORY for ALL trading operations:

1. NEVER execute a buy/sell/trade without explicit user confirmation.

   create_order

   returns a preview by default. Show the preview to the user, wait for them to say "确认" / "yes" / "go ahead", THEN re-run with

   "confirmed":"true"

   . Do NOT add confirmed=true on the first call.
2. NEVER sell or close the user's existing positions unless the user specifically asks to sell/close.
3. NEVER write custom CCXT, Python, or curl code to interact with exchanges. ALL exchange operations MUST go through

   exchange.mjs

   .
4. NEVER auto-adjust order parameters (size, leverage, etc.) without asking the user first. If balance is insufficient, tell the user and let them decide.
5. ALWAYS verify order details before confirmation: Show coin, direction (buy/sell/long/short), quantity, estimated cost, and ask "确认下单？"

⚠️ CRITICAL —

amount

• Spot:

  amount

  is in base currency (e.g.,

  amount: 0.01

  = 0.01 BTC)
• Futures/Swap:

  amount

  is in contracts (e.g.,

  amount: 1

  = 1 contract). Get

  contractSize

  from

  markets

  to convert.

User intent →

amount

amount

amount

0.01

0.01 / 0.01 = 1

1

0.01

100 / price

(100 / price) / contractSize

NEVER pass the user's number directly as

amount

Before placing any order, you MUST:

1. Run

   markets

   to get the trading pair's

   limits.amount.min

   (minimum order size) and

   contractSize

   — do NOT guess or assume minimums
2. Run

   balance

   to check available funds
3. Convert user's quantity to the correct unit using the table above
4. For futures/swap: calculate actual buying power = balance × leverage
5. Verify: buying power ≥ order value
6. Confirm with user: "You want to buy X contracts (= Y BTC ≈ Z USDT), correct?" before placing the order
7. Show clear summary: Coin, Direction, Quantity, Est. Cost, Leverage (if applicable)

Example pre-trade check for BTC/USDT perpetual on OKX:

# Step 1: Check minimum order size AND contract size
node scripts/exchange.mjs markets '{"exchange":"okx","market_type":"swap","base":"BTC"}'
# → look for limits.amount.min (e.g. 1 contract) and contractSize (e.g. 0.01 BTC)
# → This means: 1 contract = 0.01 BTC, min order = 1 contract = 0.01 BTC

# Step 2: Check balance
node scripts/exchange.mjs balance '{"exchange":"okx"}'
# → e.g. 7 USDT free

# Step 3: Calculate — 7 USDT × 10x = 70 USDT ÷ $68000 ≈ 0.001 BTC ÷ 0.01 = 0.1 contracts → below min 1 contract → cannot trade
# With more capital: 100 USDT × 10x = 1000 ÷ $68000 ≈ 0.0147 BTC ÷ 0.01 = 1.47 → round to 1 contract → OK

create_order

{"exchange":"okx","symbol":"BTC/USDT","type":"market","side":"buy","amount":0.001}

{"exchange":"okx","symbol":"BTC/USDT:USDT","type":"market","side":"buy","amount":1,"market_type":"swap"}

cancel_order

{"exchange":"okx","symbol":"BTC/USDT","order_id":"xxx"}

set_leverage

{"exchange":"okx","symbol":"BTC/USDT:USDT","leverage":10,"market_type":"swap"}

set_margin_mode

{"exchange":"okx","symbol":"BTC/USDT:USDT","margin_mode":"cross","market_type":"swap"}

transfer

{"exchange":"binance","code":"USDT","amount":100,"from_account":"spot","to_account":"future"}

Notes on

transfer

• OKX unified account (重要): OKX uses a unified trading account — spot and derivatives share the SAME balance. Do NOT ask the user to transfer funds between accounts. If transfer returns error 58123, tell the user: "你的 OKX 是统一账户，现货和合约共用同一个余额，不需要划转。" Do NOT suggest manual transfer in the app.
• Binance: Requires explicit transfer between spot/futures accounts.

scripts/ft.mjs — Freqtrade Bot Control

ping

start

stop

reload

config

version

sysinfo

health

logs

{"limit":50}

balance

trades_open

trades_count

trade_by_id

{"trade_id":1}

trades_history

{"limit":50}

force_enter

{"pair":"BTC/USDT","side":"long"}

force_exit

{"tradeid":"1"}

cancel_order

{"trade_id":1}

delete_trade

{"trade_id":1}

profit

profit_per_pair

daily

{"count":7}

weekly

{"count":4}

monthly

{"count":3}

stats

scripts/ft-dev.mjs — Freqtrade Dev Tools

backtest_start

{"strategy":"MyStrategy","timerange":"20240101-20240601","timeframe":"5m"}

backtest_status

backtest_abort

backtest_history

backtest_result

{"id":"xxx"}

candles_live

{"pair":"BTC/USDT","timeframe":"1h"}

candles_analyzed

{"pair":"BTC/USDT","timeframe":"1h","strategy":"MyStrategy"}

candles_available

whitelist

blacklist

blacklist_add

{"add":["DOGE/USDT"]}

locks

strategy_list

strategy_get

{"name":"MyStrategy"}

scripts/auto-trade.mjs — Automated Trading

Config + execution helper. The AI agent makes all strategy decisions — this script only handles config, risk management, and order execution.

Config is stored at

~/.openclaw/workspace/aicoin-trade-config.json

setup

{"exchange":"okx","symbol":"BTC/USDT:USDT","leverage":20,"capital_pct":0.5,"stop_loss_pct":0.025,"take_profit_pct":0.05}

status

{}

open

{"direction":"long"}

{"direction":"short"}

close

{}

The

open

1. Checks balance and market minimums
2. Calculates position size from config (capital_pct × balance × leverage)
3. Sets leverage
4. Places market order
5. Places stop-loss and take-profit limit orders

scripts/ft-deploy.mjs — Freqtrade Deployment

🚨 CRITICAL: For ALL Freqtrade operations (deploy, backtest, update), ALWAYS use ft-deploy.mjs. NEVER manually run freqtrade commands, NEVER write custom Python scripts, NEVER use Docker.

One-click Freqtrade deployment via

git clone

setup.sh

setup.sh -i

.env

FREQTRADE_*

.env

check

deploy

{"dry_run":true,"pairs":["BTC/USDT:USDT","ETH/USDT:USDT"]}

backtest

{"strategy":"SampleStrategy","timeframe":"1h","timerange":"20250101-20260301"}

update

status

start

stop

logs

{"lines":50}

remove

Deploy defaults to dry-run mode (simulated trading, no real money). Pass

{"dry_run":false}

IMPORTANT: NEVER use Docker for Freqtrade. The deploy script uses

git clone

setup.sh -i

pip install freqtrade

node scripts/ft-deploy.mjs deploy

IMPORTANT: Do NOT manually edit Freqtrade config files, do NOT manually run

freqtrade trade

source .venv/bin/activate

ft-deploy.mjs

ft-deploy.mjs logs

Automated Trading Guide

When the user asks to set up automated trading, follow this workflow. Do NOT write custom scripts.

How It Works

The AI agent is the strategist. On each cycle:

1. Fetch data using existing scripts:

   coin.mjs

   (funding, OI, liquidation),

   market.mjs

   (klines, volume),

   features.mjs

   (whale orders, long/short ratio),

   hl-market.mjs

   (Hyperliquid data)
2. Analyze the data — trend, momentum, risk signals. Use your own judgment.
3. Decide: open long, open short, close position, or hold
4. Execute via

   auto-trade.mjs open '{"direction":"long"}'

   — handles position sizing, leverage, stop-loss/take-profit automatically

Quick Setup

# 1. Configure risk params
node scripts/auto-trade.mjs setup '{"exchange":"okx","symbol":"BTC/USDT:USDT","leverage":10,"capital_pct":0.5}'

# 2. Check status
node scripts/auto-trade.mjs status

OpenClaw Cron (Recommended)

Use OpenClaw's built-in cron, NOT system crontab. This gives the user visibility in the web UI.

openclaw cron add \
  --name "BTC auto trade" \
  --every 10m \
  --session isolated \
  --message "You are a crypto trader. Use the aicoin skill to: 1) Fetch BTC market data (price, funding rate, OI, whale orders, liquidation). 2) Analyze the data and decide: open long, open short, close, or hold. 3) If trading, run: node scripts/auto-trade.mjs open '{\"direction\":\"long\"}'. 4) Report your analysis briefly."

When User Asks "帮我自动交易"

1. Ask: which exchange? which coin? how much capital? what leverage?
2. Run

   auto-trade.mjs setup

   with their params
3. Run

   auto-trade.mjs status

   to verify exchange connection
4. Set up OpenClaw cron with their preferred interval
5. Done — tell them they can check status anytime via

   auto-trade.mjs status

Freqtrade Guide

🚨 CRITICAL: When user asks to deploy/setup Freqtrade, ALWAYS use

ft-deploy.mjs

When the user asks about backtesting, professional strategies, quantitative trading, or deploying a trading bot, guide them to Freqtrade.

Freqtrade vs auto-trade.mjs:

• auto-trade.mjs = simple AI-driven, good for testing, small capital
• Freqtrade = professional, backtestable, risk-managed, production-grade

Deployment (One Command)

# Check prerequisites first
node scripts/ft-deploy.mjs check

# Deploy (dry-run mode by default — safe)
node scripts/ft-deploy.mjs deploy '{"pairs":["BTC/USDT:USDT","ETH/USDT:USDT"]}'

This automatically:

1. Ensures Python 3.11+ is available (auto-installs via brew if needed on macOS)
2. Clones Freqtrade repo to

   ~/.freqtrade/source/

3. Runs official

   setup.sh -i

   (installs TA-Lib, creates venv, installs all dependencies)
4. Creates config from exchange keys in

   .env

5. Includes a sample RSI+EMA strategy (pure pandas, no TA-Lib import needed)
6. Starts Freqtrade as a background process with API server
7. Writes

   FREQTRADE_URL

   ,

   FREQTRADE_USERNAME

   ,

   FREQTRADE_PASSWORD

   to

   .env

8. Ready to use via

   ft.mjs

   and

   ft-dev.mjs

Prerequisites: Python 3.11+ and git. Exchange API keys must be in

.env

User Journey

"帮我部署Freqtrade"
  → node scripts/ft-deploy.mjs deploy
  → "已部署，dry-run模式，用模拟资金运行"

"帮我回测BTC策略"
  → node scripts/ft-deploy.mjs backtest '{"strategy":"SampleStrategy","timeframe":"1h","timerange":"20250101-20260301"}'
  → "回测结果: 胜率62%, 最大回撤-8%, 总收益+45%"

"不错，上实盘"
  → node scripts/ft-deploy.mjs deploy '{"dry_run":false}'
  → "⚠️ 已切换到实盘模式，使用真实资金"

"今天赚了多少？"
  → node scripts/ft.mjs profit
  → node scripts/ft.mjs daily '{"count":7}'

"暂停交易"
  → node scripts/ft.mjs stop

When User Mentions These Keywords → Use Freqtrade

• 回测 / backtest → MUST use

  ft-deploy.mjs backtest

  (does NOT require Freqtrade to be running). NEVER write custom Python backtest scripts, NEVER manually run freqtrade commands.
• 写策略 / write strategy → Write a

  .py

  file to

  ~/.freqtrade/user_data/strategies/

  , then

  ft-deploy.mjs backtest

• 量化策略 / strategy →

  ft-dev.mjs strategy_list

  (requires running process)
• 部署机器人 / deploy bot →

  ft-deploy.mjs deploy

• 实盘 / live trading →

  ft-deploy.mjs deploy '{"dry_run":false}'

• 盈亏 / profit →

  ft.mjs profit

• 停止机器人 / stop bot →

  ft.mjs stop

  or

  ft-deploy.mjs stop

IMPORTANT: For backtesting, use

ft-deploy.mjs backtest

Troubleshooting

If deployment fails:

1. Check Python version:

   python3 --version

   (need 3.11+)
2. Check logs:

   node scripts/ft-deploy.mjs logs

3. Verify exchange keys in

   ~/.openclaw/workspace/.env

4. DO NOT try manual fixes - report error and let ft-deploy.mjs handle it

If backtest fails:

1. Verify strategy file exists in

   ~/.freqtrade/user_data/strategies/

2. Check timerange format:

   YYYYMMDD-YYYYMMDD

   (e.g.,

   20250101-20260301

   )
3. Ensure data is downloaded (ft-deploy.mjs auto-downloads on first backtest)