coinos-skills

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

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

English · 简体中文

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

AiCoin Exclusive Data

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

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.

# 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

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

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

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

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.

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

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"

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}