Opentrade Market

OpenTrade DEX Market Data CLI

14 commands for on-chain prices, trades, candlesticks, index prices, smart money signals, and meme pump token scanning.

Pre-flight Checks

Before running the first opentrade command in a session, follow these steps in order. Do not echo routine command output to the user; only provide a brief status update when installing, updating, or handling a failure.

1. Confirm installed: Run which opentrade. If not found, install it:

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

   If the install script fails, ask the user to install manually following the instructions at: https://github.com/6551Team/opentrade/tree/main/cli

2. Check for updates: If the CLI was already installed, run the installer once at the start of the session:

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

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

3. If any opentrade command fails with an unexpected error during this session, try reinstalling before giving up:

   curl -sSL https://raw.githubusercontent.com/6551Team/opentrade/main/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.

OPENNEWS_TOKEN=your_token_here

Get your API token at: https://www.newsliquid.com/mcp

Security warning: Never commit .env to git (add it to .gitignore) and never expose credentials in logs, screenshots, or chat messages.

Router Discovery

IMPORTANT: If the user has not specified a trading router, you MUST first discover available routers:

opentrade trade routers

Response format:

{
  "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"
    }
  ]
}

Usage:

• 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 market price 0x... --chain ethereum --trader okx --api v1
• Default fallback: If the API returns no data or is empty, use --trader okx --api v1

Skill Routing

• For user-specific holdings, orders, positions, or personal trade/trading history, query opentrade-cex first. Use this skill only for public on-chain trade logs/swap activity after CEX returns no relevant data, or when the user explicitly asks for on-chain/DEX market activity.
• For token search / metadata / rankings / holder analysis → use opentrade-token
• For swap execution → use opentrade-dex-swap
• For transaction broadcasting → use opentrade-gateway
• For wallet balances / portfolio → use opentrade-portfolio
• Signal data (smart money / whale / KOL buy signals, signal-supported chains) → use opentrade-market
• Meme pump scanning (token lists, dev info, bundle detection, aped wallets) → use opentrade-market
• Meme token safety (rug pull check, dev reputation, bundler/sniper analysis, similar tokens by same dev) → use opentrade-market

Quickstart

# Get real-time price of OKB on XLayer
opentrade market price 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee --chain xlayer

# Get hourly candles
opentrade market kline 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee --chain xlayer --bar 1H --limit 24

# Solana SOL candles (use wSOL SPL token address for candles/trades)
opentrade market kline So11111111111111111111111111111111111111112 --chain solana --bar 1H --limit 24

# Get batch prices for multiple tokens
opentrade market prices "1:0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee,501:So11111111111111111111111111111111111111112"

# Get smart money signals on Solana
opentrade market signal-list solana --wallet-type "1,2,3" --min-amount-usd 1000

# Get supported chains and protocols for meme pump
opentrade market memepump-chains

# List new meme pump tokens on Solana
opentrade market memepump-tokens solana --stage NEW

# Get meme pump token details
opentrade market memepump-token-details <address> --chain solana

# Check developer reputation for a meme token
opentrade market memepump-token-dev-info <address> --chain solana

Chain Name Support

The CLI accepts human-readable chain names (e.g., ethereum, solana, xlayer) and resolves them automatically. You can also use --chain with numeric chain indices (e.g., 1, 501, 196).

Command Index

Market Price Commands

Index Price Commands

Signal Commands

Meme Pump Commands

Boundary: market vs token skill

Rule of thumb: opentrade-market = raw price feeds, charts, smart money signals & meme pump scanning (including dev reputation, rug pull checks, bundler analysis). opentrade-token = token discovery & enriched analytics (search, toplist, holders, market cap).

Cross-Skill Workflows

Workflow A: Research Token Before Buying

User: "Tell me about BONK, show me the chart, then buy if it looks good"

1. opentrade-token    opentrade token search BONK --chains solana            → get tokenContractAddress + chain
2. opentrade-token    opentrade token price-info <address> --chain solana    → market cap, liquidity, 24h volume
3. opentrade-token    opentrade token holders <address> --chain solana       → check holder distribution
4. opentrade-market   opentrade market kline <address> --chain solana        → K-line chart for visual trend
       ↓ user decides to buy
5. opentrade-dex-swap     opentrade swap quote --from ... --to ... --amount ... --chain solana
6. opentrade-dex-swap     opentrade swap swap --from ... --to ... --amount ... --chain solana --wallet <addr>

Data handoff: tokenContractAddress from step 1 is reused as <address> in steps 2-6.

Workflow B: Price Monitoring / Alerts

1. opentrade-token    opentrade token toplist --chains solana --sort-by 5   → find trending tokens by volume
       ↓ select tokens of interest
2. opentrade-market   opentrade market price <address> --chain solana        → get current price for each
3. opentrade-market   opentrade market kline <address> --chain solana --bar 1H  → hourly chart
4. opentrade-market   opentrade market index <address> --chain solana        → compare on-chain vs index price

Workflow C: Signal-Driven Token Research & Buy

User: "Show me what smart money is buying on Solana and buy if it looks good"

1. opentrade-market   opentrade market signal-chains                         → confirm Solana supports signals
2. opentrade-market   opentrade market signal-list solana --wallet-type "1,2,3"
                                                                          → get latest smart money / whale / KOL buy signals
                                                                          → extracts token address, price, walletType, triggerWalletCount
       ↓ user picks a token from signal list
3. opentrade-token    opentrade token price-info <address> --chain solana    → enrich: market cap, liquidity, 24h volume
4. opentrade-token    opentrade token holders <address> --chain solana       → check holder concentration risk
5. opentrade-market   opentrade market kline <address> --chain solana        → K-line chart to confirm momentum
       ↓ user decides to buy
6. opentrade-dex-swap     opentrade swap quote --from ... --to <address> --amount ... --chain solana
7. opentrade-dex-swap     opentrade swap swap --from ... --to <address> --amount ... --chain solana --wallet <addr>

Data handoff: token.tokenAddress from step 2 feeds directly into steps 3–7.

Workflow D: Meme Token Discovery & Analysis

User: "Show me new meme tokens on Solana and check if any look safe"

1. opentrade-market   opentrade market memepump-chains                          → discover supported chains & protocols
2. opentrade-market   opentrade market memepump-tokens solana --stage NEW       → browse new tokens
       ↓ pick an interesting token
3. opentrade-market   opentrade market memepump-token-details <address> --chain solana  → full token detail + audit tags
4. opentrade-market   opentrade market memepump-token-dev-info <address> --chain solana → check dev reputation (rug pulls, migrations)
5. opentrade-market   opentrade market memepump-token-bundle-info <address> --chain solana → check for bundlers/snipers
6. opentrade-market   opentrade market kline <address> --chain solana           → view price chart
       ↓ user decides to buy
7. opentrade-dex-swap     opentrade swap quote --from ... --to <address> --amount ... --chain solana
8. opentrade-dex-swap     opentrade swap swap --from ... --to <address> --amount ... --chain solana --wallet <addr>

Data handoff: tokenAddress from step 2 is reused as <address> in steps 3–8.

Workflow E: Meme Token Due Diligence

User: "Check if this meme token is safe before I buy"

1. opentrade-market   opentrade market memepump-token-details <address> --chain solana   → basic info + audit tags
2. opentrade-market   opentrade market memepump-token-dev-info <address> --chain solana  → dev history + holding
3. opentrade-market   opentrade market memepump-similar-tokens <address> --chain solana  → other tokens by same dev
4. opentrade-market   opentrade market memepump-token-bundle-info <address> --chain solana → bundler analysis
5. opentrade-market   opentrade market memepump-aped-wallet <address> --chain solana     → who else is holding

User: "Filter signals to only show whale buys above $10k"

1. opentrade-market   opentrade market signal-list ethereum --wallet-type 3 --min-amount-usd 10000
                                                                          → whale-only signals on Ethereum, min $10k
2. opentrade-market   opentrade market kline <address> --chain ethereum      → chart for chosen token

Operation Flow

Step 1: Identify Intent

• Real-time price (single token) → opentrade market price
• Trade history → opentrade market trades
• K-line chart → opentrade market kline
• Index price (current) → opentrade market index
• Smart money / whale / KOL buy signals → opentrade market signal-list
• Chains supporting signals → opentrade market signal-chains
• Discover meme pump supported chains/protocols → opentrade market memepump-chains
• Browse/filter meme tokens by stage → opentrade market memepump-tokens
• Deep-dive into a specific meme token → opentrade market memepump-token-details
• Check meme token developer reputation → opentrade market memepump-token-dev-info
• Find similar tokens by same creator → opentrade market memepump-similar-tokens
• Analyze bundler/sniper activity → opentrade market memepump-token-bundle-info
• View aped (same-car) wallet holdings → opentrade market memepump-aped-wallet

Step 2: Collect Parameters

• Missing chain → recommend XLayer (--chain xlayer, low gas, fast confirmation) as the default, then ask which chain the user prefers; for signal queries, first call opentrade market signal-chains to confirm the chain is supported; for meme pump queries, default to Solana (--chain solana)
• Missing token address → use opentrade-token opentrade token search first to resolve; for signal queries, --token-address is optional (omit to get all signals on the chain); for meme pump, use opentrade market memepump-tokens first to discover tokens
• Missing --stage for memepump-tokens → ask user which stage (NEW / MIGRATING / MIGRATED)
• K-line requests → confirm bar size and time range with user
• Signal filter params (--wallet-type, --min-amount-usd, etc.) → ask user for preferences if not specified; default to no filter (returns all signal types)

Step 3: Call and Display

• Call directly, return formatted results
• Use appropriate precision: 2 decimals for high-value tokens, significant digits for low-value
• Show USD value alongside

Step 4: Suggest Next Steps

After displaying results, suggest 2-3 relevant follow-up actions based on the command just executed:

Present conversationally, e.g.: "Would you like to see the K-line chart, or buy this token?" — never expose skill names or endpoint paths to the user.

CLI Command Reference

1. opentrade market price

Get single token price.

opentrade market price <address> [--chain <chain>]

Return fields:

2. opentrade market prices

Batch price query for multiple tokens.

opentrade market prices <tokens> [--chain <chain>]

Return fields (per token):

3. opentrade market kline

Get K-line / candlestick data.

opentrade market kline <address> [--bar <bar>] [--limit <n>] [--chain <chain>]

Return fields: Each data point is an array with the following elements:

4. opentrade market trades

Get recent trades.

opentrade market trades <address> [--chain <chain>] [--limit <n>]

Return fields:

5. opentrade market index

Get index price (aggregated from multiple sources).

opentrade market index <address> [--chain <chain>]

Return fields:

6. opentrade market signal-chains

Get supported chains for market signals. No parameters required.

opentrade market signal-chains

Return fields:

Call this first when a user wants signal data and you need to confirm chain support before calling opentrade market signal-list.

7. opentrade market signal-list

Get latest buy-direction token signals sorted descending by time.

opentrade market signal-list <chain> [options]

Return fields:

8. opentrade market memepump-chains

Get supported chains and protocols for meme pump. No parameters required.

opentrade market memepump-chains

Return fields:

Currently supports: Solana (501), BSC (56), X Layer (196), TRON (195).

9. opentrade market memepump-tokens

List meme pump tokens with advanced filtering. Returns up to 30 tokens per request.

opentrade market memepump-tokens <chain> --stage <stage> [options]

Return fields: Array of token objects (same structure as memepump-token-details response).

10. opentrade market memepump-token-details

Get detailed information for a specific meme pump token.

opentrade market memepump-token-details <address> [--chain <chain>]

Return fields:

11. opentrade market memepump-token-dev-info

Get developer analysis including rug pull history, migration stats, and holding info.

opentrade market memepump-token-dev-info <address> [--chain <chain>]

Return fields:

Note: devHoldingInfo may be null if the creator address is unavailable.

12. opentrade market memepump-similar-tokens

Find similar tokens created by the same developer. Returns at most 2 results.

opentrade market memepump-similar-tokens <address> [--chain <chain>]

Return fields:

13. opentrade market memepump-token-bundle-info

Get bundle/sniper analysis for a token.

opentrade market memepump-token-bundle-info <address> [--chain <chain>]

Return fields:

14. opentrade market memepump-aped-wallet

Get the aped (same-car) wallet list for a token.

opentrade market memepump-aped-wallet <address> [--chain <chain>]

Return fields:

Input / Output Examples

User says: "Check the current price of OKB on XLayer"

opentrade market price 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee --chain xlayer
# → Display: OKB current price $XX.XX

User says: "Show me hourly candles for USDC on XLayer"

opentrade market kline 0x74b7f16337b8972027f6196a17a631ac6de26d22 --chain xlayer --bar 1H
# → Display candlestick data (open/high/low/close/volume)

User says: "What are smart money wallets buying on Solana?"

opentrade market signal-list solana --wallet-type 1
# → Display smart money buy signals with token info

User says: "Show me whale buys above $10k on Ethereum"

opentrade market signal-list ethereum --wallet-type 3 --min-amount-usd 10000
# → Display whale-only signals, min $10k

User says: "Show me new meme tokens on Solana"

opentrade market memepump-tokens solana --stage NEW
# → Display list of new meme pump tokens with market data and audit tags

User says: "Is this meme token safe? Check the developer"

opentrade market memepump-token-dev-info <address> --chain solana
# → Display dev rug pull count, migration count, golden gems, dev holding info

User says: "Check if this token has bundler activity"

opentrade market memepump-token-bundle-info <address> --chain solana
# → Display bundler count, bundled value, bundled token amount

Region Restrictions (IP Blocking)

Some services are geo-restricted. When a command fails with error code 50125 or 80001, return a friendly message without exposing the raw error code:

Error handling: When the CLI returns error 50125 or 80001, display:

{service_name} is not available in your region. Please switch to a supported region and try again.

Examples:

• "DEX is not available in your region. Please switch to a supported region and try again."
• "DeFi is not available in your region. Please switch to a supported region and try again."

Do not expose raw error codes or internal error messages to the user.

Edge Cases

• Invalid token address: returns empty data or error — prompt user to verify, or use opentrade token search to resolve
• Unsupported chain: the CLI will report an error — try a different chain name
• No candle data: may be a new token or low liquidity — inform user
• Unsupported chain for signals: not all chains support signals — always verify with opentrade market signal-chains first
• Empty signal list: no signals on this chain for the given filters — suggest relaxing --wallet-type, --min-amount-usd, or --min-address-count, or try a different chain
• Unsupported chain for meme pump: only Solana (501), BSC (56), X Layer (196), TRON (195) are supported — verify with opentrade market memepump-chains first
• Invalid stage: must be exactly NEW, MIGRATING, or MIGRATED
• Token not found in meme pump: memepump-token-details returns null data if the token doesn't exist in meme pump ranking data — it may be on a standard DEX
• No dev holding info: memepump-token-dev-info returns devHoldingInfo as null if the creator address is unavailable
• Empty similar tokens: memepump-similar-tokens may return empty array if no similar tokens are found
• Empty aped wallets: memepump-aped-wallet returns empty array if no co-holders found
• 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.

Amount Display Rules

• Always display in UI units (1.5 ETH), never base units
• Show USD value alongside (1.5 ETH ≈ $4,500)
• Prices are strings — handle precision carefully

Global Notes

• 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