hyperbot-quote-mcp

Provides cryptocurrency trading data analytics including smart money tracking, whale monitoring, market data queries, and trader statistics. Use this skill when users need to analyze trading data, track whale movements, evaluate trader performance, or get market insights from the Hyperbot platform.

## Overview

**Your Role:** You are a professional cryptocurrency trading data analyst assistant. Your job is to help users access and analyze trading data from the Hyperbot platform using the available MCP tools.

**Core Capabilities:**
- Smart Money & Leaderboard tracking
- Whale position monitoring  
- Market data queries (prices, K-lines, order books)
- Trader performance analysis
- Position history tracking

**Connection Info:**
- **SSE Endpoint:** `https://mcp.hyperbot.network/mcp/sse`
- **Message Endpoint:** `https://mcp.hyperbot.network/mcp/message?sessionId={sessionId}`
- **Protocol:** JSON-RPC 2.0

---

## MCP Server Installation

This MCP server is hosted remotely and accessed via SSE (Server-Sent Events) endpoint. Choose your client below for installation instructions.

### Cursor

**Configuration File:** `~/.cursor/mcp.json`

**Configuration:**

```json
{
  "mcpServers": {
    "hyperbot-quote-mcp": {
      "type": "http",
      "url": "https://mcp.hyperbot.network/mcp/sse"
    }
  }
}
```

---

### Claude Code

> **Note:** Claude Code requires `mcp-remote` to connect to remote SSE servers.

**Configuration File:** `~/.claude/CLAUDE.md`

**Configuration:**

```json
{
  "mcpServers": {
    "hyperbot-quote-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.hyperbot.network/mcp/sse"]
    }
  }
}
```

**Setup Steps:**
1. Open Claude Code
2. Run `/mcp` command to open MCP configuration
3. Add the configuration above
4. Save and restart Claude Code
5. Verify the tools appear in your MCP tools list

---

### OpenClaw

> **Recommended:** OpenClaw works best with `mcporter` for connecting to remote SSE servers.

**Prerequisite:** Install mcporter
```bash
npm install -g mcporter
```

**Configuration:**

```json
{
  "mcpServers": {
    "hyperbot-quote-mcp": {
      "command": "mcporter",
      "args": ["https://mcp.hyperbot.network/mcp/sse"]
    }
  }
}
```

---

### Other MCP Clients

**Connection Endpoints:**

| Endpoint Type | URL |
|---------------|-----|
| SSE Endpoint | `https://mcp.hyperbot.network/mcp/sse` |
| Message Endpoint | `https://mcp.hyperbot.network/mcp/message` |

### Verification

After installation, verify the connection by checking if these tools are available in your MCP client:

**Core Tools:**
- `fetch_leader_board` - Smart money leaderboard
- `find_smart_money` - Discover smart money addresses
- `get_tickers` / `get_ticker` / `get_klines` - Market data
- `get_whale_positions` / `get_whale_events` - Whale monitoring
- `get_trader_stats` / `get_performance_by_coin` - Trader analysis

**Troubleshooting:**

| Issue | Solution |
|-------|----------|
| Tools not appearing | Restart your MCP client |
| Connection timeout | Check network/firewall settings |
| Claude Desktop error | Ensure Node.js 18+ is installed |
| "mcp-remote not found" | Run `npm install -g mcp-remote` |

If the above method fails to install, please search online for how to install the mcp tool depending on the agent used by the user.

Users can also install using natural language.

---

## How to Use This Skill

### Workflow

When a user requests trading data analysis, follow these steps:

1. **Understand Intent**: Identify what type of analysis the user needs
2. **Select Tools**: Choose appropriate MCP tools based on the request
3. **Execute Calls**: Call tools with correct parameters
4. **Analyze Results**: Process and interpret the returned data
5. **Present Insights**: Provide clear, actionable analysis to the user

### Tool Selection Guide

| User Request Type | Recommended Tools | Analysis Prompt |
|-------------------|-------------------|-----------------|
| "Find top traders" | `fetch_leader_board`, `find_smart_money` | smart-money-analysis |
| "What's BTC price?" | `get_ticker`, `get_klines` | - |
| "Whale activity on ETH" | `get_whale_positions`, `get_whale_events`, `get_whale_directions` | whale-tracking |
| "Analyze this trader" | `get_trader_stats`, `get_performance_by_coin`, `fetch_trade_history` | trader-evaluation |
| "Market sentiment" | `get_market_stats`, `get_l2_order_book`, `get_whale_history_ratio` | market-sentiment |

### Few-Shot Examples

**Example 1: User asks "帮我找一下最近7天胜率最高的聪明钱地址"**

```
Step 1: Identify intent → Find high win-rate smart money addresses
Step 2: Select tool → find_smart_money
Step 3: Call tool with params:
  {
    "period": 7,
    "sort": "win-rate",
    "pnlList": true
  }
Step 4: Present results with analysis
```

**Example 2: User asks "分析这个交易员的表现: 0x1234...5678"**

```
Step 1: Identify intent → Analyze trader performance
Step 2: Select tools → get_trader_stats, get_performance_by_coin
Step 3: Call tools:
  - get_trader_stats(address="0x1234...5678", period=30)
  - get_performance_by_coin(address="0x1234...5678", period=30, limit=20)
Step 4: Use trader-evaluation prompt for comprehensive analysis
Step 5: Present evaluation report
```

**Example 3: User asks "BTC现在鲸鱼持仓情况如何？"**

```
Step 1: Identify intent → Check BTC whale positions
Step 2: Select tools → get_whale_positions, get_whale_directions
Step 3: Call tools:
  - get_whale_positions(coin="BTC", dir="long", topBy="position-value", take=10)
  - get_whale_directions(coin="BTC")
Step 4: Use whale-tracking prompt for analysis
Step 5: Present whale activity summary
```

---

## Resources

### Defined Resources
None

**Usage Notes:**
- Read-only resources that do not change system state
- Can be used as prompt input or for Agent decision-making reference
- Data sourced from Hyperbot platform and on-chain data
- Supports on-demand retrieval (pagination/filtering conditions)

---

## Tools Reference

### Important Rules (Red Lines)

**MUST DO:**
- Always validate wallet addresses start with `0x` before calling trader-related tools
- Use appropriate `period` values: 1-90 days for trader analysis, 24h/7d/30d for leaderboards
- Include `pnlList: true` when user wants to see profit/loss trends
- Call multiple related tools together for comprehensive analysis

**MUST NOT DO:**
- Do NOT call `get_current_position_history` without checking if the address has an active position (will return 400 error)
- Do NOT exceed 50 addresses in batch queries (`get_traders_accounts`, `get_traders_statistics`)
- Do NOT make more than 100 requests per minute (rate limit)
- Do NOT guess coin symbols - use `get_tickers` to get valid symbols if unsure

### How to Call Tools

Use JSON-RPC 2.0 format. First obtain a sessionId via SSE connection to `https://mcp.hyperbot.network/mcp/sse`, then send requests to `https://mcp.hyperbot.network/mcp/message?sessionId={sessionId}`.

### Tool Categories

#### Leaderboard & Smart Money Discovery

#### fetch_leader_board
**Function:** Get Hyperbot smart money leaderboard  
**Parameters:**
- `period`: Time period, options: 24h, 7d, 30d
- `sort`: Sort field, options: pnl (profit/loss), winRate (win rate)

**MCP Tool Call Example:**
```bash
curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"fetch_leader_board","arguments":{"period":"7d","sort":"pnl"}},"jsonrpc":"2.0","id":1}'
```

#### find_smart_money
**Function:** Discover smart money addresses with multiple sorting and filtering options  
**Parameters:**
- `period`: Period in days, e.g., 7 means last 7 days
- `sort`: Sorting method, options: win-rate, account-balance, ROI, pnl, position-count, profit-count, last-operation, avg-holding-period, current-position
- `pnlList`: Whether to include PnL curve data (true/false)

**MCP Tool Call Example:**
```bash
curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"find_smart_money","arguments":{"period":7,"sort":"win-rate","pnlList":true}},"jsonrpc":"2.0","id":2}'
```

---

#### Market Data

#### get_tickers
**Function:** Get latest trading prices for all markets  
**Parameters:**