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 token search USDC --chains ethereum --trader okx --api v1

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

  --trader okx --api v1

• For real-time prices / K-lines / trade history → use

  opentrade-market

• For swap execution → use

  opentrade-dex-swap

• For transaction broadcasting → use

  opentrade-gateway

• For wallet balances / portfolio → use

  opentrade-portfolio

• For meme token safety (dev reputation, rug pull, bundlers, similar tokens by same dev) → use

  opentrade-market

• For smart money / whale / KOL signals → use

  opentrade-market

User: "Find BONK token, analyze it, then buy some"

1. opentrade-token    opentrade token search BONK --chains solana              → get tokenContractAddress, chain, price
       ↓ tokenContractAddress
2. opentrade-token    opentrade token price-info <address> --chain solana      → market cap, liquidity, volume24H, priceChange24H
3. opentrade-token    opentrade token holders <address> --chain solana         → top 20 holders distribution
4. opentrade-market   opentrade market kline <address> --chain solana --bar 1H → hourly price chart
       ↓ user decides to buy
5. opentrade-dex-swap opentrade swap quote --from ... --to <address> --amount ... --chain solana
6. opentrade-dex-swap opentrade swap swap --from ... --to <address> --amount ... --chain solana --wallet <addr>

• tokenContractAddress

  from step 1 → reused in all subsequent steps

• chain

  from step 1 → reused in all subsequent steps

• decimal

  from step 1 or

  opentrade token info

  → needed for minimal unit conversion in swap

User: "What's trending on Solana?"

1. opentrade-token    opentrade token toplist --chains solana --sort-by 5 --time-frame 4  → top tokens by 24h volume
       ↓ user picks a token
2. opentrade-token    opentrade token price-info <address> --chain solana                  → detailed analytics
3. opentrade-token    opentrade token holders <address> --chain solana                     → check if whale-dominated
4. opentrade-market   opentrade market kline <address> --chain solana                      → K-line for visual trend
       ↓ user decides to trade
5. opentrade-dex-swap opentrade swap swap --from ... --to ... --amount ... --chain solana --wallet <addr>

• Search for a token →

  opentrade token search

• Get token metadata →

  opentrade token info

• Get price + market cap + liquidity →

  opentrade token price-info

• View rankings →

  opentrade token toplist

• View holder distribution →

  opentrade token holders

• Missing chain → recommend XLayer (

  --chain xlayer

  , low gas, fast confirmation) as the default, then ask which chain the user prefers
• Only have token name, no address → use

  opentrade token search

  first
• For search,

  --chains

  defaults to

  "1,501"

  (Ethereum + Solana)
• For toplist,

  --sort-by

  defaults to

  5

  (volume),

  --time-frame

  defaults to

  4

  (24h)

• Search results: show name, symbol, chain, price, 24h change
• Indicate

  communityRecognized

  status for trust signaling
• Price info: show market cap, liquidity, and volume together

• Token not found: suggest verifying the contract address (symbols can collide)
• Same symbol on multiple chains: show all matches with chain names
• Unverified token:

  communityRecognized = false

  — warn user about risk
• Too many results: name/symbol search caps at 100 — suggest using exact contract address
• Network error: retry once
• 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.

• Use appropriate precision: 2 decimals for high-value, significant digits for low-value
• Market cap / liquidity in shorthand ($1.2B, $45M)
• 24h change with sign and color hint (+X% / -X%)

• Use contract address as primary identity — symbols can collide across tokens

• communityRecognized = true

  means listed on Top 10 CEX or community verified
• The CLI resolves chain names automatically (e.g.,

  ethereum

  →

  1

  ,

  solana

  →

  501

  )
• EVM addresses must be all lowercase
• The CLI handles authentication internally via environment variables — see Pre-flight Checks step 4 for authentication setup
• Get your API token at https://6551.io/mcp