Methodalgo Market Intel Explorer Skill

Part 1 — Installing the Skill

Choose one of the following methods to install this skill into your AI agent:

Option A — ClawHub (Recommended)

clawhub install methodalgo-market-intel-explorer

🔗 https://clawhub.ai/methodalgo/methodalgo-market-intel-explorer

Option B — GitHub Clone

git clone https://github.com/methodalgo/methodalgo-market-intel-explorer.git

Then point your AI agent (e.g. Claude, Cursor, Antigravity) to the cloned folder and instruct it to read SKILL.md to activate.

Part 2 — Installing the CLI & Authentication

This skill relies on the methodalgo-cli, an open-source npm package (npmjs.com/package/methodalgo-cli), to fetch market data.

1. Install CLI

npm install -g methodalgo-cli

2. Authentication

Most Methodalgo service commands (news, signals, snapshot, calendar, and Methodalgo-backed data) require a Methodalgo API key. Binance public market data commands (methodalgo binance ...) do not require a Methodalgo API key or a Binance API key.

The CLI supports two authentication methods. The CLI will prioritize the environment variable over the local config.

Method A: Environment Variable (Recommended for AI Agents)

Set the following environment variable in your system or IDE:

• METHODALGO_API_KEY: Your Methodalgo API key.
• FRED_API_KEY (optional): Only needed for methodalgo fred ... macro data commands. The rest of the CLI works without it.

Method B: Local CLI Login (Classic)

Run the following command and enter your key when prompted:

methodalgo login

Apply for a key at: https://account.methodalgo.com/account/api-keys

• The key is stored locally on your machine after login; it is never transmitted outside of Methodalgo's own API.

Verify the installation:

methodalgo --version

3. Troubleshooting & Common Errors

If you encounter errors, check the following:

📚 References (LLM Recommended Reading)

To execute tasks more accurately, it is recommended to refer to the following documents before handling complex queries:

• Signal Channels Detailed Reference: Detailed explanation of the trigger mechanisms, timeframes, and details field meanings for various signal channels (Breakout, Exhaustion, Golden Pit, etc.).
• AI Prompts Guide: Provides prompt templates for scenarios such as "Daily Market Overview" and "Specific Coin Deep Scan".
• Data Output Samples: Shows real JSON response structures for news, signals, snapshot, macro, and Binance public market data commands to facilitate parsing logic.

Usage

Invoke the methodalgo CLI directly; the --json flag is mandatory to obtain structured data:

# News
methodalgo news --type <type> --limit <N> --json

# Signals
methodalgo signals <channel> --limit <N> --json

# Snapshot
methodalgo snapshot <symbol> [tf] --url --json

# Calendar
methodalgo calendar --countries <codes> [options] --json

# Federal Reserve Data (FRED)
methodalgo fred <subcommand> [options] --json

# Binance public market data (no API key required)
methodalgo binance <subcommand> [options] --json

📸 Snapshot Command

methodalgo snapshot <symbol> [tf] --url --json

Parameter Description

Output Structure

{
  "symbol": "SOLUSDT.P",
  "tf": "60",
  "url": "https://m.methodalgo.com/tmp/xxx.webp",
  "timestamp": 1774899516784
}

📰 News Command

methodalgo news --type <type> --limit <N> --json

Available Types

Optional Parameters

Output Structure

[
  {
    "type": "breaking",
    "title": { "en": "...", "zh": "..." },
    "excerpt": { "en": "...", "zh": "..." },
    "description": { "en": "...", "zh": "..." },
    "analysis": { "en": "...", "zh": "..." },
    "publish_date": "2026-03-30T19:15:56+00:00",
    "url": "https://..."
  }
]

The article type usually includes excerpt, analysis, and url; breaking, onchain, and report types typically do not have an excerpt. It is recommended to fetch a sufficient quantity of news items, such as 50-100, to ensure adequate time coverage.

📡 Signals Command

methodalgo signals <channel> --limit <N> --json

Channels

Standard Output Structure

Standard Signal Channels (breakout / liquidation / exhaustion / golden-pit / etf-tracker / market-today):

[
  {
    "id": "1488261183843864617-0-0",
    "timestamp": 1774899516784, // Signal transmission timestamp
    "attachments": [],
    "image": "https://m.methodalgo.com/tmp/xxx.webp", // Link to chart or data image (optional, may be null)
    "signals": [
      {
        "title": "Signal title display...",
        "description": "Signal summary content (format varies by channel)...",
        "direction": "bull/bear/empty string", // Directional hint
        "details": { 
          // ⚠️ Field names in the details object vary by channel; see the following enumeration:
        }
      }
    ]
  }
]

details Structure Enumeration for Standard Channels:

1. breakout-* series (Detecting breakout trading opportunities)

{
  "Symbol": "NIGHTUSDT.P", "TimeFrame": "1h", "Type": "DOWN / UP", 
  "BreakPrice": "0.04284", "Exchange": "BINANCE"
}

2. liquidation (Detecting large liquidation/blow-off orders)

{
  "Symbol": "ZECUSDT.P", "Side": "🔴 SHORT / 🟢 LONG", "Quantity": "88.245", 
  "Average Price": "$227.43", "Liquidation Price": "$229.70", "Position Total": "$20069"
}

3. exhaustion-* series (Buyer or seller exhaustion, potential trend reversal)

{
  "Type": "Early Reversal", "Timeframe": "30m", "Exhaustion Side": "SELLER / BUYER", 
  "Safety": "...", "Tip": "...", "Exchange": "Binance"
}

4. golden-pit-* series (Re-entry opportunities in Smart Cloud patterns)

{
  "Pattern": "Pull then Push", "Safety": "Wait 6-10 bars to develop..."
}

5. etf-tracker (ETF fund flow broadcast)

{
  "Net Inflow": "$0K", "7 Days Avg.": "$663.0K"
}

6. market-today (Market sentiment, including Season Index and Fear & Greed Index)

// Type A (Season Index)
{ "Alt Season": "...", "Bitcoin Season": "..." }
// Type B (Fear And Greed Index)
{ "Yesterday": "12", "3Days Ago": "10", "7Days Ago": "10" }

token-unlock Channel Structure

token-unlock channel (Unique data structure with a signals array at the top level):

{
  "signals": [
    {
      "ts": 1774915176617, // Unlock time
      "symbol": "OP", // Token name
      "perc": 1.52, // Unlock percentage
      "progress": "40.91%", // Unlock progress
      "circSup": "6.79 B ICE", // Current circulating supply
      "countDown": "0Day23Hr30Min", // Countdown relative to updatedAt. Please calculate real-time using the ts and updatedAt in the data.
      "marketCap": "$218.99 M", // Current market capitalization
      "unlockToken": "32.21 M", // Number of tokens unlocked
      "unlockTokenVal": "$3.36 M (1.52% of M.Cap)" // Value of tokens unlocked
    }
  ],
  "updatedAt": 1774915176617 // Data update time
}

📅 Calendar Command

methodalgo calendar --countries <codes> [options] --json

Parameter Description

Output Structure

 [
   {
     "title": "Non Farm Payrolls",
     "country": "US",
     "indicator": "Jobs",
     "period": "Mar",
     "comment": "Nonfarm Payrolls measures the change in the number of people employed during the previous month, excluding the farming industry...",
     "actual": "275K",
     "forecast": "198K",
     "previous": "229K",
     "importance": 1,
     "date": "2026-04-03T12:30:00.000Z",
     "source": "Bureau of Labour Statistics",
     "source_url": "http://www.bls.gov"
   }
 ]

🏦 Federal Reserve Data (FRED) Command

Access 800,000+ macro economic time series from FRED (Federal Reserve Economic Data) maintained by the St. Louis Fed.

methodalgo fred <subcommand> [options] --json

Subcommands

💡 High-Alpha Series IDs for Crypto Traders

📈 Macro Impact Logic (Quick Guide)

Macro Pro-Tip: methodalgo fred liquidity automatically calculates Net Liquidity using Fed Assets - RRP - TGA. This is the single most important macro driver for Bitcoin's medium-term price action.

Parameters

🟡 Binance Public Market Data Command

Access Binance spot and USD-M futures public market data through methodalgo binance. These commands do not require a Binance API key, but they do require methodalgo-cli version 1.0.26 or newer.

methodalgo binance <subcommand> [options] --json

Symbol Convention

--market auto|spot|futures is available where supported:

• auto uses the .P suffix to infer spot vs futures.
• Explicit --market spot or --market futures overrides the suffix.
• List-style commands without a symbol, such as ticker and movers, default to spot unless --market futures is provided.

Subcommands

Parameters

Important Parsing Notes

• --json usually returns the direct Binance API response. Do not assume it has the same wrapper shape across subcommands.
• ticker --limit limits the formatted table output; with --json, the raw Binance response is returned.
• movers returns a normalized object with { market, gainers, losers, timestamp }, because it is computed by the CLI from Binance 24h ticker data.
• funding, oi, sentiment, and basis are futures-only. BTCUSDT and BTCUSDT.P both resolve to the same USD-M futures symbol for these commands.
• raw is restricted to allowlisted public endpoints that do not require API keys. Account, order, trading, user-data, and signed endpoints are intentionally blocked.

🎯 Scenario Quick Look

Important Notes

1. Output Format: Output is pure JSON; simply use JSON.parse.
2. Two-Phase Fetch Strategy:
   • Phase 1 (Snapshot): Fetch 5 items to make a preliminary trend assessment.
   • Phase 2 (Deep Dive): Perform incremental fetches based on specific IDs or keywords (--after / --search).
3. Data Volume Limits: --limit controls the amount of data. News: max 500 items; Signals: max 600 items.
4. Language Handling: For news data, prioritize title.zh / excerpt.zh / analysis.zh fields for Chinese content (if requested).
5. Structural Inconsistency Alert: token-unlock returns an object (containing a signals array), while other channels return an array. The AI must determine processing logic based on the channel.
6. Snapshot Screenshots: snapshot returns image links via --url by default. Please access the visualized market charts through these links.
7. Authentication Failure: If Methodalgo service commands fail with 401/403 errors, verify your API key at https://account.methodalgo.com/account/api-keys and re-run methodalgo login. Binance public data commands do not use this API key.
8. FRED API Key: While Methodalgo provides macro data, you can set your own FRED key for higher limits: methodalgo config set fred-api-key <key>.
9. Binance Public Data: methodalgo binance uses public Binance endpoints and does not require a Binance API key. Use .P symbols for futures when available, and use --market futures for list-style futures queries.

Github: https://github.com/methodalgo/methodalgo-market-intel-explorer ClawHub: https://clawhub.ai/methodalgo/methodalgo-market-intel-explorer