opentrade-market

What this skill does

# 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

Every time before running any `opentrade` command, always 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:
   ```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.
  ```bash
  OPEN_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:

```bash
opentrade trade routers
```

**Response format:**
```json
{
  "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 token search / metadata / rankings / holder analysis → use `opentrade-token`
- For swap execution → use `opentrade-dex-swap`
- For transaction broadcasting → use `opentrade-transaction`
- 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

```bash
# 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`).

| Chain | Name | chainIndex |
|---|---|---|
| XLayer | `xlayer` | `196` |
| Solana | `solana` | `501` |
| Ethereum | `ethereum` | `1` |
| Base | `base` | `8453` |
| BSC | `bsc` | `56` |
| Arbitrum | `arbitrum` | `42161` |

## Command Index

### Market Price Commands

| # | Command | Description |
|---|---|---|
| 1 | `opentrade market price <address>` | Get single token price |
| 2 | `opentrade market prices <tokens>` | Batch price query |
| 3 | `opentrade market trades <address>` | Get recent trades |
| 4 | `opentrade market kline <address>` | Get K-line / candlestick data |

### Index Price Commands

| # | Command | Description |
|---|---|---|
| 5 | `opentrade market index <address>` | Get index price (aggregated from multiple sources) |

### Signal Commands

| # | Command | Description |
|---|---|---|
| 6 | `opentrade market signal-chains` | Get supported chains for market signals |
| 7 | `opentrade market signal-list <chain>` | Get latest signal list (smart money / KOL / whale activity) |

### Meme Pump Commands

| # | Command | Description |
|---|---|---|
| 8 | `opentrade market memepump-chains` | Get supported chains and protocols for meme pump |
| 9 | `opentrade market memepump-tokens <chain>` | List meme pump tokens with advanced filtering |
| 10 | `opentrade market memepump-token-details <address>` | Get detailed info for a single meme pump token |
| 11 | `opentrade market memepump-token-dev-info <address>` | Get developer analysis and holding info |
| 12 | `opentrade market memepump-similar-tokens <address>` | Find similar tokens by same creator |
| 13 | `opentrade market memepump-token-bundle-info <address>` | Get bundle/sniper analysis |
| 14 | `opentrade market memepump-aped-wallet <address>` | Get aped (same-car) wallet list |

## Boundary: market vs token skill

| Need | Use this skill (`opentrade-market`) | Use `opentrade-token` instead |
|---|---|---|
| Real-time price (single value) | `opentrade market price` | - |
| Price + market cap + liquidity + 24h change | - | `opentrade token price-info` |
| K-line / candlestick chart | `opentrade market kline` | - |
| Trade history (buy/sell log) | `opentrade market trades` | - |
| Index price (multi-source aggregate) | `opentrade market index` | - |
| Token search by name/symbol | - | `opentrade token search` |
| Token metadata (decimals, logo) | - | `opentrade token info` |
| Token ranking (toplist) | - | `opentrade token toplist` |
| Holder distribution | - | `opentrade token holders` |
| Smart money / whale / KOL signals | `opentrade market signal-list` | - |
| Signal-supported chains | `opentrade market signal-chains` | - |
| Browse meme pump tokens by stage | `opentrade market memepump-tokens` | - |
| Meme token audit (top10, dev, insiders) | `opentrade market memepump-token-details` | - |
| Developer reputation / rug pull history | `opentrade market memepump-token-dev-info` | - |
| Similar tokens by same creator | `opentrade market memepump-similar-tokens` | -