AiCoin

Setup Checklist

.env

1. Current working directory (

   .env

   )

2. ~/.openclaw/workspace/.env

3. ~/.openclaw/.env

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

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

  cd <skill-dir>/aicoin && npm install

  for ccxt
• Freqtrade bot → run

  ft-deploy.mjs deploy

  (auto-configures everything, needs Python 3 + exchange keys in .env)
• Proxy access → needs

  PROXY_URL

How to Configure Environment Variables

.env

~/.openclaw/workspace/.env

1. Check if

   .env

   already exists:
   bash

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

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

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

3. If NOT_FOUND → create:
   bash

   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:
   bash

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

.env

SECURITY: How to Run Scripts

.env

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

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

.env

Environment Variables

.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

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:
   bash

   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:
   bash

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

~/.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:

  cd <skill-dir>/aicoin && npm install

Scripts

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)

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.

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)

1. NEVER execute a buy/sell/trade without explicit user confirmation. Always show the order details and ask "确认下单？" BEFORE calling

   create_order

   .
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

   .

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.

amount

amount

amount

0.01

0.01 / 0.01 = 1

1

0.01

100 / price

(100 / price) / contractSize

amount

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

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

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

~/.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

{}

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

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

{"dry_run":false}

git clone

setup.sh -i

pip install freqtrade

node scripts/ft-deploy.mjs deploy

freqtrade trade

source .venv/bin/activate

ft-deploy.mjs

ft-deploy.mjs logs

Automated Trading Guide

How It Works

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)

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

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

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

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

  ft-deploy.mjs backtest

  (does NOT require Freqtrade to be running)
• 写策略 / 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

ft-deploy.mjs backtest