opentrade

1. Confirm installed: Run

   which opentrade

   . If not found, install it:
   bash

   curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh

   If the install script fails, ask the user to install manually following the instructions at: https://github.com/6551Team/openskills
2. Check for updates: Read

   ~/.opentrade/last_check

   and compare it with the current timestamp:
   bash

   cached_ts=$(cat ~/.opentrade/last_check 2>/dev/null || true)
   now=$(date +%s)

   • If

     cached_ts

     is non-empty and

     (now - cached_ts) < 43200

     (12 hours), skip the update and proceed.
   • Otherwise (file missing or older than 12 hours), run the installer to check for updates:
     bash

     curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh

     If a newer version is installed, tell the user and suggest updating their opentrade skills from https://github.com/6551Team/openskills to get the latest features.
3. If any

   opentrade

   command fails with an unexpected error during this session, try reinstalling before giving up:
   bash

   curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh

4. Find or create a .env file in the project root to override the default API credentials, Load it before performing opentrade operations.

OPEN_TOKEN=your_token_here

opentrade trade routers

{
  "ok": true,
  "data": [
    {
      "api": "v2",
      "created_at": "2026-03-10 01:15:42",
      "is_active": true,
      "name": "6551dex test",
      "quota_reward": 0,
      "trader": "6551dex",
      "updated_at": "2026-03-10 01:15:42"
    },
    {
      "api": "v1",
      "created_at": "2026-03-03 21:24:34",
      "is_active": true,
      "name": "okx test",
      "quota_reward": 0,
      "trader": "okx",
      "updated_at": "2026-03-03 21:24:34"
    }
  ]
}

• Extract

  trader

  and

  api

  from the response
• MANDATORY: ALL subsequent

  opentrade

  commands in this session MUST include

  --trader <trader>

  and

  --api <api>

  flags
• Example:

  opentrade swap quote --from 0x... --to 0x... --amount 100 --chain ethereum --trader okx --api v1

• Default fallback: If the API returns no data or is empty, use

  --trader okx --api v1

• For token search → use

  opentrade-token

• For market prices → use

  opentrade-market

• For transaction broadcasting → use

  opentrade-gateway

• For wallet balances / portfolio → use

  opentrade-portfolio

CRITICAL: Each chain has a specific native token address. Using the wrong address will cause swap transactions to fail.

0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee

11111111111111111111111111111111

0x2::sui::SUI

T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb

EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c

WARNING — Solana native SOL: The correct address is

11111111111111111111111111111111

(Solana system program). Do NOT use

So11111111111111111111111111111111111111112

(wSOL SPL token) — it is a different token and will cause swap failures.

User: "Swap 1 SOL for BONK on Solana"

1. opentrade-token    opentrade token search BONK --chains solana               → get BONK tokenContractAddress
       ↓ tokenContractAddress
2. opentrade-dex-swap opentrade swap quote \
                      --from 11111111111111111111111111111111 \
                      --to <BONK_address> --amount 1000000000 --chain solana → get quote
       ↓ user confirms
3. opentrade-dex-swap opentrade swap swap \
                      --from 11111111111111111111111111111111 \
                      --to <BONK_address> --amount 1000000000 --chain solana \
                      --wallet <addr>                                        → get swap calldata
4. User signs the transaction
5. opentrade-gateway  opentrade gateway broadcast --signed-tx <tx> --address <addr> --chain solana

• tokenContractAddress

  from step 1 →

  --to

  in steps 2-3
• SOL native address =

  11111111111111111111111111111111

  →

  --from

  . Do NOT use wSOL address.
• Amount

  1 SOL

  =

  1000000000

  (9 decimals) →

  --amount

  param

User: "Swap 100 USDC for OKB on XLayer"

1. opentrade-token    opentrade token search USDC --chains xlayer               → get USDC address
2. opentrade-dex-swap opentrade swap quote --from <USDC> --to 0xeeee...eeee --amount 100000000 --chain xlayer
       ↓ check isHoneyPot, taxRate, priceImpactPercent
3. opentrade-dex-swap opentrade swap approve --token <USDC> --amount 100000000 --chain xlayer
4. User signs the approval transaction
5. opentrade-gateway  opentrade gateway broadcast --signed-tx <tx> --address <addr> --chain xlayer
6. opentrade-dex-swap opentrade swap swap --from <USDC> --to 0xeeee...eeee --amount 100000000 --chain xlayer --wallet <addr>
7. User signs the swap transaction
8. opentrade-gateway  opentrade gateway broadcast --signed-tx <tx> --address <addr> --chain xlayer

• View a quote →

  opentrade swap quote

• Execute a swap → full swap flow (quote → approve → swap)
• List available DEXes →

  opentrade swap liquidity

• Approve a token →

  opentrade swap approve

• Missing chain → recommend XLayer (

  --chain xlayer

  , low gas, fast confirmation) as the default, then ask which chain the user prefers
• Missing token addresses → use

  opentrade-token

  opentrade token search

  to resolve name → address
• Missing amount → ask user, remind to convert to minimal units
• Missing slippage → suggest 1% default, 3-5% for volatile tokens
• Missing wallet address → ask user

• Quote phase: call

  opentrade swap quote

  , display estimated results
  • Expected output, gas estimate, price impact, routing path
  • Check

    isHoneyPot

    and

    taxRate

    — surface safety info to users
• Confirmation phase: wait for user approval before proceeding
• Approval phase (EVM only): check/execute approve if selling non-native token
• Execution phase: call

  opentrade swap swap

  , return tx data for signing

• High slippage (>5%): warn user, suggest splitting the trade or adjusting slippage
• Large price impact (>10%): strongly warn, suggest reducing amount
• Honeypot token:

  isHoneyPot = true

  — block trade and warn user
• Tax token:

  taxRate

  non-zero — display to user (e.g. 5% buy tax)
• Insufficient balance: check balance first, show current balance, suggest adjusting amount
• exactOut not supported: only Ethereum/Base/BSC/Arbitrum — prompt user to use

  exactIn

• Solana native SOL address: Must use

  11111111111111111111111111111111

  (system program), NOT

  So11111111111111111111111111111111111111112

  (wSOL)
• Network error: retry once, then prompt user to try again later
• Region restriction (error code 50125 or 80001): do NOT show the raw error code to the user. Instead, display a friendly message:

  ⚠️ Service is not available in your region. Please switch to a supported region and try again.

• Input/output amounts in UI units (

  1.5 ETH

  ,

  3,200 USDC

  )
• Internal CLI params use minimal units (

  1 USDC

  =

  "1000000"

  ,

  1 ETH

  =

  "1000000000000000000"

  )
• Gas fees in USD

• minReceiveAmount

  in both UI units and USD
• Price impact as percentage

• Amounts must be in minimal units (wei/lamports)

• exactOut

  only on Ethereum(

  1

  )/Base(

  8453

  )/BSC(

  56

  )/Arbitrum(

  42161

  )
• Check

  isHoneyPot

  and

  taxRate

  — surface safety info to users
• EVM contract addresses must be all lowercase
• The CLI resolves chain names automatically (e.g.,

  ethereum

  →

  1

  ,

  solana

  →

  501

  )
• The CLI handles authentication internally via environment variables — see Prerequisites step 4 for default values