PredMCP

REMOTE · PREDMCP.COM · SCANNED AUG 3

Polymarket + Hyperliquid + macro for AI agents. 38 tools, signal backtest, SSE streaming. Free tier.

Available components

+8 this week 81 81 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →

Endpoint Security91

The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token. View diagnostics → Pass
HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
DNSSEC is configured correctly; the domain's records validate against the full chain to the root. View diagnostics → Pass
The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents. View diagnostics → Partial

Transport & Reachability100

Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass

Schema Quality & AI Usability77

AI-judged instruction clarity (excellent).Pass
Tool/resource definitions use about 4751 tokens (~101/item across 47 items; 47 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

remote · predmcp.com

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add --transport http raviolelabs-predmcp https://predmcp.com/mcp

# ~/.codex/config.toml

[mcp_servers.raviolelabs-predmcp]
url = "https://predmcp.com/mcp"

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "raviolelabs-predmcp": {
      "type": "remote",
      "url": "https://predmcp.com/mcp",
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add raviolelabs-predmcp --url https://predmcp.com/mcp --transport streamable-http

# ~/.hermes/config.yaml

mcp_servers:
  raviolelabs-predmcp:
    url: "https://predmcp.com/mcp"

// mcp.json

{
  "mcpServers": {
    "raviolelabs-predmcp": {
      "type": "http",
      "url": "https://predmcp.com/mcp"
    }
  }
}

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
1 Aug 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.
31 Jul 26 +4
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
29 Jul 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.
28 Jul 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.
27 Jul 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
26 Jul 26 73

First indexed and scored.

Show 7 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Probed https://predmcp.com/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject	Issuer	Valid from	Valid until	Key	Signature	Serial
CN=predmcp.com	CN=YE2,O=Let's Encrypt,C=US	7 Jul 2026	5 Oct 2026	ECDSA 256	ECDSA-SHA384	59a6d7f6578281f2f3bddd9a99f4d286c3c
SANs: predmcp.com, www.predmcp.com
CN=YE2,O=Let's Encrypt,C=US (CA)	CN=Root YE,O=ISRG,C=US	3 Sept 2025	2 Sept 2028	ECDSA 384	ECDSA-SHA384	4df3b15dd6c0784c507cd37b58e6f115
CN=Root YE,O=ISRG,C=US (CA)	CN=ISRG Root X2,O=Internet Security Research Group,C=US	13 May 2026	2 Sept 2032	ECDSA 384	ECDSA-SHA384	872165fc34b6e5fba8add5b3705fb53a
CN=ISRG Root X2,O=Internet Security Research Group,C=US (CA)	CN=ISRG Root X1,O=Internet Security Research Group,C=US	13 May 2026	2 Sept 2032	ECDSA 384	SHA256-RSA	6c8f1dc727c7117f7baf853ac980f9cd

DNSSEC secure

Validation of predmcp.com. — Secure

Zone	DS	Keys	Algorithms	Outcome
.	trust_anchor	20326, 38696	8, 8	Verified
com.	present	19718	13	Verified
predmcp.com.	present	54719	8	Verified
predmcp.com.				Verified address RRset verified with the apex keys

Authentication Enforced and verified

The endpoint asked for a token and published valid RFC 9728 metadata describing how to get one.

Result	Enforced and verified
Enforced	On tool calls
HTTP status	200

WWW-Authenticate challenge Bearer realm="predmcp", error="invalid_token", resource_metadata="https://predmcp.com/.well-known/oauth-protected-resource"

Bearer realm="predmcp", error="invalid_token", resource_metadata="https://predmcp.com/.well-known/oauth-protected-resource"

Protected resource metadata

Document	https://predmcp.com/.well-known/oauth-protected-resource
Retrieved	Yes
Resource	https://predmcp.com/mcp
Authorisation server	https://predmcp.com

Transports 2 probes

Transport	URL	Outcome	Status	Location
streamable-http	https://predmcp.com/mcp	Verified	200
http (plaintext)	http://predmcp.com/mcp	HTTPS enforced	301	https://predmcp.com/mcp

MCP tools — 47 exposed · ~4,751 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

create_api_key Create API Key ~65

Generate a free PredMCP API key. Requires an email. Returns the key and ready-to-use MCP config. Free tier: 100 calls/day, one key per IP.

Input Output Examples

Name	Type	Req	Description
email	string	yes	Your email address — used to identify your key and for account recovery

No output schema declared.

No examples provided.

get_basic_macro Get Basic Macro ~65

DXY, US10Y yield, S&P 500, gold, VIX — direct from free Yahoo Finance. Raw values + 1d change. Pro adds BTC dominance, ETH/BTC, total crypto mcap, and a RISK_ON/OFF regime classifier.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_carry_scanner Get Carry Scanner ~111

Funding carry NET of costs: annualized funding minus (spread + 2x slippage at your size), with break-even holding period and a 7d funding-stability score from our snapshots. get_top_funding_rates shows gross — nobody trades gross.

Input Output Examples

Name	Type	Req	Description
size_usdc	number	—	Intended position size in USDC — costs are computed at this size
top_n	integer	—	How many candidates to fully cost out (default 8 — each costs an orderbook call)

No output schema declared.

No examples provided.

get_cex_outflows Get CEX Outflows ~107

Net ETH outflows across known CEX hot wallets (Binance, Coinbase, OKX, Kraken, Bitfinex) over a window. Outflow = bullish (BTC moving to cold storage). Inflow = distribution pressure. Etherscan free tier.

Input Output Examples

Name	Type	Req	Description
exchange	string	—	Filter to a single exchange or aggregate all (default: all)
window_hours	number	—	Lookback window in hours (default: 24h, max: 7d)

No output schema declared.

No examples provided.

get_conviction_score Get Conviction Score ~139

Aggregates funding outlier, whale imbalance, OI/volume ratio, and momentum into a single directional score (-100 short ↔ +100 long) plus a 0-100 strength score. One call replaces 6+ lookups, returns a clean number for LLM decisions.

Input Output Examples

Name	Type	Req	Description
asset	string	yes	Asset ticker to analyze, e.g. "BTC", "ETH", "HYPE"
min_whale_notional_usdc	number	—	Whale trade threshold in USDC (default: 25,000)
whale_window_minutes	integer	—	Lookback window for whale trades (default: 60min)

No output schema declared.

No examples provided.

get_cross_venue_funding Get Cross-Venue Funding ~102

Predicted funding spreads between Hyperliquid, Binance, and Bybit per asset (from HL's predictedFundings feed). Surfaces delta-neutral carry: long the venue with lowest funding, short the highest, collect the spread. Sorted by annualized spread.

Input Output Examples

Name	Type	Req	Description
limit	integer	—	Max rows (default 15)
min_spread_annual_pct	number	—	Minimum annualized funding spread between venues to report (default 5%)

No output schema declared.

No examples provided.

get_funding_curve_anomaly Get Funding Curve Anomaly ~77

Term-structure analysis of Hyperliquid funding for an asset: current vs 8h avg vs 24h avg vs 7d baseline. Flags spikes, regime shifts, sign contradictions. More nuanced than raw funding rate.

Input Output Examples

Name	Type	Req	Description
asset	string	yes	Asset ticker, e.g. "BTC", "HYPE"

No output schema declared.

No examples provided.

get_funding_outliers Get Funding Outliers ~96

Hyperliquid perps whose current funding rate deviates significantly from their 7-day average. A spike vs baseline is a stronger signal than raw rate.

Input Output Examples

Name	Type	Req	Description
days	integer	—	Historical window in days to compute the baseline average (default: 7)
min_deviation_factor	number	—	Minimum ratio of \|current_rate\| / \|avg_rate\| to qualify as outlier (default: 2x)

No output schema declared.

No examples provided.

get_funding_rates Get Funding Rates ~72

Current funding rates for Hyperliquid perpetuals. Positive rate = longs pay shorts (bearish bias); negative = shorts pay longs (bullish bias).

Input Output Examples

Name	Type	Req	Description
coins	array	—	List of asset tickers to fetch, e.g. ["BTC", "ETH"]. Omit to fetch all available assets.

No output schema declared.

No examples provided.

get_hip4_vs_pm_arb Get HIP-4 vs PM Arb ~88

Finds the same underlying market priced on both HIP-4 (on-chain Hyperliquid) and Polymarket, flagging spreads above threshold. A spread means one venue is mispriced relative to the other.

Input Output Examples

Name	Type	Req	Description
min_spread_pct	number	—	Minimum spread between HIP-4 and Polymarket YES prices to flag (percentage points, default: 3)

No output schema declared.

No examples provided.

get_late_game_sports Get Late Game Sports ~90

Sports prediction markets on Polymarket closing within a few hours with a high-certainty leading outcome. Targets near-certain resolution for late-game positioning.

Input Output Examples

Name	Type	Req	Description
certainty_pct	number	—	Minimum leading outcome probability as percentage, e.g. 85 = 85% (default: 85)
hours_max	number	—	Maximum hours until market closes (default: 6h)

No output schema declared.

No examples provided.

get_liquidation_clusters Get Liquidation Clusters ~70

Estimated price levels where mass liquidations concentrate for a given Hyperliquid perp, computed from mark price and standard leverage multiples. Higher nearby orderbook liquidity = stronger support/resistance.

Input Output Examples

Name	Type	Req	Description
coin	string	yes	Asset ticker to analyze, e.g. "BTC", "ETH", "SOL"

No output schema declared.

No examples provided.

get_macro_context Get Macro Context ~68

Live macro snapshot: DXY, US10Y yield, S&P 500, gold, VIX (Yahoo Finance free) + BTC dominance, ETH/BTC, total crypto market cap (CoinGecko free). Plus a coarse RISK_ON / RISK_OFF / MIXED regime.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_macro_liquidity Get Macro Liquidity ~54

Fiat-to-crypto liquidity gauge: BTC + ETH spot ETF flows (Farside) plus on-chain USDT + USDC mint/burn (Etherscan). Net inflow = bullish for risk assets.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_market_context Get Market Context ~91

Unified intelligence snapshot for any topic, asset, or keyword: all matching Polymarket and HIP-4 prediction markets combined with live Hyperliquid perp data (price, funding, OI). One call replaces 3+ separate lookups.

Input Output Examples

Name	Type	Req	Description
query	string	yes	Topic, asset, or keyword to look up — e.g. "BTC", "Iran", "Fed rate cut", "Trump"

No output schema declared.

No examples provided.

get_market_regime Get Market Regime ~84

One-call market regime classifier: RISK_ON_TRENDING / RISK_OFF / SQUEEZE_RISK / CHOP_LOW_VOL / MIXED. Combines BTC trend + realized vol, Deribit IV premium, funding breadth, and OI-weighted crowding across the top 50 perps. Call this FIRST each session to condition strategy choice.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_markets Get Markets ~105

Live prediction markets from Polymarket and/or HIP-4, sorted by volume. Returns title, YES/NO prices, 24h volume, and expiry.

Input Output Examples

Name	Type	Req	Description
active	boolean	—	Filter to active/open markets only (default: true)
limit	integer	—	Number of markets to return (1–100, default: 20)
platform	string	—	Data source: "polymarket", "hip4", or "all" (default)

No output schema declared.

No examples provided.

get_markets_near_resolution Get Markets Near Resolution ~90

Polymarket markets resolving within the next N hours with a leading probability above threshold. Useful for resolution arbitrage and last-minute positioning.

Input Output Examples

Name	Type	Req	Description
hours	number	—	Maximum hours until resolution (default: 24h, max: 168h = 7 days)
min_prob	number	—	Minimum leading outcome probability to include (default: 0.7 = 70%)

No output schema declared.

No examples provided.

get_movers Get Movers ~66

Top prediction markets ranked by 24h volume spike or biggest YES/NO price swing. Surfaces breaking news bets and momentum plays across Polymarket and HIP-4.

Input Output Examples

Name	Type	Req	Description
limit	integer	—	Number of top movers to return (1–20, default: 10)

No output schema declared.

No examples provided.

get_news_correlation Get News Correlation ~96

Recent crypto news headlines mentioning an asset (CoinDesk, The Block, Decrypt, Cointelegraph) paired with the 1h price move that followed each. Lets agents filter news bias.

Input Output Examples

Name	Type	Req	Description
asset	string	yes	Asset ticker, e.g. "BTC", "ETH", "HYPE"
hours_back	integer	—	Lookback window for headlines (default: 24h, max: 7d)

No output schema declared.

No examples provided.

get_odds Get Odds ~88

Current YES/NO prices and implied probability for any Polymarket or HIP-4 market token.

Input Output Examples

Name	Type	Req	Description
identifier	string	yes	For Polymarket: the token_id of the YES or NO outcome. For HIP-4: the base asset ticker (e.g. "BTC")
platform	string	yes	Platform the market is on: "polymarket" or "hip4"

No output schema declared.

No examples provided.

get_oi_divergence Get OI Divergence ~116

Price-vs-OI regime per coin from our continuous snapshots: NEW_LONGS / SHORT_SQUEEZE / NEW_SHORTS / LONG_LIQUIDATION. Scan all tracked coins or analyze one. Impossible without OI history, which no public API provides — only predmcp records it.

Input Output Examples

Name	Type	Req	Description
coin	string	—	One coin (e.g. "BTC") — omit to scan all tracked coins
hours	integer	—	Lookback window in hours (default 24, max 90d)

No output schema declared.

No examples provided.

get_oi_history Get OI History ~131

Open-interest time series for a coin over the last 24h, from our continuous 5-min collector. Hyperliquid has NO OI-history endpoint — this data exists only on predmcp. Includes price + funding at each point. Pro tool get_oi_divergence classifies price-vs-OI regimes (squeeze/liquidation/new positioning) across all coins.

Input Output Examples

Name	Type	Req	Description
coin	string	yes	Coin, e.g. "BTC" (top ~30 by OI are tracked)
hours	integer	—	Lookback window in hours (free tier max: 24)

No output schema declared.

No examples provided.

get_oi_near_cap Get OI Near Cap ~45

Lists Hyperliquid perps that are currently at the open interest cap — new long positions cannot be opened. Use as a blacklist to avoid getting rejected on entry.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_options_iv Get Options IV ~83

BTC or ETH options snapshot via free Deribit feed: ATM implied volatility, put-call skew, term structure, total OI and 24h volume. Useful as a sentiment gauge — IV high = market expects big moves; skew indicates direction of hedging.

Input Output Examples

Name	Type	Req	Description
asset	string	yes	Underlying — Deribit only supports BTC and ETH for the free public feed.

No output schema declared.

No examples provided.

get_orderbook Get Orderbook ~56

Full orderbook depth (bids + asks) for any Polymarket market token. Shows liquidity at each price level.

Input Output Examples

Name	Type	Req	Description
token_id	string	yes	Polymarket token ID for the YES or NO side of a market

No output schema declared.

No examples provided.

get_orderbook_depth Get Orderbook Depth ~173

Full orderbook depth + slippage estimate for any Hyperliquid perp or HIP-4 market. Returns top of book, spread, cumulative depth at $100/$500/$1k/$5k tiers, and estimated slippage for a given order size. Critical for HIP-4 farming and low-liquidity assets where market orders get destroyed by slippage.

Input Output Examples

Name	Type	Req	Description
coin	string	yes	Asset ticker (BTC, ETH, SOL) or HIP-4 contract name (e.g. "BTC>81041@20260512-0600")
side	string	—	Order side: "buy" (taker into asks) or "sell" (taker into bids)
size_usdc	number	—	Order size in USDC to estimate slippage for (default: 200)

No output schema declared.

No examples provided.

get_pm_hl_divergences Get PM/HL Divergences ~98

Markets where Polymarket implied probability diverges from Hyperliquid perpetual funding direction — e.g. PM prices bullish outcome but HL funding shows crowded longs (bearish pressure). The hardest signal to compute manually.

Input Output Examples

Name	Type	Req	Description
limit	integer	—	Number of divergences to return (default: 15)
min_pct	number	—	Minimum divergence percentage between PM implied probability and HL pricing to flag (default: 10%)

No output schema declared.

No examples provided.

get_portfolio_risk Get Portfolio Risk ~88

Risk analytics for a list of positions: per-position beta to BTC and ETH, sector concentration, pairwise correlation matrix, portfolio annualized volatility, 1-day 95% parametric VaR. Uses 14d of 1h Hyperliquid candles.

Input Output Examples

Name	Type	Req	Description
positions	array	yes	Array of positions: { asset, side, notional_usd }. Max 20.

No output schema declared.

No examples provided.

get_position_size Get Position Size ~219

Turn a signal + bankroll into a concrete position: fractional-Kelly size capped by orderbook liquidity, ATR-based stop, liquidation price at chosen leverage, funding carry cost, and % bankroll at risk. Warns when liquidation sits inside the stop. Ground win_rate_pct with get_signal_performance or get_signal_backtest first.

Input Output Examples

Name	Type	Req	Description
asset	string	yes	Asset, e.g. "BTC"
bankroll_usdc	number	yes	Total capital available in USDC
direction	string	yes	Trade direction
kelly_fraction	number	—	Fraction of full Kelly to use (default 0.25 — quarter Kelly)
leverage	number	—	Intended leverage (default 3x)
max_slippage_pct	number	—	Max acceptable slippage % — caps size by orderbook depth
payoff_ratio	number	—	Avg win / avg loss ratio (default 1.5)
win_rate_pct	number	—	Estimated win probability % (use get_signal_performance or get_signal_backtest to ground this)

No output schema declared.

No examples provided.

get_price_summary Get Price Summary ~79

One-call snapshot for an asset: mark price, 24h and 7d returns, 30d high/low, drawdown from high, rally from low, annualized realised volatility. Computed from 30d of HL hourly candles.

Input Output Examples

Name	Type	Req	Description
asset	string	yes	Asset ticker, e.g. "BTC", "HYPE"

No output schema declared.

No examples provided.

get_recent_news Get Recent News ~114

Recent crypto news headlines matching an asset ticker, from CoinDesk + The Block + Decrypt + Cointelegraph RSS feeds. Pro adds the 1h price move that followed each headline.

Input Output Examples

Name	Type	Req	Description
asset	string	yes	Asset ticker to filter on, e.g. "BTC", "ETH", "HYPE"
hours_back	integer	—	Lookback window in hours (default: 24, max: 168 = 7 days)
limit	integer	—	Max headlines returned (default: 10)

No output schema declared.

No examples provided.

get_recent_signals Get Recent Signals ~147

Server-detected events from the last hour: funding outliers (≥3x 7d baseline), whale trades (≥$100k), OI caps reached. Cursor-based — pass next_cursor back as since_id to receive only new events. The polling equivalent of the /sse/signals stream. Pro tool get_signal_history covers 7 days with forward-return outcomes.

Input Output Examples

Name	Type	Req	Description
coin	string	—	Filter to one coin, e.g. "BTC"
limit	integer	—	Max events (free tier cap: 20)
since_id	integer	—	Cursor from a previous call — returns only events with id > since_id. Omit on first call.

No output schema declared.

No examples provided.

get_setup_quality Get Setup Quality ~118

Execution-quality score (0-100, A-F grade) for entering a position right now: spread, slippage at desired size, orderbook depth, volatility regime, trend alignment, support/resistance proximity. Different from conviction (direction) — this scores ENTRY conditions.

Input Output Examples

Name	Type	Req	Description
asset	string	yes	Asset ticker, e.g. "BTC", "HYPE"
direction	string	yes	Trade direction you are considering
size_usdc	number	—	Order size in USDC to evaluate slippage for (default: 200)

No output schema declared.

No examples provided.

get_signal_backtest Get Signal Backtest ~232

Find historical instances of a signal type on an asset over the last N days and compute forward returns (1h/4h/24h), win rate, and Sharpe. Lets an agent reason about EV before trading. Killer feature: turns predmcp from data API into edge-proven intelligence.

Input Output Examples

Name	Type	Req	Description
asset	string	yes	Asset ticker, e.g. "BTC", "HYPE"
lookback_days	integer	—	How many days of history to scan (default: 90, max: 180)
min_abs_rate	number	—	For funding_extreme: minimum absolute funding rate (default: 0.0005 = 0.05%)
min_separation_hours	integer	—	Cluster consecutive triggers — at least N hours apart (default: 8h)
signal_type	string	yes	Which signal to backtest. funding_outlier = funding >= z×baseline; funding_extreme = abs(funding) >= threshold.
z_score	number	—	For funding_outlier: minimum deviation factor vs the rolling mean (default: 3×)

No output schema declared.

No examples provided.

get_signal_history Get Signal History ~166

Server-detected signal events over up to 7 days (funding outliers, whale trades ≥$100k, OI caps), each joined with its measured forward returns (1h/4h/24h) once mature. Cursor-based. "What happened last time funding spiked on HYPE — and did it matter?" in one call.

Input Output Examples

Name	Type	Req	Description
coin	string	—	Filter to one coin, e.g. "BTC"
hours_back	integer	—	Lookback window in hours (default 24, max 168 = 7d)
limit	integer	—	Max events (default 50)
signal_types	array	—	Filter to specific signal types
since_id	integer	—	Cursor — only events with id > since_id

No output schema declared.

No examples provided.

get_signal_performance Get Signal Performance ~112

Hit rates and average forward returns per signal type, measured on OUR actually-emitted production signals (not a backtest reconstruction). Use this to ground win_rate inputs for get_position_size. Sample sizes included — treat n < 10 as anecdotal.

Input Output Examples

Name	Type	Req	Description
coin	string	—	Filter to one coin, e.g. "BTC"
days	integer	—	Lookback window (default 30, max 90)
signal_type	string	—	Filter to one signal type (default: all)

No output schema declared.

No examples provided.

get_signals Get Signals ~88

Detect divergence signals between Hyperliquid perpetual funding/OI sentiment and HIP-4 on-chain prediction market odds. Returns BULLISH/BEARISH/DIVERGENCE signal with reasoning — e.g. perps long-biased while prediction market prices a decline.

Input Output Examples

Name	Type	Req	Description
coin	string	yes	Ticker of the asset to analyze, e.g. "BTC", "ETH", "SOL"

No output schema declared.

No examples provided.

get_simple_iv Get Simple IV ~63

BTC or ETH options snapshot via free Deribit public feed: ATM implied volatility, total OI, 24h volume. Pro adds put-call skew + full term structure parsing.

Input Output Examples

Name	Type	Req	Description
asset	string	yes	Underlying — Deribit free feed supports BTC and ETH.

No output schema declared.

No examples provided.

get_top_funding_rates Get Top Funding Rates ~94

Top Hyperliquid perps ranked by absolute funding rate, with OI and annualized yield. Useful for finding the most overcrowded longs/shorts and carry opportunities.

Input Output Examples

Name	Type	Req	Description
limit	integer	—	Number of top results to return (default: 10)
min_abs_rate	number	—	Minimum absolute funding rate to include, e.g. 0.0001. Omit to include all.

No output schema declared.

No examples provided.

get_upcoming_catalysts Get Upcoming Catalysts ~112

Lists upcoming market catalysts for an asset within a horizon: token unlocks, governance votes (Tally), ETF/SEC deadlines, FOMC dates. Helps agents avoid blind trades into known events. Free data sources (Tally + curated DB).

Input Output Examples

Name	Type	Req	Description
asset	string	yes	Asset ticker, e.g. "ARB", "SOL", "BTC"
horizon_hours	integer	—	Horizon in hours (default: 168 = 7 days, max: 720 = 30 days)

No output schema declared.

No examples provided.

get_volume_spikes Get Volume Spikes ~88

Polymarket markets with abnormal 24h volume vs their 7-day daily average. Volume spikes typically precede news events or informed positioning.

Input Output Examples

Name	Type	Req	Description
limit	integer	—	Number of results to return (default: 15)
min_ratio	number	—	Minimum ratio of 24h volume vs 7-day daily average to qualify as a spike (default: 3x)

No output schema declared.

No examples provided.

get_whale_flow Get Whale Flow ~139

Cumulative whale buy/sell imbalance over hours-to-days from the durable trade tape (≥$25k trades persisted continuously, restart-proof). Returns imbalance ratio (-1..+1), BUY/SELL_DOMINANT verdict, and the largest recent prints. Longer horizons than get_whale_trades (1h buffer).

Input Output Examples

Name	Type	Req	Description
coin	string	yes	Coin, e.g. "BTC" (top ~10 by OI are taped)
hours	integer	—	Lookback window in hours (default 24)
min_notional_usdc	number	—	Threshold for the sample trades list (tape floor: $25k)

No output schema declared.

No examples provided.

get_whale_label Get Whale Label ~67

Look up an Ethereum address against our curated label DB (CEX hot wallets, known market makers, suspected funds). Lets agents distinguish mechanical MM flow from alpha-generating activity.

Input Output Examples

Name	Type	Req	Description
address	string	yes	Ethereum address to look up (0x-prefixed, 40 hex chars).

No output schema declared.

No examples provided.

get_whale_positions Get Whale Positions ~123

Positions of a specific Polymarket wallet, optionally filtered to one market. The /positions API requires a user (no public "all holders by market" endpoint), so pass the wallet address of the trader you want to inspect.

Input Output Examples

Name	Type	Req	Description
condition_id	string	—	Optional — filter results to a specific market by condition_id.
min_size_usdc	number	—	Minimum position size in USDC to include in results (default: 1,000).
user	string	yes	Polygon wallet address (0x…) of the user whose positions you want.

No output schema declared.

No examples provided.

get_whale_trades Get Whale Trades ~93

Recent large trades on Hyperliquid perps above a notional threshold. Includes side (long/short), size, price, and timestamp.

Input Output Examples

Name	Type	Req	Description
coin	string	yes	Asset ticker to fetch whale trades for, e.g. "BTC", "ETH"
min_notional_usdc	number	—	Minimum trade size in USDC to qualify as a whale trade (default: 50,000)

No output schema declared.

No examples provided.

search_markets Search Markets ~83

Full-text search across all Polymarket and HIP-4 prediction markets. Returns ranked results with current odds.

Input Output Examples

Name	Type	Req	Description
limit	integer	—	Maximum number of results to return (1–50, default: 10)
query	string	yes	Keywords to search in market names and descriptions, e.g. "bitcoin ETF", "US election", "Fed pivot"

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

26 Jul 3 Aug

Day	Score
26 Jul	73
27 Jul	73
28 Jul	74
29 Jul	75
30 Jul	75
31 Jul	79
1 Aug	80
2 Aug	80
3 Aug	81