aicoin_skill

Overview

This skill provides a comprehensive crypto data and trading toolkit powered by the AiCoin Open API. It supports market data (tickers, K-lines, funding rates, open interest, liquidations, whale tracking) and exchange trading across major venues (Binance, OKX, Bybit, Bitget, Gate, HTX, KuCoin, MEXC, Coinbase). It also includes tools for Hyperliquid analytics, Freqtrade bot deployment and control, and automated strategy testing.

How this skill works

Scripts are executed with node and auto-load environment variables from prioritized .env locations so credentials are never passed inline. Use dedicated scripts (coin.mjs, market.mjs, hl-market.mjs, hl-trader.mjs, exchange.mjs, news.mjs, features.mjs) with action names and JSON parameters to fetch data or place orders. Exchange trading requires ccxt and exchange API keys in the .env; Freqtrade deployment is automated via provided deploy scripts.

When to use it

• Request real-time prices, K-line candles, or on-chain Hyperliquid metrics for research or signals.
• Place, cancel, or check spot and futures orders, view balances, positions, and set leverage on supported exchanges.
• Track funding rates, open interest, liquidation heatmaps, or whale/order-flow activity for risk management.
• Deploy, backtest, or control a Freqtrade bot and automate trading strategies.
• Run AI analysis, market summaries, news feeds, or large-trade (whale) monitoring for alerts.
• Gather historical depth, orderbook snapshots, or detailed fills and PnL for forensic or performance analysis.

Best practices

• Never send API keys or secrets inline; rely on the auto-loaded .env files in the OpenClaw workspace.
• Check for existing AiCoin keys first — the built-in free key works for most queries with rate limits.
• Install prerequisites before trading: Node.js for all scripts and ccxt for exchange actions.
• Append or edit individual lines when updating .env; do not overwrite the entire file to avoid losing other credentials.
• Use the provided scripts with explicit action names and JSON parameters to keep calls deterministic and auditable.
• When a script fails due to missing env vars, guide the user to update their .env rather than injecting secrets in commands.

Example use cases

• Fetch BTC/USDT 1h K-lines and run an indicator_kline action to spot momentum divergences.
• Place a Binance futures order, check open positions, and adjust leverage using exchange.mjs after adding keys to .env.
• Deploy the Freqtrade bot with ft-deploy.mjs, run backtests, then start automated execution tied to a strategy signal.
• Monitor Hyperliquid whale positions and liquidations to generate alerts for large directional moves.
• Pull funding rate and open interest trends to decide whether to hedge an existing spot exposure.
• Aggregate newsflash and trending coin lists to inform a daily trading watchlist.