Dca Swap Agent

Recommendation: Run in Paper Mode first. After understanding the agent behavior, consider whether to enable Live Mode with small amounts.

Pre-flight Checks

Before using this skill, ensure:

1. The onchainos CLI is installed (>= 2.0.0):

   # Windows (PowerShell)
   irm https://raw.githubusercontent.com/okx/onchainos-skills/main/install.ps1 | iex
   
   # macOS / Linux
   curl -sSL https://raw.githubusercontent.com/okx/onchainos-skills/main/install.sh | sh
   

   If onchainos is not found after install, add to PATH:

   export PATH="$HOME/.local/bin:$PATH"
   

2. Log in to Agentic Wallet (one-time, email verification):

   onchainos wallet login <your-email>
   onchainos wallet status
   # Confirm: loggedIn: true
   

3. Confirm X Layer wallet address:

   onchainos wallet addresses --chain 196
   

4. Find token contract addresses on X Layer:

   onchainos token search --chain xlayer --query USDT
   onchainos token search --chain xlayer --query OKB
   

5. Set token addresses in scripts/config.py:

   • FROM_TOKEN = USDT contract address
   • TO_TOKEN = target token contract address

6. Python 3.8+ installed (standard library only, no pip packages needed).

File Structure

dca-swap-agent/
├── scripts/
│   ├── agent.py          # Main DCA agent loop
│   └── config.py         # All parameters (hot-reload)
├── SKILL.md              # This file
├── .claude-plugin/
│   └── plugin.json       # Claude skill metadata
├── .env.example          # API key template
├── LICENSE
└── README.md

Commands

Find Token Addresses

onchainos token search --chain xlayer --query USDT

When to use: Before first run, to find the contract addresses for FROM_TOKEN and TO_TOKEN on X Layer. Output: Token name, symbol, contract address, decimals.

Check Wallet Balance

onchainos wallet balance --chain 196

When to use: To verify the agent wallet has sufficient funds before starting. Output: List of token balances on X Layer.

Check Token Price

onchainos market prices --tokens 196:<token_address>

When to use: To view the current price of the target token. Output: Current USD price, 24h change.

Run Security Scan

onchainos security token-scan --address <token_address> --chain xlayer

When to use: To verify a token is safe before adding it as TO_TOKEN. Output: Risk level, honeypot status, tax rate.

Get Swap Quote (Paper Trade)

onchainos swap quote --from <from_token> --to <to_token> --amount <amount_raw> --chain xlayer

When to use: To preview a swap without executing it. Output: Expected output amount, price impact, route.

Execute Swap (Live Trade)

onchainos swap swap --from <from_token> --to <to_token> --amount <amount_raw> --chain xlayer --wallet <address> --slippage 0.5

When to use: Only when DRY_RUN = False in config.py. Executes a real swap via TEE signing. Output: Transaction hash, amounts swapped.

Start the Agent

cd scripts
python3 agent.py

When to use: To start the autonomous DCA loop. Output: Logs each DCA cycle to stdout. Dashboard at http://localhost:3196.

Stop the Agent

Press Ctrl+C in the terminal, or:

pkill -f agent.py

AI Agent Startup Interaction Protocol

When a user requests to start this strategy, follow this procedure.

Phase 1: Present Overview

Show the user:

DCA Swap Agent v1.0.0 - X Layer

This agent periodically buys a target token using a fixed amount.
Default: 1.0 USDT per swap, every 5 minutes.
Includes stop-loss, spending limits, and security scanning.

Current mode: PAPER (no real funds spent)
Dashboard: http://localhost:3196

Risk: On-chain trading carries high risk. You may lose all capital.

Phase 2: Configuration

Ask the user:

1. Target token: Which token to DCA into? (default: OKB)
2. Amount per swap: How much per cycle? (default: 1.0 USDT)
3. Interval: How often? (default: every 5 minutes)
4. Max spend: Total budget limit? (default: 50 USDT)

Then:

• Run onchainos token search --chain xlayer --query <token> to find addresses.
• Write token addresses to config.py.
• Set PAUSED = False to start.

Phase 3: Mode Selection

• A. Stay in Paper Mode (recommended default)
• B. Switch to Live Mode

If Live Mode:

1. Confirm: "Live Mode uses real funds. Losses are irreversible. Confirm?"
2. Set DRY_RUN = False in config.py.
3. Verify wallet balance covers at least SWAP_AMOUNT + RESERVE_AMOUNT.

Phase 4: Launch

1. Verify prerequisites: onchainos --version, onchainos wallet status
2. Start: cd scripts && python3 agent.py
3. Show dashboard link: http://localhost:3196
4. Inform user of current mode and parameters.

If user says "just run it" -> launch with defaults in Paper Mode, set PAUSED = False.

Parameter Tuning

All parameters are in scripts/config.py. Changes take effect on the next cycle (hot-reload via importlib.reload, no restart needed).

Error Handling

Security Notices

• Risk Level: Advanced - This plugin performs automated trading.
• Paper Mode is the default. No real trades occur until DRY_RUN = False.
• Private keys are never exposed. All signing uses onchainos Agentic Wallet (TEE secure enclave).
• Stop-loss and spending limits are enforced to cap losses.
• Security scanning runs before every swap to detect honeypots and scam tokens.
• No external API calls beyond onchainos CLI (which calls the OKX API).

Skill Routing

• For manual token swaps -> use okx-dex-swap skill
• For wallet balance queries -> use okx-wallet-portfolio skill
• For security scanning -> use okx-security skill
• For token discovery -> use okx-dex-token skill
• For market data / charts -> use okx-dex-market skill