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 gateway gas --chain ethereum --trader okx --api v1

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

  --trader okx --api v1

• For swap quote and execution → use

  opentrade-dex-swap

• For market prices → use

  opentrade-market

• For token search → use

  opentrade-token

• For wallet balances / portfolio → use

  opentrade-portfolio

• For transaction broadcasting → use this skill (

  opentrade-gateway

  )

User: "Swap 1 ETH for USDC and broadcast it"

1. opentrade-dex-swap     opentrade swap swap --from ... --to ... --amount ... --chain ethereum --wallet <addr>
       ↓ user signs the tx locally
2. opentrade-gateway  opentrade gateway broadcast --signed-tx <signed_hex> --address <addr> --chain ethereum
       ↓ orderId returned
3. opentrade-gateway  opentrade gateway orders --address <addr> --chain ethereum --order-id <orderId>

• tx.data

  ,

  tx.to

  ,

  tx.value

  ,

  tx.gas

  from swap → user builds & signs →

  --signed-tx

  for broadcast

• orderId

  from broadcast →

  --order-id

  param in orders query

User: "Simulate this transaction first, then broadcast if safe"

1. opentrade gateway simulate --from 0xWallet --to 0xContract --data 0x... --chain ethereum
       ↓ simulation passes (no revert)
2. opentrade gateway broadcast --signed-tx <signed_hex> --address 0xWallet --chain ethereum
3. opentrade gateway orders --address 0xWallet --chain ethereum --order-id <orderId>

User: "Check gas, swap for USDC, then send it"

1. opentrade gateway gas --chain ethereum                                    → check gas prices
2. opentrade-dex-swap     opentrade swap swap --from ... --to ... --chain ethereum --wallet <addr>
       ↓ user signs
3. opentrade gateway broadcast --signed-tx <signed_hex> --address <addr> --chain ethereum
4. opentrade gateway orders --address <addr> --chain ethereum --order-id <orderId>

• Estimate gas for a chain →

  opentrade gateway gas

• Estimate gas limit for a specific tx →

  opentrade gateway gas-limit

• Test if a tx will succeed →

  opentrade gateway simulate

• Broadcast a signed tx →

  opentrade gateway broadcast

• Track a broadcast order →

  opentrade gateway orders

• Check supported chains →

  opentrade gateway chains

• Missing chain → recommend XLayer (

  --chain xlayer

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

  --signed-tx

  → remind user to sign the transaction first (this CLI does NOT sign)
• Missing wallet address → ask user

• Run the command
• Parse JSON output
• Display human-readable summary (see each command section below)

opentrade gateway chains

{
  "code": "0",
  "data": [
    { "chainId": "196", "chainName": "XLayer" },
    { "chainId": "1", "chainName": "Ethereum" },
    { "chainId": "501", "chainName": "Solana" }
  ],
  "msg": ""
}

• List chain names with IDs
• Highlight commonly used chains

opentrade gateway gas --chain <chain_name>

• --chain

  : Chain name (e.g.,

  xlayer

  ,

  ethereum

  ,

  solana

  )

opentrade gateway gas --chain xlayer

{
  "code": "0",
  "data": [
    {
      "chainId": "196",
      "eip1559Protocol": {
        "suggestBaseFee": "100000000",
        "proposePriorityFee": "0"
      },
      "normal": {
        "maxFeePerGas": "100000000",
        "baseFee": "100000000",
        "gasPrice": "100000000",
        "priorityFeePerGas": "0"
      },
      "fast": {
        "maxFeePerGas": "100000000",
        "baseFee": "100000000",
        "gasPrice": "100000000",
        "priorityFeePerGas": "0"
      },
      "slow": {
        "maxFeePerGas": "100000000",
        "baseFee": "100000000",
        "gasPrice": "100000000",
        "priorityFeePerGas": "0"
      }
    }
  ],
  "msg": ""
}

• Convert wei to Gwei:

  100000000 wei = 0.1 Gwei

• Show all three speeds: slow, normal, fast
• Recommend "normal" for most transactions

opentrade gateway gas-limit \
  --from <sender_address> \
  --to <recipient_address> \
  --chain <chain_name> \
  [--value <amount_in_wei>] \
  [--data <hex_data>]

• --from

  : Sender wallet address (required)

• --to

  : Recipient address (required)

• --chain

  : Chain name (required)

• --value

  : Amount to send in wei (optional, default:

  0

  )

• --data

  : Transaction data in hex format (optional, default:

  0x

  )

opentrade gateway gas-limit \
  --from 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb \
  --to 0x1234567890abcdef1234567890abcdef12345678 \
  --chain xlayer \
  --value 1000000000000000000

{
  "code": "0",
  "data": [
    {
      "gasLimit": "21000"
    }
  ],
  "msg": ""
}

• Show gas limit as integer:

  21000

• Estimate total gas cost:

  gasLimit × gasPrice

• Show USD equivalent if possible

opentrade gateway simulate \
  --from <sender_address> \
  --to <recipient_address> \
  --chain <chain_name> \
  [--value <amount_in_wei>] \
  [--data <hex_data>] \
  [--gas-limit <limit>] \
  [--gas-price <price_in_wei>]

• --from

  : Sender wallet address (required)

• --to

  : Recipient address (required)

• --chain

  : Chain name (required)

• --value

  : Amount to send in wei (optional, default:

  0

  )

• --data

  : Transaction data in hex format (optional, default:

  0x

  )

• --gas-limit

  : Gas limit (optional)

• --gas-price

  : Gas price in wei (optional)

opentrade gateway simulate \
  --from 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb \
  --to 0x1234567890abcdef1234567890abcdef12345678 \
  --chain xlayer \
  --value 1000000000000000000 \
  --gas-limit 21000 \
  --gas-price 100000000

{
  "code": "0",
  "data": [
    {
      "executionResult": {
        "used": 21000,
        "success": true,
        "gasLimit": 21000,
        "gasUsed": 21000
      }
    }
  ],
  "msg": ""
}

{
  "code": "0",
  "data": [
    {
      "executionResult": {
        "used": 0,
        "success": false,
        "error": "execution reverted: insufficient balance"
      }
    }
  ],
  "msg": ""
}

• If

  success: true

  : "Simulation successful! Gas used: 21000"
• If

  success: false

  : "Simulation failed: [error message]"
• Show revert reason if available

opentrade gateway broadcast \
  --signed-tx <signed_transaction_hex> \
  --address <sender_address> \
  --chain <chain_name>

• --signed-tx

  : Signed transaction in hex format (EVM) or base58 (Solana) (required)

• --address

  : Sender wallet address (required)

• --chain

  : Chain name (required)

opentrade gateway broadcast \
  --signed-tx 0xf86c808504a817c800825208941234567890abcdef1234567890abcdef12345678880de0b6b3a764000080820a96a0... \
  --address 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb \
  --chain xlayer

opentrade gateway broadcast \
  --signed-tx 4hXTCkRzt9WyecNzV1XPgCDfGAZzQKNxLXgynz5QDuWWPSAZBZSHptvWRL3BjCvzUXRdKvHL2b7yGrRQcWyaqsaBCncVG7BFggS8w9snUts67BSh3EqKpXLUm5UMHfD7ZBe9GhARjbNQMLJ1QD3Spr6oMTBU6EhdB4RD8CP2xUxr2u3d6fos36PD98XS6oX8TQjLpsMwncs5DAMiD4nNnR8NBfyghGCWvCVifVwvA8B8TJxE1aHwYbgByseGmZJYDUSi5McBJdm7f9YY9d8FU7XMWoLM1gCWmoL92aPQuGHafb \
  --address YourSolanaWalletAddress \
  --chain solana

{
  "code": "0",
  "data": [
    {
      "orderId": "123456789",
      "txHash": "0xabc123def456..."
    }
  ],
  "msg": ""
}

• "Transaction broadcast successfully!"
• "Order ID: 123456789"
• "Tx Hash: 0xabc123def456..."
• "Track status with: opentrade gateway orders --address <wallet_address> --chain <chain_name> --order-id 123456789"

opentrade gateway orders \
  --address <wallet_address> \
  --chain <chain_name> \
  --order-id <order_id>

• --address

  : Wallet address (required)

• --chain

  : Chain name (required)

• --order-id

  : Order ID from broadcast response (required)

opentrade gateway orders \
  --address 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb \
  --chain xlayer \
  --order-id 123456789

{
  "code": "0",
  "data": [
    {
      "orderId": "123456789",
      "txHash": "0xabc123def456...",
      "txStatus": "2",
      "chainId": "196",
      "blockNumber": "12345678",
      "timestamp": "1709876543"
    }
  ],
  "msg": ""
}

• 0

  : Pending (not yet confirmed)

• 1

  : Failed (transaction reverted or rejected)

• 2

  : Success (confirmed on-chain)

• "Order 123456789: Success"
• "Tx Hash: 0xabc123def456..."
• "Block: 12345678"
• "Status: Confirmed on-chain"

• MEV protection: Broadcasting through OpenTrade nodes may offer MEV protection on supported chains.
• Solana special handling: Solana signed transactions use base58 encoding (not hex). Ensure the

  --signed-tx

  format matches the chain.
• Chain not supported: call

  opentrade gateway chains

  first to verify.
• Node return failed: the underlying blockchain node rejected the transaction. Common causes: insufficient gas, nonce too low, contract revert. Retry with corrected parameters.
• Wallet type mismatch: the address format does not match the chain (e.g., EVM address on Solana chain).
• 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.

• Transaction already broadcast: if the same

  --signed-tx

  is broadcast twice, the API may return an error or the same

  txHash

  — handle idempotently.

• Gas prices in Gwei for EVM chains (

  18.5 Gwei

  ), never raw wei
• Gas limit as integer (

  21000

  ,

  145000

  )
• USD gas cost estimate when possible
• Transaction values in UI units (

  1.5 ETH

  ), never base units

• This skill does NOT sign transactions — it only broadcasts pre-signed transactions
• Amounts in parameters use minimal units (wei/lamports)
• Gas price fields: use

  eip1559Protocol.suggestBaseFee

  +

  proposePriorityFee

  for EIP-1559 chains,

  normal

  for legacy
• 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