██████╗ ██████╗ ██╗███╗   ██╗ ██████╗ ███████╗
██╔════╝██╔═══██╗██║████╗  ██║██╔═══██╗██╔════╝
██║     ██║   ██║██║██╔██╗ ██║██║   ██║███████╗
██║     ██║   ██║██║██║╚██╗██║██║   ██║╚════██║
╚██████╗╚██████╔╝██║██║ ╚████║╚██████╔╝███████║
 ╚═════╝ ╚═════╝ ╚═╝╚═╝  ╚═══╝ ╚═════╝ ╚══════╝

> Crypto market data, trading & quant automation for AI agents_

English · 简体中文

What is CoinOS?

One sentence to query. One sentence to trade. One sentence to backtest.

CoinOS is a collection of AI skills wrapping AiCoin Open API — bringing real-time crypto market data, exchange trading, Freqtrade strategy automation, and Hyperliquid whale analytics to any AI agent.

Works with Claude Code, Cursor, Codex, OpenClaw, Windsurf, Gemini CLI and more.

No API key needed — built-in free key works out of the box All data from AiCoin, the leading crypto analytics platform 5 skills, each self-contained and independently installable

Skill Matrix

Market Intelligence Skill Capability aicoin-market Prices, K-lines, funding rates, OI, whale orders, news, signals, airdrops, drop radar	Exchange Trading Skill Capability aicoin-trading Buy/sell across Binance, OKX, Bybit & 6 more exchanges, automated trading strategies
Quant Automation Skill Capability aicoin-freqtrade Strategy creation with AiCoin indicators, backtesting, hyperopt, live bot deployment	Whale Analytics Skill Capability aicoin-hyperliquid Whale position tracking, liquidation data, trader PnL analytics on Hyperliquid
Account Management Skill Capability aicoin-account Balance & positions, order history, API key management, exchange registration with referral links

AiCoin Exclusive Data

Data you can't get anywhere else — aggregated from 200+ exchanges in real time.

Whale & Sentiment Intelligence Data What it tells you Whale Orders Real-time large buy/sell orders across exchanges Long/Short Ratio Aggregated market positioning — are traders net long or short? Funding Rates Cross-exchange weighted rates — spot over-leveraged markets Liquidation Map Heatmap of liquidation clusters — find squeeze zones Open Interest Aggregated OI trends — confirm or question price moves

News & Alpha Discovery Data What it tells you Newsflash Breaking crypto news before it hits mainstream Twitter/X Feed Real-time KOL tweets, influencer discovery Drop Radar Airdrop intelligence: team, funding, X followers, status Signal Alerts Pre-built anomaly & strategy signals Treasury Tracker Institutional holdings (MicroStrategy, funds, etc.)

Most platforms give you prices. AiCoin gives you what the whales are doing, what the market is feeling, and what's about to happen — across 200+ exchanges, in one API.

Strategy & Backtesting

Write strategies in one sentence. Backtest with real data. Deploy to live.

CoinOS integrates with Freqtrade and injects AiCoin's exclusive on-chain/sentiment data directly into your strategies — something no other backtesting tool offers.

17 Built-in Indicators Category Indicators Trend EMA, SMA, ADX, Ichimoku Momentum RSI, MACD, Stochastic/KDJ, CCI, Williams %R Volatility Bollinger Bands, ATR Volume VWAP, OBV, Volume SMA

5 AiCoin-Exclusive Data Feeds Data Strategy use case funding_rate Rate > 0.1% = too many longs, fade the crowd ls_ratio Ratio < 0.45 = crowded shorts, contrarian buy big_orders Positive whale signal = smart money accumulating liquidation_map Liquidation clusters = squeeze opportunity open_interest OI rising + price falling = reversal incoming

One command to create. One command to backtest. One command to deploy.

# 1. Create a strategy with AiCoin data + technical indicators
> "Write a funding rate strategy with RSI and Bollinger Bands, 15m timeframe"

# 2. Backtest against real historical K-line data
> "Backtest it on BTC/USDT, all of 2025"

# 3. Optimize parameters
> "Run hyperopt, 500 epochs"

# 4. Deploy to live
> "Deploy it as a dry-run bot on Binance"

Backtest Results
─────────────────────────────────────────────────
Strategy:       FundingRateStrat
Timerange:      2025-01-01 → 2025-12-31
Pair:           BTC/USDT
─────────────────────────────────────────────────
Total trades:   142
Win rate:       63.4%
Total profit:   +18.7%
Max drawdown:   -8.2%
Sharpe ratio:   1.45
─────────────────────────────────────────────────
AiCoin data:    funding_rate (live/dry-run only)
Indicators:     RSI, Bollinger Bands
─────────────────────────────────────────────────

Traditional backtesting only uses price + volume. CoinOS strategies can additionally react to whale behavior, market sentiment, and liquidation pressure in live trading — giving your bot an edge that pure technical analysis can't match.

Architecture

                         ┌─────────────────────┐
                         │   AI Agent (NL)      │
                         └──────────┬───────────┘
                                    │
                         ┌──────────▼───────────┐
                         │    CoinOS Skills      │
                         └──────────┬───────────┘
                                    │
          ┌─────────────┬───────────┼───────────┬─────────────┐
          │             │           │           │             │
   ┌──────▼──────┐ ┌────▼────┐ ┌────▼────┐ ┌────▼────┐ ┌─────▼─────┐
   │   market    │ │ trading │ │freqtrade│ │  hyper  │ │  account  │
   │             │ │         │ │         │ │ liquid  │ │           │
   │ coin.mjs    │ │exchange │ │ft-deploy│ │hl-market│ │exchange   │
   │ market.mjs  │ │  .mjs   │ │  .mjs   │ │  .mjs   │ │  .mjs     │
   │ news.mjs    │ │auto-    │ │ ft.mjs  │ │hl-trader│ │register   │
   │ features.mjs│ │trade.mjs│ │ft-dev   │ │  .mjs   │ │  .mjs     │
   │ twitter.mjs │ │         │ │  .mjs   │ │         │ │           │
   │newsflash.mjs│ │         │ │         │ │         │ │           │
   └──────┬──────┘ └────┬────┘ └────┬────┘ └────┬────┘ └─────┬─────┘
          │             │           │           │             │
          └─────────────┴───────┬───┴───────────┘             │
                                │                             │
                     ┌──────────▼───────────┐      ┌──────────▼──────────┐
                     │   AiCoin Open API    │      │   Exchange APIs     │
                     │  (market data layer) │      │ Binance/OKX/Bybit.. │
                     └──────────────────────┘      └─────────────────────┘

Each skill is self-contained with its own SKILL.md, lib/, and scripts/. All scripts share a common aicoin-api.mjs client library.

Quick Start

# Install via npx
npx skills add aicoincom/coinos-skills

# Select which skills to install, or use --yes to install all 5

Then, just talk to your AI agent:

> "BTC 现在多少钱？"
> "给我看一下 ETH 的 1 小时 K 线"
> "帮我写一个资金费率策略"
> "查一下 OKX 余额"
> "Hyperliquid 上 BTC 大户都在做什么方向？"

No configuration needed. A built-in free API key works out of the box.

Supported Exchanges

Exchange	ID	Spot	Futures
Binance	binance	✅	✅	World's largest by volume
OKX	okx	✅	✅	Advanced derivatives platform
Bybit	bybit	✅	✅	Leading perpetuals exchange
Bitget	bitget	✅	✅	Copy-trading leader
Gate.io	gate	✅	✅	1700+ trading pairs
HTX	htx	✅	✅	Global digital asset platform
KuCoin	kucoin	✅	✅	The people's exchange
MEXC	mexc	✅	✅	Fast listing exchange
Coinbase	coinbase	✅	—	Regulated US exchange

Usage Examples

Market Data

You:     BTC 现在多少钱？

CoinOS:  BTC/USDT — $84,302.50
         24h Change:  +2.34%
         24h High:    $85,100.00
         24h Low:     $82,450.00
         24h Volume:  $28.5B

K-line & Technical Analysis

You:     Show me ETH 1h K-line.

CoinOS:  Fetches 100 candles from OKX, returns OHLCV data
         with timestamps, ready for charting or analysis.

# Direct script call
node skills/aicoin-market/scripts/market.mjs kline \
  '{"symbol":"ethusdt:okex","period":"3600","size":"100"}'

Exchange Trading

You:     帮我在 Binance 买入 0.1 个 BTC

CoinOS:  Order Preview
         ─────────────────────────────────────
         Exchange:    Binance
         Pair:        BTC/USDT
         Side:        BUY
         Type:        Market
         Amount:      0.1 BTC
         Est. Cost:   ~$8,430.25
         ─────────────────────────────────────
         Confirm to execute.

Strategy & Backtesting

You:     帮我写一个资金费率策略，15分钟周期

CoinOS:  Creating strategy via ft-deploy.mjs...
         ✓ Strategy "FundingRateStrat" created
         ✓ Timeframe: 15m
         ✓ AiCoin data: funding_rate
         ✓ File: user_data/strategies/FundingRateStrat.py

You:     回测一下，2025年全年

CoinOS:  Running backtest...
         ─────────────────────────────────────
         Strategy:    FundingRateStrat
         Timerange:   2025-01-01 → 2025-12-31
         Total trades: 142
         Win rate:     63.4%
         Total profit: +18.7%
         Max drawdown: -8.2%
         Sharpe ratio: 1.45

Hyperliquid Whale Tracking

You:     Hyperliquid 上 BTC 大户都在做什么方向？

CoinOS:  Top BTC Whale Positions (Hyperliquid)
         ─────────────────────────────────────
         🐋 0x1a2b...  LONG   $12.5M   +$340K PnL
         🐋 0x3c4d...  SHORT  $8.2M    -$120K PnL
         🐋 0x5e6f...  LONG   $6.8M    +$89K  PnL
         ─────────────────────────────────────
         Net bias: 65% LONG

Environment Variables

Create a .env file (scripts auto-load from cwd, ~/.openclaw/workspace/.env, or ~/.openclaw/.env):

# AiCoin API (optional — built-in free key works with IP rate limits)
AICOIN_ACCESS_KEY_ID="your-key"
AICOIN_ACCESS_SECRET="your-secret"

# Exchange trading (only if needed)
BINANCE_API_KEY="xxx"
BINANCE_API_SECRET="xxx"
# Supported: BINANCE, OKX, BYBIT, BITGET, GATE, HTX, KUCOIN, MEXC, COINBASE
# OKX also needs: OKX_PASSWORD="xxx"

# Proxy (optional)
PROXY_URL="socks5://127.0.0.1:7890"

Project Structure

coinos-skills/
├── skills/
│   ├── aicoin-market/        # Prices, K-lines, news, signals
│   │   ├── SKILL.md
│   │   ├── lib/
│   │   └── scripts/
│   │       ├── coin.mjs          Prices, tickers, coin info
│   │       ├── market.mjs        K-lines, funding rates, OI
│   │       ├── features.mjs      Whale orders, large trades
│   │       ├── news.mjs          News feed, search
│   │       ├── newsflash.mjs     Breaking news alerts
│   │       ├── twitter.mjs       Crypto Twitter/X feed
│   │       ├── airdrop.mjs       Airdrop queries
│   │       └── drop_radar.mjs    Drop radar & project analysis
│   │
│   ├── aicoin-trading/       # Exchange trading
│   │   ├── SKILL.md
│   │   ├── lib/
│   │   └── scripts/
│   │       ├── exchange.mjs      Orders, balance, positions
│   │       └── auto-trade.mjs    Automated trading strategies
│   │
│   ├── aicoin-freqtrade/     # Strategy automation
│   │   ├── SKILL.md
│   │   ├── lib/
│   │   └── scripts/
│   │       ├── ft-deploy.mjs     Create, backtest, deploy bots
│   │       ├── ft.mjs            Freqtrade CLI wrapper
│   │       └── ft-dev.mjs        Strategy development helpers
│   │
│   ├── aicoin-hyperliquid/   # Whale analytics
│   │   ├── SKILL.md
│   │   ├── lib/
│   │   └── scripts/
│   │       ├── hl-market.mjs     Tickers, orderbook, trades
│   │       └── hl-trader.mjs     Whale positions, PnL, leaderboard
│   │
│   └── aicoin-account/       # Account management
│       ├── SKILL.md
│       ├── lib/
│       └── scripts/
│           ├── exchange.mjs      Balance, positions, orders
│           ├── api-key-info.mjs  API key management
│           ├── check-tier.mjs    Verify API tier/subscription
│           └── register.mjs      Exchange registration
│
├── AGENTS.md                 # Skill routing for AI agents
├── CLAUDE.md                 # Dev instructions
└── .claude-plugin/
    └── plugin.json           # Plugin metadata

License

MIT License

Powered by AiCoin Open API · CCXT · Freqtrade

Built for AI-native crypto trading.

_{Made by AiCoin}