Nofx

NOFX AI Trading Skill

Integrate with NOFX - the open-source AI-powered crypto trading operating system.

Quick Reference

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:

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

# 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

# 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

# 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

# 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

# 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

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

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