agentleFS
zad111ak-aizad111ak-ai/hermes-agent-skills/skills/productivity/trading-bot-deployment/SKILL.md

trading-bot-deployment

Skill7 starsChanged 4 months agoMITView on GitHub

Patterns for deploying and running CEX trading bots (freqtrade, custom) in DPI-restricted environments — proxy configuration, exchange API access, WebSocket vs REST, and bot lifecycle.

  • Installs packages

The file

We split this skill into the rules it gives an agent

10 rules. About 0 are common, 2 are distinctive, and 8 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 8

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    PITfall: If api2.bybit.com is blocked by Akamai (not DPI), switching proxy providers won't help.

    line 49
  2. Very specific:

    Custom bot fix: Use REST polling with fetch_ohlcv() or fetch_ticker() on interval.

    line 91
  3. Very specific:

    Fix: Use -m freqtrade module invocation:

    line 142
  4. Very specific:

    Or create a wrapper run.py that injects proxy env vars via subprocess:

    line 147
  5. Very specific:

    Fix: Use "trading_mode": "spot" to skip leverage tier fetching entirely.

    line 166
  6. Very specific:

    Start with dry_run: true + dry_run_wallet: 100 to verify strategy works

    line 170
  7. Very specific:

    Check logs for state: RUNNING and REST polling (no WS errors)

    line 171
  8. Distinctive:

    If getting 401 → wrong key/domain combination

    line 212
  9. Very specific:

    Use terminal(background=True) — never nohup in foreground terminal.

    line 229
  10. Distinctive:

    Use trailing stop (e.g. -5% stoploss, trailing offset +2%)

    line 257

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Trading Bot Deployment

Patterns for setting up CEX trading bots (freqtrade, custom scripts) in restricted network environments (DPI/Russia).

Architecture

DPI-restricted host (WSL2/RF VPS)
  ├── Hysteria2 SOCKS5/HTTP proxy (port 1081/1082)
  │   └── Routes to non-blocked exit IP
  ├── Trading bot (freqtrade / custom)
  │   ├── REST API calls → via HTTP proxy ✅
  │   ├── WebSocket streams → blocked by DPI ❌
  │   └── Config: enable_ws=false, aiohttp_proxy set
  └── Exchange (Bybit/OKX/Binance)
      ├── api.bybit.com → works via proxy ✅
      ├── api2.bybit.com → blocked by Akamai CDN ❌ (not DPI)
      ├── api-testnet.bybit.com → works via proxy ✅
      └── stream.bybit.com → blocked by DPI ❌ (even via proxy)

⚠️ PITFALL: DPI vs CDN Blocking — Different Problems, Different Fixes

DPI blocking (Russia): ISP deep packet inspection blocks exchange domains. Fix: route through proxy (Hysteria2/SOCKS5).

CDN blocking (Akamai/Cloudflare): Exchange's own CDN blocks datacenter IPs. Fix: residential proxy or different endpoint. Datacenter proxy IPs (even through Hysteria) get blocked.

Diagnostic pattern:

# 1. Test direct (DPI blocks this)
curl -s https://api.bybit.com/v5/market/time

# 2. Test through proxy (if CDN blocks → 404/403)
curl -x http://127.0.0.1:1082 https://api.bybit.com/v5/market/time

# 3. If proxy works → DPI was the problem
# 4. If proxy returns 404/403 → CDN blocks proxy IP → need different endpoint or residential proxy

PITfall: If api2.bybit.com is blocked by Akamai (not DPI), switching proxy providers won't help. Use api.bybit.com instead — same API, different CDN edge.

⚠️ PITFALL: aiohttp Ignores HTTP_PROXY

Python's aiohttp does NOT respect HTTP_PROXY/HTTPS_PROXY environment variables. This breaks most trading bots that use async HTTP.

freqtrade fix — use ccxt config:

{
    "ccxt_config": {
        "aiohttp_proxy": "http://127.0.0.1:1082"
    },
    "ccxt_async_config": {
        "aiohttp_proxy": "http://127.0.0.1:1082"
    }
}

Custom bot fix — pass connector directly:

import aiohttp
connector = aiohttp.TCPConnector()
session = aiohttp.ClientSession(connector=connector)
# Or set proxy per-request:
async with session.get(url, proxy="http://127.0.0.1:1082") as resp:
    ...

requests library DOES respect HTTP_PROXY — no extra config needed.

⚠️ PITFALL: WebSocket Blocked by DPI Even Through Proxy

WebSocket upgrade requests are often blocked by DPI even when REST HTTP works through the same proxy. The DPI inspects the Upgrade: websocket header.

freqtrade fix:

{
    "enable_ws": false
}

This forces REST polling (every candle close) instead of real-time WS. Slower but reliable.

Custom bot fix: Use REST polling with fetch_ohlcv() or fetch_ticker() on interval.

Performance impact: REST polling adds latency (up to candle interval, e.g. 15m). For high-frequency strategies this matters. For swing/day trading it's fine.

freqtrade Setup (DPI-Restricted Environment)

Dependencies

# Use existing venv if available
source ~/harvest/venv/bin/activate
pip install freqtrade

Minimum Working Config (Bybit + Proxy)

{
    "trading_mode": "spot",
    "max_open_trades": 3,
    "stake_currency": "USDT",
    "stake_amount": 5,
    "dry_run": true,
    "dry_run_wallet": 100,
    "enable_ws": false,
    "exchange": {
        "name": "bybit",
        "ccxt_config": {
            "aiohttp_proxy": "http://127.0.0.1:1082"
        },
        "ccxt_async_config": {
            "aiohttp_proxy": "http://127.0.0.1:1082"
        },
        "pair_whitelist": ["BTC/USDT", "ETH/USDT", "SOL/USDT"]
    },
    "entry_pricing": {
        "price_side": "same",
        "use_order_book": true,
        "order_book_top": 1
    },
    "exit_pricing": {
        "price_side": "same",
        "use_order_book": true,
        "order_book_top": 1
    },
    "pairlists": [{"method": "StaticPairList"}]
}

⚠️ PITFALL: freqtrade run.py Entry Point (v2024+)

Newer freqtrade versions changed start_trading() signature — it now requires args parameter. Using python run.py trade directly fails.

Fix: Use -m freqtrade module invocation:

python3 -m freqtrade trade --config config.json --strategy MyStrategy --dry-run

Or create a wrapper run.py that injects proxy env vars via subprocess:

#!/usr/bin/env python3
import os, sys, subprocess
proxy_env = os.environ.copy()
proxy_env.update({
    'HTTP_PROXY': 'http://127.0.0.1:1082',
    'HTTPS_PROXY': 'http://127.0.0.1:1082',
    'http_proxy': 'http://127.0.0.1:1082',
    'https_proxy': 'http://127.0.0.1:1082',
})
result = subprocess.run([sys.executable, '-m', 'freqtrade'] + sys.argv[1:], env=proxy_env)
sys.exit(result.returncode)

Leverage Tiers Issue

freqtrade fetches leverage tiers on startup for futures mode. This often fails through proxies.

Fix: Use "trading_mode": "spot" to skip leverage tier fetching entirely.

Dry Run → Live Transition

  1. Start with dry_run: true + dry_run_wallet: 100 to verify strategy works
  2. Check logs for state: RUNNING and REST polling (no WS errors)
  3. Set dry_run: false and add API keys to config
  4. Start with minimum stake amount ($5) to test live execution

Bybit API Reference

Endpoints

EndpointPurposeDPICDN
api.bybit.comMain REST API✅ via proxy✅
api2.bybit.comBackup REST API✅ via proxy❌ Akamai blocks
api-testnet.bybit.comTestnet REST✅ via proxy✅
stream.bybit.comWebSocket❌ DPI blocksN/A

V5 Signature (HMAC-SHA256)

import hmac, hashlib, time, urllib.parse

def sign_request(api_key, secret, params=None):
    timestamp = str(int(time.time() * 1000))
    recv_window = "5000"
    
    query_string = ""
    if params:
        query_string = urllib.parse.urlencode(sorted(params.items()))
    
    sign_str = f"{timestamp}{api_key}{recv_window}{query_string}"
    signature = hmac.new(secret.encode(), sign_str.encode(), hashlib.sha256).hexdigest()
    
    return {
        "X-BAPI-API-KEY": api_key,
        "X-BAPI-SIGN": signature,
        "X-BAPI-TIMESTAMP": timestamp,
        "X-BAPI-RECV-WINDOW": recv_window,
    }

Testnet vs Mainnet

  • Keys created on mainnet → only work on api.bybit.com
  • Keys created on testnet → only work on api-testnet.bybit.com
  • API: POST /v5/user/create-api on respective domain
  • If getting 401 → wrong key/domain combination

Account Info

# Balance
curl -H "X-BAPI-API-KEY: <key>" -H "X-BAPI-SIGN: <sig>" \
     -H "X-BAPI-TIMESTAMP: <ts>" -H "X-BAPI-RECV-WINDOW: 5000" \
     "https://api.bybit.com/v5/account/wallet-balance?accountType=unified"

Bot Lifecycle

Start (Background)

cd /path/to/bot && source venv/bin/activate
python3 -m freqtrade trade --config config.json --strategy MyStrategy --dry-run

Use terminal(background=True) — never nohup in foreground terminal.

Verify

# Check process alive
ps aux | grep freqtrade | grep -v grep

# Check logs for RUNNING state
process(action='log', limit=30)

Stop

pkill -f "freqtrade trade"
# Or via process(action='kill', session_id=...)

⚠️ PITFALL: Small Balance Economics ($5–$50)

On tiny balances, fees dominate:

  • Bybit spot fee: ~0.1% per trade (maker/taker)
  • A round-trip (buy+sell) costs ~0.2%
  • On $5 stake = $0.01 per trade — fees are negligible
  • But stop-loss + ROI targets must be > fees to be profitable
  • Rule of thumb: minimum profitable trade = stake × 0.5% (covers fees + slippage)

Strategy Tuning for Small Balances

  • Increase minimum_roi thresholds (don't exit for 0.3% gains)
  • Use trailing stop (e.g. -5% stoploss, trailing offset +2%)
  • Fewer but higher-confidence entries (RSI < 25 instead of < 30)
  • 15m+ timeframe (1m/5m too noisy, fees eat micro-gains)
  • Max 2–3 concurrent positions (capital too thin for more)

Fiat→Crypto On-Ramp (Russia)

See references/fiat-to-crypto-russia.md for methods to fund exchange accounts from Russian bank cards (Bybit P2P, Telegram bots, BestChange).

Relevant References

  • references/bybit-api.md — Bybit V5 API details, endpoint testing, signature patterns
  • references/fiat-to-crypto-russia.md — Fiat→crypto funding methods for RF users
  • references/freqtrade-proxy.md — freqtrade proxy configuration deep-dive

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.