jiayaoqijia aicoin-official-coinos-skills
Source: github.com/aicoincom/coinos-skills. The body below is the upstream README.md captured at the time of registration.
> Crypto market data, trading & quant automation for AI agents_
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
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
Powered by AiCoin Open API · CCXT · Freqtrade
Built for AI-native crypto trading.
Made by AiCoin