← Back to Skills Marketplace
develophyperbotnetwork

hyperbot-quote

cross-platform ✓ Security Clean
344
Downloads
1
Stars
1
Active Installs
3
Versions
Install in OpenClaw
/install hyperbot-mcp
Description
提供Hyperbot平台加密货币交易数据分析,包括聪明钱追踪、鲸鱼监控、市场行情查询和交易统计等功能。
README (SKILL.md)

中文 | English

MCP Server Skill Documentation

1. Overview

Skill Name: Hyperbot Trading Analytics
Description: Provides trading data analytics capabilities for the Hyperbot platform, including smart money tracking, whale monitoring, market data queries, and trader statistics. Suitable for cryptocurrency traders conducting market analysis and decision-making.
Version: 1.0.0
MCP Server URL / Endpoint: https://mcp.hyperbot.network/mcp

sessionId: sessionId obtained via SSE at https://mcp.hyperbot.network/mcp/sse


2. Resources

2.1 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)

3. Tools

3.1 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:

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:

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}'

3.2 Market Data

get_tickers

Function: Get latest trading prices for all markets
Parameters: None

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_tickers","arguments":{}},"jsonrpc":"2.0","id":3}'

get_ticker

Function: Get latest trading price for a specific coin
Parameters:

  • address: Coin code, e.g., btc, eth, sol

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_ticker","arguments":{"address":"ETH"}},"jsonrpc":"2.0","id":4}'

get_klines

Function: Get K-line data (with trading volume), supports BTC, ETH, and other coins
Parameters:

  • coin: Coin code, e.g., btc, eth
  • interval: K-line interval, options: 1m, 3m, 5m, 15m, 30m, 1h, 4h, 8h, 1d
  • limit: Maximum number of records to return

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_klines","arguments":{"coin":"BTC","interval":"15m","limit":100}},"jsonrpc":"2.0","id":5}'

get_market_stats

Function: Get active order statistics (long/short count, value, whale order ratio) and market mid price
Parameters:

  • coin: Coin code, e.g., btc, eth
  • whaleThreshold: Whale threshold (in USDT)

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_market_stats","arguments":{"coin":"BTC","whaleThreshold":100000}},"jsonrpc":"2.0","id":6}'

get_l2_order_book

Function: Get market information (L2 order book, etc.)
Parameters:

  • coin: Coin code, e.g., btc, eth

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_l2_order_book","arguments":{"coin":"BTC"}},"jsonrpc":"2.0","id":7}'

3.3 Whale Monitoring

get_whale_positions

Function: Get whale position information
Parameters:

  • coin: Coin code, e.g., eth, btc
  • dir: Direction, options: long, short
  • pnlSide: PnL filter, options: profit, loss
  • frSide: Funding fee PnL filter, options: profit, loss
  • topBy: Sorting method, options: position-value, margin-balance, create-time, profit, loss
  • take: Maximum number of records to return

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_whale_positions","arguments":{"coin":"BTC","dir":"long","pnlSide":"profit","frSide":"profit","topBy":"position-value","take":10}},"jsonrpc":"2.0","id":8}'

get_whale_events

Function: Real-time monitoring of latest whale open/close positions
Parameters:

  • limit: Maximum number of records to return

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_whale_events","arguments":{"limit":20}},"jsonrpc":"2.0","id":9}'

get_whale_directions

Function: Get whale position long/short count. Can filter by specific coin
Parameters:

  • coin: Coin code, e.g., eth, btc (optional)

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_whale_directions","arguments":{"coin":"BTC"}},"jsonrpc":"2.0","id":10}'

get_whale_history_ratio

Function: Get historical whale position long/short ratio
Parameters:

  • interval: Time interval, options: 1h, 1d or hour, day
  • limit: Maximum number of records to return

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_whale_history_ratio","arguments":{"interval":"1d","limit":30}},"jsonrpc":"2.0","id":11}'

3.4 Trader Analysis

fetch_trade_history

Function: Query historical trade details for a specific wallet address
Parameters:

  • address: Wallet address starting with 0x

MCP Tool Call Example:

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_trade_history","arguments":{"address":"0x1234567890abcdef1234567890abcdef12345678"}},"jsonrpc":"2.0","id":12}'

get_trader_stats

Function: Get trader statistics
Parameters:

  • address: User wallet address
  • period: Period in days

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_trader_stats","arguments":{"address":"0x1234567890abcdef1234567890abcdef12345678","period":7}},"jsonrpc":"2.0","id":13}'

get_max_drawdown

Function: Get maximum drawdown
Parameters:

  • address: User wallet address
  • days: Statistics days, options: 1, 7, 30, 60, 90
  • scope: Statistics scope, default: perp

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_max_drawdown","arguments":{"address":"0x1234567890abcdef1234567890abcdef12345678","days":30,"scope":"perp"}},"jsonrpc":"2.0","id":14}'

get_best_trades

Function: Get the most profitable trades
Parameters:

  • address: User wallet address
  • period: Days
  • limit: Maximum number of records to return

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_best_trades","arguments":{"address":"0x1234567890abcdef1234567890abcdef12345678","period":7,"limit":10}},"jsonrpc":"2.0","id":15}'

get_performance_by_coin

Function: Break down win rate and PnL performance by coin for an address
Parameters:

  • address: User wallet address
  • period: Days
  • limit: Maximum number of records to return

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_performance_by_coin","arguments":{"address":"0x1234567890abcdef1234567890abcdef12345678","period":30,"limit":20}},"jsonrpc":"2.0","id":16}'

3.5 Position History

get_completed_position_history

Function: Get completed position history. Deep analysis of complete historical position data for a coin
Parameters:

  • address: User wallet address
  • coin: Coin name, e.g., BTC, ETH

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_completed_position_history","arguments":{"address":"0x1234567890abcdef1234567890abcdef12345678","coin":"BTC"}},"jsonrpc":"2.0","id":17}'

get_current_position_history

Function: Get current position history. Returns historical data for a specific coin's current position
Parameters:

  • address: User wallet address
  • coin: Coin name, e.g., BTC, ETH

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_current_position_history","arguments":{"address":"0x1234567890abcdef1234567890abcdef12345678","coin":"BTC"}},"jsonrpc":"2.0","id":18}'

get_completed_position_executions

Function: Get completed position execution trajectory
Parameters:

  • address: User wallet address
  • coin: Coin name, e.g., BTC, ETH
  • interval: Time interval, e.g., 4h, 1d
  • startTime: Start timestamp (milliseconds)
  • endTime: End timestamp (milliseconds)
  • limit: Maximum number of records to return

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_completed_position_executions","arguments":{"address":"0x1234567890abcdef1234567890abcdef12345678","coin":"BTC","interval":"4h","limit":50}},"jsonrpc":"2.0","id":19}'

get_current_position_pnl

Function: Get current position PnL
Parameters:

  • address: User wallet address
  • coin: Coin name, e.g., BTC, ETH
  • interval: Time interval, e.g., 4h, 1d
  • limit: Maximum number of records to return

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_current_position_pnl","arguments":{"address":"0x1234567890abcdef1234567890abcdef12345678","coin":"BTC","interval":"4h","limit":20}},"jsonrpc":"2.0","id":20}'

3.6 Batch Queries

get_traders_accounts

Function: Batch query account information, supports up to 50 addresses
Parameters:

  • addresses: List of addresses, max 50 addresses

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_traders_accounts","arguments":{"addresses":["0x1234567890abcdef1234567890abcdef12345678","0xabcdef1234567890abcdef1234567890abcdef12"]}},"jsonrpc":"2.0","id":21}'

get_traders_statistics

Function: Batch query trader statistics, supports up to 50 addresses
Parameters:

  • period: Period in days, e.g., 7 means last 7 days
  • pnlList: Whether to include PnL curve data
  • addresses: List of addresses, max 50 addresses

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_traders_statistics","arguments":{"period":7,"pnlList":true,"addresses":["0x1234567890abcdef1234567890abcdef12345678","0xabcdef1234567890abcdef1234567890abcdef12"]}},"jsonrpc":"2.0","id":22}'

4. Prompts

Prompt Name Purpose Template / Example
smart-money-analysis Smart money address analysis and trading recommendations You are a quantitative trading expert. Analyze the input smart money address data: 1. Identify characteristics of high win-rate addresses 2. Analyze their position preferences and trading style 3. Provide copy-trading strategy suggestions Output in JSON format
whale-tracking Whale behavior analysis and market impact assessment Analyze whale position data and latest movements: 1. Judge main force intentions 2. Assess market impact 3. Predict short-term trends 4. Provide trading recommendations Output in JSON format
market-sentiment Market sentiment analysis Based on market data (order book, active orders, whale long/short ratio): 1. Analyze current market sentiment 2. Identify support/resistance levels 3. Judge short-term trends Output in JSON format
trader-evaluation Trader capability evaluation Comprehensively evaluate a trader's ability: 1. Analyze win rate and profit/loss ratio 2. Assess risk management capability 3. Analyze coin preferences 4. Provide comprehensive score and improvement suggestions Output in JSON format

Usage Notes:

  • Prompts can be dynamically populated with resources content
  • Multiple prompts can be combined to form reasoning chains
  • JSON output format is recommended for easy Agent parsing

5. Usage Examples

Example 1: Discover and Analyze Smart Money Addresses

  1. Call Tool: find_smart_money(7, "win-rate", true)
  2. Get list of high win-rate smart money addresses
  3. Use Prompt: smart-money-analysis to analyze characteristics of these addresses
  4. Generate analysis report and copy-trading recommendations

Example 2: Whale Behavior Monitoring

  1. Call Tool: get_whale_events(20) to get latest whale movements
  2. Call Tool: get_whale_directions("BTC") to view BTC whale long/short ratio
  3. Use Prompt: whale-tracking to analyze whale behavior
  4. Generate market impact assessment report

Example 3: In-depth Trader Analysis

  1. Call Tool: get_trader_stats(address, 30) to get basic statistics
  2. Call Tool: get_performance_by_coin(address, 30, 20) to view coin-specific performance
  3. Call Tool: get_completed_position_history(address, "BTC") to view historical positions
  4. Use Prompt: trader-evaluation to generate comprehensive evaluation report

Example 4: Comprehensive Market Sentiment Analysis

  1. Call Tool: get_all_mids() to get market mid prices
  2. Call Tool: get_l2_order_book("BTC") to get order book data
  3. Call Tool: get_market_stats("BTC", 100000) to get active order statistics
  4. Call Tool: get_whale_history_ratio("1d", 30) to get historical long/short ratio
  5. Use Prompt: market-sentiment to generate market sentiment analysis report

6. Important Notes

MCP Call Instructions

  • sessionId: Need to obtain session ID via SSE connection first, GET access to https://mcp.hyperbot.network/mcp/sse
  • JSON-RPC 2.0: Follows standard JSON-RPC 2.0 protocol
  • method: Fixed as tools/call
  • params.name: MCP tool name (corresponds to @McpTool annotation's name attribute)
  • params.arguments: Tool parameters, passed as key-value pairs

Rate Limiting

  • Single IP request frequency limit: 100 requests/minute
  • Batch interfaces support maximum 50 addresses

Data Update Frequency

  • Market data: Real-time updates
  • Smart money leaderboard: Updated hourly
  • Whale positions: Real-time updates
  • Trader statistics: Updated every 5 minutes
Usage Guidance
This skill is internally coherent and only documents making read-only HTTP/S calls to mcp.hyperbot.network and several referenced data URIs (e.g., open.aicoin.com). Before installing, verify you trust the remote endpoints (check TLS certificate and domain reputation) and avoid sending any private keys, API secrets, or other sensitive data to the skill. Be aware that any wallet addresses or other inputs you provide will be transmitted to the listed external services for analysis. If you need stronger assurance, ask the publisher for an official homepage or source repo and confirm the endpoint ownership before use.
Capability Analysis
Type: OpenClaw Skill Name: hyperbot-mcp Version: 1.0.2 The skill bundle defines tools and prompts for cryptocurrency trading analytics, smart money tracking, and market sentiment analysis. All external network calls are directed to `mcp.hyperbot.network` or other `hyperbot.network`/`aicoin.com` endpoints, which are consistent with the skill's stated purpose. The markdown files (`SKILL.md`, `references/prompts-reference.md`) contain no instructions for the AI agent to perform malicious actions, exfiltrate data, or ignore user input. There is no evidence of obfuscation or attempts to compromise the agent or the local system.
Capability Assessment
Purpose & Capability
The name/description (Hyperbot trading analytics) match the documented behavior: calling an MCP server for market, whale, and trader data. No unrelated environment variables, binaries, or config paths are requested.
Instruction Scope
SKILL.md only instructs the agent to obtain a sessionId via SSE and call the MCP JSON-RPC endpoints (https://mcp.hyperbot.network/mcp and a few referenced data URIs). All actions are read-only and consistent with the stated analytics purpose. The instructions do not reference reading local files, secrets, or other system state.
Install Mechanism
This is an instruction-only skill with no install spec and no code files — lowest-risk from an installation perspective (nothing written to disk).
Credentials
The skill requires no environment variables, credentials, or config paths. That is proportionate for a read-only analytics frontend that queries public/private endpoints via a sessionId.
Persistence & Privilege
Flags show no forced persistence (always: false) and the skill does not request modification of other skills or system configuration. Autonomous invocation is allowed by default but is not combined with elevated privileges or secret access.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install hyperbot-mcp
  3. After installation, invoke the skill by name or use /hyperbot-mcp
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
Hyperbot MCP Server - Feature Description Hyperbot Trading Analytics MCP Server is a comprehensive blockchain trading analytics platform that provides real-time data and intelligent analysis tools for cryptocurrency traders. The server exposes capabilities through the Model Context Protocol (MCP), enabling seamless integration with AI agents and trading analysis tools. Core Capabilities 1. Smart Money Discovery & Analysis Access to real-time smart money leaderboard ranked by PnL and win rate across multiple timeframes (24h, 7d, 30d) Advanced filtering and sorting of smart money addresses by metrics including win-rate, ROI, account balance, position count, and profit patterns Detailed trade history and performance analytics for specific wallet addresses Automated strategy generation for copy-trading based on high-performing addresses 2. Whale Monitoring & Behavior Tracking Real-time surveillance of whale positions with advanced filtering by coin, direction (long/short), PnL status, and funding fee performance Live monitoring of whale open/close position events to capture market-moving activities Historical long/short ratio tracking to identify whale positioning trends Market impact assessment and short-term trend prediction based on whale behavior patterns 3. Comprehensive Market Data Real-time ticker prices and L2 order book depth for major cryptocurrencies (BTC, ETH, SOL, etc.) Multi-timeframe K-line data with trading volume (from 1-minute to daily candles) Active order statistics including long/short ratios and whale order detection Market mid-price information and sentiment indicators 4. Trader Performance Analytics In-depth trader statistics including win rate, PnL curves, and max drawdown analysis Coin-specific performance breakdown to identify trading specialization Historical position analysis with complete execution trajectory tracking Current position PnL monitoring with customizable time intervals Best trades identification to understand successful trading patterns 5. Batch Query Capabilities Support for querying up to 50 addresses simultaneously for account information and statistics Efficient bulk data retrieval for portfolio-level analysis Comparative performance analysis across multiple traders 6. AI-Powered Analysis Prompts Pre-built analytical frameworks for smart-money-analysis, whale-tracking, market-sentiment, and trader-evaluation JSON-formatted output optimized for AI agent consumption and automated decision-making Composable prompts that can be chained for complex multi-step analysis workflows Technical Features RESTful API Architecture: Standard HTTPS endpoints with JSON-RPC 2.0 protocol support Real-time Data Updates: Market data updates in real-time, trader statistics refresh every 5 minutes Rate Limiting: 100 requests per minute per IP with batch operations supporting up to 50 addresses SSE Connection Support: Session-based communication via Server-Sent Events Resource URIs: Direct access to curated datasets including smart money addresses, whale positions, market data, and trader statistics Use Cases Copy Trading Strategy Development: Identify and analyze high-performing smart money addresses to develop data-driven copy-trading strategies Market Sentiment Analysis: Combine order book data, whale ratios, and active order statistics to gauge market direction Whale Activity Surveillance: Monitor large position movements and predict short-term price impacts Trader Due Diligence: Comprehensive evaluation of trader performance across multiple dimensions before following their strategies Portfolio Risk Assessment: Track current positions, historical performance, and max drawdown for risk management The Hyperbot MCP Server transforms complex on-chain and trading data into actionable intelligence, empowering traders with institutional-grade analytics through an accessible, API-first approach designed for both manual analysis and AI-powered automation.
v1.0.1
- Added Chinese documentation file: SKILL_zh.md. - Added prompt reference documentation in English: references/prompts-reference.md. - Added prompt reference documentation in Chinese: references/prompts-reference_zh.md.
v1.0.0
Initial release of Hyperbot Trading Analytics for MCP: - Provides trading analytics capabilities for the Hyperbot platform, including smart money tracking, whale monitoring, market data queries, and trade statistics. - Supports various tools for leaderboard access, smart money discovery, real-time and historical market data, whale positions, trader performance, and position history. - All data is read-only and sourced from Hyperbot and blockchain data, with support for filtering and pagination. - Endpoints and parameters are documented for each tool, with example usage via MCP server API.
Metadata
Slug hyperbot-mcp
Version 1.0.2
License
All-time Installs 1
Active Installs 1
Total Versions 3
Frequently Asked Questions

What is hyperbot-quote?

提供Hyperbot平台加密货币交易数据分析,包括聪明钱追踪、鲸鱼监控、市场行情查询和交易统计等功能。 It is an AI Agent Skill for Claude Code / OpenClaw, with 344 downloads so far.

How do I install hyperbot-quote?

Run "/install hyperbot-mcp" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is hyperbot-quote free?

Yes, hyperbot-quote is completely free (open-source). You can download, install and use it at no cost.

Which platforms does hyperbot-quote support?

hyperbot-quote is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created hyperbot-quote?

It is built and maintained by developHyperbotNetwork (@develophyperbotnetwork); the current version is v1.0.2.

💬 Comments