NOFX AI Trading OS integration - crypto market data, AI trading signals, strategy management, trader control, and automated reporting. Use when working with...
---
name: nofx
description: NOFX AI Trading OS integration - crypto market data, AI trading signals, strategy management, trader control, and automated reporting. Use when working with NOFX platform (nofxai.com, nofxos.ai) for crypto trading, market analysis, AI500/AI300 signals, fund flow tracking, OI monitoring, strategy creation, trader management, backtesting, or AI debate arena.
---
# NOFX AI Trading Skill
Integrate with NOFX - the open-source AI-powered crypto trading operating system.
## Quick Reference
| Resource | URL |
|----------|-----|
| Web Dashboard | https://nofxai.com |
| Data API | https://nofxos.ai |
| API Docs | https://nofxos.ai/api-docs |
| GitHub | https://github.com/NoFxAiOS/nofx |
## Deployment
For installation and deployment instructions, see `references/deployment.md`:
- One-click install (Linux/macOS/Docker)
- Windows installation (Docker Desktop / WSL2)
- Railway cloud deployment
- Manual installation for developers
- Server deployment with HTTPS
## Supported Exchanges
For exchange registration links (with fee discounts) and API setup, see `references/exchanges.md`:
**CEX**: Binance, Bybit, OKX, Bitget, KuCoin, Gate.io
**DEX**: Hyperliquid, Aster DEX, Lighter
**AI Models**: DeepSeek, Qwen, OpenAI, Claude, Gemini, Grok, Kimi
## Configuration
Store credentials in workspace `skills/nofx/config.json`:
```json
{
"api_key": "cm_xxxxxx",
"web_email": "user@example.com",
"browser_profile": "clawd"
}
```
## 1. Market Data (API)
Base URL: `https://nofxos.ai`
Auth: `?auth=API_KEY` or `Authorization: Bearer API_KEY`
### AI Signals
```bash
# AI500 - High potential coins (score > 70)
curl "https://nofxos.ai/api/ai500/list?auth=$KEY"
# AI300 - Quantitative flow signals (S/A/B levels)
curl "https://nofxos.ai/api/ai300/list?auth=$KEY&limit=10"
# Single coin AI analysis
curl "https://nofxos.ai/api/ai500/{symbol}?auth=$KEY"
```
### Fund Flow
```bash
# Institution inflow ranking
curl "https://nofxos.ai/api/netflow/top-ranking?auth=$KEY&limit=10&duration=1h&type=institution"
# Outflow ranking
curl "https://nofxos.ai/api/netflow/low-ranking?auth=$KEY&limit=10&duration=1h&type=institution"
```
### Open Interest
```bash
# OI increase ranking
curl "https://nofxos.ai/api/oi/top-ranking?auth=$KEY&limit=10&duration=1h"
# OI decrease ranking
curl "https://nofxos.ai/api/oi/low-ranking?auth=$KEY&limit=10&duration=1h"
# OI market cap ranking
curl "https://nofxos.ai/api/oi-cap/ranking?auth=$KEY&limit=10"
```
### Price & Rates
```bash
# Price ranking (gainers/losers)
curl "https://nofxos.ai/api/price/ranking?auth=$KEY&duration=1h"
# Funding rate top (crowded longs)
curl "https://nofxos.ai/api/funding-rate/top?auth=$KEY&limit=10"
# Funding rate low (crowded shorts)
curl "https://nofxos.ai/api/funding-rate/low?auth=$KEY&limit=10"
# Long-short ratio anomalies
curl "https://nofxos.ai/api/long-short/list?auth=$KEY&limit=10"
```
### Single Coin Data
```bash
# Comprehensive coin data
curl "https://nofxos.ai/api/coin/{symbol}?auth=$KEY&include=all"
# Order book heatmap
curl "https://nofxos.ai/api/heatmap/future/{symbol}?auth=$KEY"
```
Duration options: `1m, 5m, 15m, 30m, 1h, 4h, 8h, 12h, 24h, 2d, 3d, 5d, 7d`
## 2. Strategy Management (Browser)
Use browser automation on https://nofxai.com/strategy
### Strategy Structure
```json
{
"strategy_type": "ai_trading",
"language": "en",
"coin_source": {
"source_type": "ai500|static|oi_top|oi_low|mixed",
"static_coins": ["BTC", "ETH"],
"use_ai500": true,
"ai500_limit": 10
},
"indicators": {
"enable_ema": true,
"enable_rsi": true,
"enable_atr": true,
"enable_boll": true,
"enable_oi": true,
"enable_funding_rate": true,
"enable_quant_data": true,
"nofxos_api_key": "cm_xxx"
},
"risk_control": {
"max_position_pct": 10,
"stop_loss_pct": 3,
"take_profit_pct": 5
},
"prompt_sections": {
"role_definition": "...",
"entry_standards": "...",
"decision_process": "..."
}
}
```
### Natural Language Strategy Creation
When user describes a strategy in natural language:
1. Parse requirements (coins, indicators, entry/exit rules, risk)
2. Generate StrategyConfig JSON
3. Navigate to Strategy Studio
4. Create new strategy and fill in fields
5. Save and activate
## 3. Trader Management (Browser)
Use browser automation on https://nofxai.com/traders
### Actions
- **List**: Navigate to /traders, parse trader list
- **Create**: Click "Create Trader", select model/exchange/strategy
- **Start/Stop**: Click Start/Stop button on trader card
- **View**: Click "View" for details and logs
### Trader Config
```
Model: claude|deepseek|gpt|gemini|grok|kimi|qwen
Exchange: binance|bybit|okx|bitget|kucoin|gate|hyperliquid|aster|lighter
Strategy: Select from strategy list
```
## 4. Dashboard (Browser)
Navigate to https://nofxai.com/dashboard
### Available Data
- Account equity and balance
- Total P/L (absolute and percentage)
- Current positions
- Equity curve chart
- Trade history
- AI decision logs
## 5. Arena - AI Debate (Browser)
Navigate to https://nofxai.com/debate
### Create Debate
1. Click "New Debate"
2. Select symbol
3. Select AI models and roles:
- Bull: Finds long opportunities
- Bear: Finds short opportunities
- Analyst: Neutral analysis
4. Run debate rounds
5. Get consensus recommendation
## 6. Backtest (Browser)
Navigate to https://nofxai.com/backtest
### Run Backtest
1. Select AI model
2. Select strategy (optional)
3. Enter symbols (comma-separated)
4. Set time range
5. Run and analyze results
## 7. Monitoring & Alerts
### Cron Job for Market Reports
```json
{
"name": "NOFX Market Report",
"schedule": {"kind": "cron", "expr": "*/30 * * * *"},
"sessionTarget": "isolated",
"payload": {
"kind": "agentTurn",
"message": "Fetch NOFX data and generate market report...",
"deliver": true,
"channel": "telegram",
"to": "USER_ID"
}
}
```
### Report Contents
- 🤖 AI500 signals (coin + score + gain)
- 💰 Institution flow TOP10
- 🚀 Price gainers TOP10
- 📈 OI increase TOP10
- 📉 OI decrease TOP10
- ⚠️ Drop alerts
## 8. Common Workflows
### Daily Market Check
1. Fetch AI500/AI300 signals
2. Check institution fund flow
3. Monitor OI changes
4. Identify opportunities
### Strategy Development
1. Analyze market data
2. Define entry/exit rules
3. Create strategy in Studio
4. Backtest with historical data
5. Create trader and start
### Risk Monitoring
1. Check dashboard P/L
2. Review positions
3. Monitor drawdown
4. Adjust or stop traders if needed
## API Response Examples
See `references/api-examples.md` for detailed response structures.
## Additional References
| Reference | Description |
|-----------|-------------|
| `references/grid-trading.md` | Grid trading detailed guide with examples |
| `references/market-charts.md` | Market page and chart analysis |
| `references/multi-account.md` | Multi-account management |
| `references/webhooks.md` | Telegram/Discord/Slack notifications |
| `references/faq.md` | Frequently asked questions |
don't have the plugin yet? install it then click "run inline in claude" again.