AiCoin

Crypto data & trading toolkit powered by AiCoin Open API.

Version: 1.5.29 | Last Updated: 2026-03-05

🚨 CRITICAL RULES - READ FIRST

FREQTRADE OPERATIONS:

• ✅ ALWAYS use node scripts/ft-deploy.mjs deploy for deployment

• ✅ ALWAYS use node scripts/ft-deploy.mjs backtest for backtesting

• ❌ NEVER use Docker commands

• ❌ NEVER manually run freqtrade commands

• ❌ NEVER write custom Python scripts for Freqtrade

TRADING SAFETY:

• ❌ NEVER place orders without explicit user confirmation

• ❌ NEVER auto-adjust order parameters

• ✅ ALWAYS show order preview and ask "确认下单？" first

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"}'

Performance Tips:

• Batch queries: coin_ticker supports multiple coins → faster than separate calls

• Reduce API calls: Check balance once, reuse result for multiple calculations

• Use appropriate timeframes: Don't fetch 1000 candles when 10 is enough

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" ).

Task Command

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

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

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

Funding rate node scripts/coin.mjs funding_rate '{"symbol":"BTC"}' (BTC only, 8h default)

Funding rate (other coins) node scripts/exchange.mjs funding_rate '{"exchange":"binance","symbol":"ETH/USDT:USDT"}'

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

Long/short ratio node scripts/features.mjs ls_ratio

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

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

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

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

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

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

Buy/Sell node scripts/exchange.mjs create_order '{"exchange":"okx","symbol":"BTC/USDT","type":"market","side":"buy","amount":0.001}' → returns preview only

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

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

Deploy Freqtrade node scripts/ft-deploy.mjs deploy '{"pairs":["BTC/USDT:USDT"]}' (dry-run by default)

Backtest node scripts/ft-deploy.mjs backtest '{"strategy":"SampleStrategy","timerange":"20250101-"}' ⚠️ MUST use this script

Symbol shortcuts: BTC , ETH , SOL , DOGE , XRP auto-resolve to AiCoin format (e.g. btcswapusdt:binance ) in coin.mjs. For exchange.mjs, use CCXT format: BTC/USDT , BTC/USDT:USDT (swap).

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.

• Script not found → Ensure you're in the aicoin skill directory. Use exec tool with full path to script.

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

• Timestamps: API returns UTC, convert to user's timezone if needed (default: show UTC+8 for Chinese users)

• Language: Always reply in the same language as the user. If the user writes in Chinese, ALL text (titles, headings, analysis, labels) MUST be in Chinese. Never mix English headings into a Chinese response.

Coin Recommendation Best Practices:

• When the user asks for coin picks WITHOUT specifying a sector, recommend across MULTIPLE sectors (AI, DeFi, L2, Meme, Infrastructure, etc.) for diversification

• Only focus on a single sector when the user explicitly requests it (e.g., "AI赛道", "DeFi概念")

• Use hot_coins with different keys (defi, gamefi, web, newcoin, market) to discover coins across sectors, don't just pick from one category

• Always include reasoning for each pick: why THIS coin, why NOW (momentum, volume spike, whale activity, news catalyst, etc.)

Setup Checklist

✅ Good News: The skill works out of the box! Scripts auto-load .env files from these locations (earlier paths take priority):

• Current working directory (.env )

• ~/.openclaw/workspace/.env

• ~/.openclaw/.env

Before asking the user for ANY credentials, first check if .env already exists:

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 file location is ~/.openclaw/workspace/.env . When adding new variables:

Check if .env already exists:

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

If EXISTS → append (do NOT overwrite):

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

If NOT_FOUND → create:

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

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 file — it may contain other credentials the user has already configured.

SECURITY: How to Run Scripts

Scripts auto-load .env — NEVER pass credentials inline. Just run:

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 file instead of injecting variables into the command.

Environment Variables

Create a .env file in the OpenClaw workspace directory (recommended):

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:

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.

After writing keys to .env , ALWAYS verify by running a test call:

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

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

Action Description Params

coin_list

List all coins None

coin_ticker

Real-time prices {"coin_list":"bitcoin,ethereum"}

coin_config

Coin profile {"coin_list":"bitcoin"}

ai_analysis

AI analysis & prediction {"coin_keys":"["bitcoin"]","language":"CN"}

funding_rate

Funding rate {"symbol":"btcswapusdt:binance","interval":"8h"} Weighted: {"symbol":"btcswapusdt","interval":"8h","weighted":"true"}

liquidation_map

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

liquidation_history

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

estimated_liquidation

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

open_interest

Open interest {"symbol":"BTC","interval":"15m"} Coin-margined: add "margin_type":"coin"

historical_depth

Historical depth {"key":"btcswapusdt:okcoinfutures"}

super_depth

Large order depth (>$10k) {"key":"btcswapusdt:okcoinfutures"}

trade_data

Trade data {"dbkey":"btcswapusdt:okcoinfutures"}

scripts/market.mjs — Market Data

Market Info

Action Description Params

exchanges

Exchange list None

ticker

Exchange tickers {"market_list":"okex,binance"}

hot_coins

Trending coins {"key":"defi"} key: gamefi/anonymous/market/web/newcoin/stable/defi

futures_interest

Futures OI ranking {"lan":"cn"}

K-Line

Action Description Params

kline

Standard K-line {"symbol":"btcusdt:okex","period":"3600","size":"100"} period in seconds: 900=15m, 3600=1h, 14400=4h, 86400=1d

indicator_kline

Indicator K-line {"symbol":"btcswapusdt:binance","indicator_key":"fundflow","period":"3600"}

indicator_pairs

Indicator available pairs {"indicator_key":"fundflow"}

Index

Action Description Params

index_list

Index list None

index_price

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

index_info

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

Crypto Stocks

Action Description Params

stock_quotes

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

stock_top_gainer

Top gainers {"us_stock":"true"}

stock_company

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

Treasury (Corporate Holdings)

Action Description Params

treasury_entities

Holding entities {"coin":"BTC"}

treasury_history

Transaction history {"coin":"BTC"}

treasury_accumulated

Accumulated holdings {"coin":"BTC"}

treasury_latest_entities

Latest entities {"coin":"BTC"}

treasury_latest_history

Latest history {"coin":"BTC"}

treasury_summary

Holdings overview {"coin":"BTC"}

Order Book Depth

Action Description Params

depth_latest

Real-time snapshot {"dbKey":"btcswapusdt:binance"}

depth_full

Full order book {"dbKey":"btcswapusdt:binance"}

depth_grouped

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

scripts/news.mjs — News & Content

Action Description Params

news_list

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

news_detail

News detail {"id":"xxx"}

news_rss

RSS news {"page":"1"}

newsflash

AiCoin flash news {"language":"cn"}

flash_list

Industry flash news {"language":"cn"}

exchange_listing

Exchange listing announcements {"memberIds":"477,1509"} (477=Binance, 1509=Bitget)

scripts/twitter.mjs — Twitter/X Crypto Tweets

Action Description Params

latest

Latest crypto tweets (cursor-paginated) {"language":"cn","page_size":"20","last_time":"1234567890"}

search

Search tweets by keyword {"keyword":"bitcoin","language":"cn","page_size":"20"}

members

Search Twitter KOL/users {"word":"elon","page":"1","size":"20"}

interaction_stats

Tweet engagement stats {"flash_ids":"123,456,789"} (max 50 IDs)

scripts/newsflash.mjs — Newsflash (OpenData)

Action Description Params

search

Search newsflash by keyword {"word":"bitcoin","page":"1","size":"20"}

list

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

detail

Newsflash full content {"flash_id":"123456"}

scripts/features.mjs — Features & Signals

Market Overview

Action Description Params

nav

Market navigation {"lan":"cn"}

ls_ratio

Long/short ratio None

liquidation

Liquidation data {"type":"1","coinKey":"bitcoin"} type: 1=by coin, 2=by exchange

grayscale_trust

Grayscale trust None

gray_scale

Grayscale holdings {"coins":"btc,eth"}

stock_market

Crypto stocks None

Whale Order Tracking

Action Description Params

big_orders

Large/whale orders {"symbol":"btcswapusdt:binance"}

agg_trades

Aggregated large trades {"symbol":"btcswapusdt:binance"}

Trading Pairs

Action Description Params

pair_ticker

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

pair_by_market

Pairs by exchange {"market":"binance"}

pair_list

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

Signals

Action Description Params

strategy_signal

Strategy signal {"signal_key":"depth_win_one"}

signal_alert

Signal alerts None

signal_config

Alert config {"lan":"cn"}

signal_alert_list

Alert list None

change_signal

Anomaly signal {"type":"1"}

delete_signal

Delete alert {"id":"xxx"}

scripts/hl-market.mjs — Hyperliquid Market

Tickers

Action Description Params

tickers

All tickers None

ticker

Single coin ticker {"coin":"BTC"}

Whales

Action Description Params

whale_positions

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

whale_events

Whale events {"coin":"BTC"}

whale_directions

Long/short direction {"coin":"BTC"}

whale_history_ratio

Historical long ratio {"coin":"BTC"}

Liquidations

Action Description Params

liq_history

Liquidation history {"coin":"BTC"}

liq_stats

Liquidation stats None

liq_stats_by_coin

Stats by coin {"coin":"BTC"}

liq_top_positions

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

Open Interest

Action Description Params

oi_summary

OI overview None

oi_top_coins

OI ranking {"limit":"10"}

oi_history

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

Taker

Action Description Params

taker_delta

Taker delta {"coin":"BTC"}

taker_klines

Taker K-lines {"coin":"BTC","interval":"4h"}

scripts/hl-trader.mjs — Hyperliquid Trader

Trader Analytics

Action Description Params

trader_stats

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

best_trades

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

performance

Performance by coin {"address":"0x...","period":"30"}

completed_trades

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

accounts

Batch accounts {"addresses":"["0x..."]"}

statistics

Batch statistics {"addresses":"["0x..."]"}

Fills

Action Description Params

fills

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

fills_by_oid

By order ID {"oid":"xxx"}

fills_by_twapid

By TWAP ID {"twapid":"xxx"}

top_trades

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

Orders

Action Description Params

orders_latest

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

order_by_oid

By order ID {"oid":"xxx"}

filled_orders

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

filled_by_oid

Filled by ID {"oid":"xxx"}

top_open

Large open orders {"coin":"BTC","min_val":"100000"}

active_stats

Active stats {"coin":"BTC"}

twap_states

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

Positions

Action Description Params

current_pos_history

Current position history {"address":"0x...","coin":"BTC"}

completed_pos_history

Closed position history {"address":"0x...","coin":"BTC"}

current_pnl

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

completed_pnl

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

current_executions

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

completed_executions

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

Portfolio

Action Description Params

portfolio

Account curve {"address":"0x...","window":"week"} window: day/week/month/allTime

pnls

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

max_drawdown

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

net_flow

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

Advanced

Action Description Params

info

Info API {"type":"metaAndAssetCtxs"}

smart_find

Smart money discovery {}

discover

Trader discovery {}

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 and exchange API keys.

Public (no API key required)

Action Description Params

exchanges

Supported exchanges None

markets

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

ticker

Real-time ticker {"exchange":"binance","symbol":"BTC/USDT"}

orderbook

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

trades

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

ohlcv

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

Account (API key required)

Action Description Params

balance

Account balance {"exchange":"binance"}

positions

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

open_orders

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

Trading (API key required)

🚨 SAFETY RULES — MANDATORY for ALL trading operations:

• 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.

• NEVER sell or close the user's existing positions unless the user specifically asks to sell/close.

• NEVER write custom CCXT, Python, or curl code to interact with exchanges. ALL exchange operations MUST go through exchange.mjs .

• NEVER auto-adjust order parameters (size, leverage, etc.) without asking the user first. If balance is insufficient, tell the user and let them decide.

• ALWAYS verify order details before confirmation: Show coin, direction (buy/sell/long/short), quantity, estimated cost, and ask "确认下单？"

⚠️ CRITICAL — amount units differ between spot and futures:

• 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 conversion (you MUST get this right):

User says Spot amount

Swap amount (OKX BTC, contractSize=0.01)

"0.01 BTC" / "0.01个BTC" 0.01

0.01 / 0.01 = 1 (1 contract)

"1张合约" / "1 contract" N/A 1 (直接用)

"0.01张" N/A 0.01 (0.01 contract = 0.0001 BTC)

"100U" / "100 USDT" 100 / price

(100 / price) / contractSize

NEVER pass the user's number directly as amount without checking the unit context!

Before placing any order, you MUST:

• Run markets to get the trading pair's limits.amount.min (minimum order size) and contractSize — do NOT guess or assume minimums

• Run balance to check available funds

• Convert user's quantity to the correct unit using the table above

• For futures/swap: calculate actual buying power = balance × leverage

• Verify: buying power ≥ order value

• Confirm with user: "You want to buy X contracts (= Y BTC ≈ Z USDT), correct?" before placing the order

• 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

Action Description Params

create_order

Place order Spot: {"exchange":"okx","symbol":"BTC/USDT","type":"market","side":"buy","amount":0.001} (amount in BTC). Swap: {"exchange":"okx","symbol":"BTC/USDT:USDT","type":"market","side":"buy","amount":1,"market_type":"swap"} (amount in contracts)

cancel_order

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

set_leverage

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

set_margin_mode

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

transfer

Transfer funds {"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

Action Description Params

ping

Health check None

start

Start trading None

stop

Stop trading None

reload

Reload config None

config

View config None

version

Version info None

sysinfo

System info None

health

Health status None

logs

View logs {"limit":50}

balance

Account balance None

trades_open

Open trades None

trades_count

Trade count None

trade_by_id

Trade by ID {"trade_id":1}

trades_history

Trade history {"limit":50}

force_enter

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

force_exit

Manual exit {"tradeid":"1"}

cancel_order

Cancel order {"trade_id":1}

delete_trade

Delete record {"trade_id":1}

profit

Profit summary None

profit_per_pair

Profit per pair None

daily

Daily report {"count":7}

weekly

Weekly report {"count":4}

monthly

Monthly report {"count":3}

stats

Statistics None

scripts/ft-dev.mjs — Freqtrade Dev Tools

Action Description Params

backtest_start

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

backtest_status

Backtest status None

backtest_abort

Abort backtest None

backtest_history

Backtest history None

backtest_result

History result {"id":"xxx"}

candles_live

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

candles_analyzed

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

candles_available

Available pairs None

whitelist

Whitelist None

blacklist

Blacklist None

blacklist_add

Add to blacklist {"add":["DOGE/USDT"]}

locks

Trade locks None

strategy_list

Strategy list None

strategy_get

Strategy detail {"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 .

Action Description Params

setup

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

status

Show config + balance + positions + open orders {}

open

Open a position (agent decides direction) {"direction":"long"} or {"direction":"short"}

close

Close current position + cancel orders {}

The open action automatically:

• Checks balance and market minimums

• Calculates position size from config (capital_pct × balance × leverage)

• Sets leverage

• Places market order

• 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

• official setup.sh (no Docker). Clones the Freqtrade repo, runs setup.sh -i to install all dependencies (including TA-Lib), generates config from .env exchange keys, starts as background process, auto-writes FREQTRADE_* vars to .env .

Action Description Params

check

Check prerequisites (Python 3.11+, git, exchange keys) None

deploy

Deploy Freqtrade (clone, setup.sh, config, start) {"dry_run":true,"pairs":["BTC/USDT:USDT","ETH/USDT:USDT"]}

backtest

Run backtest (no running process needed) {"strategy":"SampleStrategy","timeframe":"1h","timerange":"20250101-20260301"}

update

Update Freqtrade to latest version None

status

Process status None

start

Start stopped process None

stop

Stop process None

logs

View process logs {"lines":50}

remove

Remove process (preserves config) None

Deploy defaults to dry-run mode (simulated trading, no real money). Pass {"dry_run":false} for live trading.

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

• setup.sh -i (official Freqtrade installation method). Do NOT fall back to Docker, do NOT write custom install scripts, do NOT try pip install freqtrade directly. Just run node scripts/ft-deploy.mjs deploy — it handles everything.

IMPORTANT: Do NOT manually edit Freqtrade config files, do NOT manually run freqtrade trade commands, do NOT manually source .venv/bin/activate . Always use ft-deploy.mjs actions. If deploy fails, check logs with ft-deploy.mjs logs and report the error — do NOT attempt manual workarounds.

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:

• 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)

• Analyze the data — trend, momentum, risk signals. Use your own judgment.

• Decide: open long, open short, close position, or hold

• 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 "帮我自动交易"

• Ask: which exchange? which coin? how much capital? what leverage?

• Run auto-trade.mjs setup with their params

• Run auto-trade.mjs status to verify exchange connection

• Set up OpenClaw cron with their preferred interval

• 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 . NEVER manually configure, NEVER use Docker, NEVER write custom scripts.

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:

• Ensures Python 3.11+ is available (auto-installs via brew if needed on macOS)

• Clones Freqtrade repo to ~/.freqtrade/source/

• Runs official setup.sh -i (installs TA-Lib, creates venv, installs all dependencies)

• Creates config from exchange keys in .env

• Includes a sample RSI+EMA strategy (pure pandas, no TA-Lib import needed)

• Starts Freqtrade as a background process with API server

• Writes FREQTRADE_URL , FREQTRADE_USERNAME , FREQTRADE_PASSWORD to .env

• Ready to use via ft.mjs and ft-dev.mjs

Prerequisites: Python 3.11+ and git. Exchange API keys must be in .env . Everything else is auto-installed — do NOT install manually or use Docker.

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 . Do NOT write custom Python backtest scripts. The Freqtrade backtester is production-grade with proper slippage, fees, and position sizing simulation.

Troubleshooting

If deployment fails:

• Check Python version: python3 --version (need 3.11+)

• Check logs: node scripts/ft-deploy.mjs logs

• Verify exchange keys in ~/.openclaw/workspace/.env

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

If backtest fails:

• Verify strategy file exists in ~/.freqtrade/user_data/strategies/

• Check timerange format: YYYYMMDD-YYYYMMDD (e.g., 20250101-20260301 )

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