Server definition
- Hash
- sha256:4c0126592105fd21bda79034db619295a91a1f8f04de16379a6c5db3d8776348
- What it is
- What a remote MCP server returned when asked what it offers: 21 tools
The blob, as servednamed by its sha256
{
"instructions": "Blockmetric: real-time crypto market data. Hyperliquid on-chain positions (liquidation heatmap from real positions, whales, wallets, order flow) plus centralized exchanges where their terms allow redistribution (liquidation totals, funding, long/short). A venue that is switched off or not licensed for the API answers with an error that says so; meta.sources names the sources of every answer. All tools are read-only. Money values are USD, times ISO 8601 UTC; funding, distances and changes are fractions (0.01 = 1 %). Coins use Hyperliquid names (BTC, ETH, kPEPE). Without a key the server uses public access (free-tier data, 24 h of history); a free personal key raises the history to 30 days. Data from public sources without guarantee.",
"tools": [
{
"description": "Whether the Blockmetric API and its data feeds are healthy right now: overall status, API version, feeds that are delayed or down, and open incidents. Use it when data looks stale or a tool fails.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_api_status",
"outputSchema": null
},
{
"description": "OHLC price candles of one coin (UTC-aligned) with volume: the price change, high and low over the window plus the newest candles. Use it for price context next to positioning or liquidation data.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"coin": {
"description": "Coin name as on Hyperliquid, e.g. BTC, ETH, kPEPE, xyz:TSLA (case-insensitive).",
"pattern": "^[A-Za-z0-9][A-Za-z0-9:._-]{0,39}$",
"type": "string"
},
"from": {
"description": "Start (default: `limit` candles before `to`).",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"type": "string"
},
"limit": {
"description": "Number of candles (default 24, at most 200).",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"tf": {
"description": "Candle interval (default 1h).",
"enum": [
"5m",
"15m",
"1h",
"4h",
"1d"
],
"type": "string"
},
"to": {
"description": "End, exclusive (default now).",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"type": "string"
}
},
"required": [
"coin"
],
"type": "object"
},
"name": "get_candles",
"outputSchema": null
},
{
"description": "Risk radar events, newest first: whale moves, whales near liquidation, big liquidations, cascades, funding extremes and flips, open interest spikes, records, exploits/hacks, stablecoin depegs, TVL drops, exchange outflows. Use it for \"what just happened?\".",
"inputSchema": {
"additionalProperties": false,
"properties": {
"coin": {
"description": "Coin name as on Hyperliquid, e.g. BTC, ETH, kPEPE, xyz:TSLA (case-insensitive).",
"pattern": "^[A-Za-z0-9][A-Za-z0-9:._-]{0,39}$",
"type": "string"
},
"kinds": {
"description": "Only these event kinds (default all).",
"items": {
"enum": [
"whale_open",
"whale_close",
"whale_liquidated",
"big_liquidation",
"liq_cascade",
"funding_extreme",
"funding_flip",
"oi_spike",
"hack",
"depeg",
"tvl_drop",
"cex_outflow",
"whale_near_liq",
"record",
"smart_money",
"hl_market_change",
"hl_manipulation",
"hl_adl",
"oracle_deviation",
"vault_drawdown",
"liq_extreme",
"protocol_outflow",
"incident",
"big_transfer",
"stablecoin_mint",
"stablecoin_burn",
"dex_whale_trade",
"risk_wallet_move",
"risk_wallet_listed"
],
"type": "string"
},
"type": "array",
"uniqueItems": true
},
"limit": {
"description": "Number of events (default 10, at most 50).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"min_severity": {
"description": "1 info, 2 notable, 3 major, 4 critical (default 1).",
"maximum": 4,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "get_events",
"outputSchema": null
},
{
"description": "On-chain flows into and out of exchange wallets over a window: inflow, outflow and net per exchange and asset (stablecoins, BTC, ETH). Net outflows often mean coins moving to self-custody, inflows coins ready to sell.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"asset": {
"description": "Only this asset family, e.g. USDT, BTC.",
"pattern": "^[A-Za-z0-9.]{1,20}$",
"type": "string"
},
"exchange": {
"description": "Only this exchange, e.g. Binance.",
"pattern": "^[A-Za-z0-9 ._-]{1,40}$",
"type": "string"
},
"hours": {
"description": "Window in hours (default 24).",
"maximum": 2160,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "get_exchange_flows",
"outputSchema": null
},
{
"description": "Funding rates per coin across Hyperliquid and the exchanges the data licence allows (annualised, as fractions) and the spread between venues.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"coin": {
"description": "Coin name as on Hyperliquid, e.g. BTC, ETH, kPEPE, xyz:TSLA (case-insensitive).",
"pattern": "^[A-Za-z0-9][A-Za-z0-9:._-]{0,39}$",
"type": "string"
},
"limit": {
"description": "Number of coins, by Hyperliquid open interest (default 10, at most 50).",
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "get_funding",
"outputSchema": null
},
{
"description": "The newest large taker prints (trades above the tape threshold) with side, price, size and whether a tracked whale was the taker.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"coin": {
"description": "Coin name as on Hyperliquid, e.g. BTC, ETH, kPEPE, xyz:TSLA (case-insensitive).",
"pattern": "^[A-Za-z0-9][A-Za-z0-9:._-]{0,39}$",
"type": "string"
},
"limit": {
"description": "Number of prints (default 20, at most 50).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"min_usd": {
"description": "Only prints of at least this many USD.",
"minimum": 0,
"type": "integer"
},
"minutes": {
"description": "Look-back window in minutes (default 60).",
"maximum": 1440,
"minimum": 1,
"type": "integer"
},
"side": {
"description": "Side of the taker.",
"enum": [
"buy",
"sell"
],
"type": "string"
},
"venue": {
"description": "Only this venue.",
"enum": [
"hyperliquid",
"binance",
"bybit"
],
"type": "string"
}
},
"type": "object"
},
"name": "get_large_trades",
"outputSchema": null
},
{
"description": "Where liquidations WOULD happen for one coin: the liquidation heatmap over time built from real tracked Hyperliquid positions. Returns the largest clusters of liquidatable positions above the mark (shorts) and below it (longs) in the newest snapshot, with USD at risk and the distance from the mark. Use it for \"where are the liquidation levels / magnets for BTC?\". For liquidations that already happened use get_liquidations.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"coin": {
"description": "Coin name as on Hyperliquid, e.g. BTC, ETH, kPEPE, xyz:TSLA (case-insensitive).",
"pattern": "^[A-Za-z0-9][A-Za-z0-9:._-]{0,39}$",
"type": "string"
},
"end": {
"description": "End of the window (default now). Set it to look at the heatmap of an earlier time.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"type": "string"
},
"hours": {
"description": "Look-back window in hours (default 24; capped by the plan history).",
"maximum": 8760,
"minimum": 1,
"type": "integer"
},
"tf": {
"description": "Column interval (default: chosen from hours: 15m up to 7 days, 1h up to 30 days, then 4h / 12h). Intervals outside the plan answer plan_required.",
"enum": [
"1m",
"5m",
"15m",
"1h",
"4h",
"12h",
"1d"
],
"type": "string"
},
"top": {
"description": "Clusters per side (default 5).",
"maximum": 20,
"minimum": 1,
"type": "integer"
}
},
"required": [
"coin"
],
"type": "object"
},
"name": "get_liquidation_heatmap",
"outputSchema": null
},
{
"description": "Current liquidation levels of one coin from tracked Hyperliquid positions: USD of long and short positions per price bucket right now, with totals. A snapshot; for the history over time use get_liquidation_heatmap.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"coin": {
"description": "Coin name as on Hyperliquid, e.g. BTC, ETH, kPEPE, xyz:TSLA (case-insensitive).",
"pattern": "^[A-Za-z0-9][A-Za-z0-9:._-]{0,39}$",
"type": "string"
},
"top": {
"description": "Largest buckets per side (default 5).",
"maximum": 20,
"minimum": 1,
"type": "integer"
}
},
"required": [
"coin"
],
"type": "object"
},
"name": "get_liquidation_map",
"outputSchema": null
},
{
"description": "Liquidations that HAPPENED: totals of the last hours (long/short USD, per venue, top coins, largest single liquidation) plus the latest individual liquidations the data licence allows, optionally only large ones (min_usd) or one side. Use it for \"how much got liquidated today?\" or \"latest big liquidations\".",
"inputSchema": {
"additionalProperties": false,
"properties": {
"coin": {
"description": "Coin name as on Hyperliquid, e.g. BTC, ETH, kPEPE, xyz:TSLA (case-insensitive).",
"pattern": "^[A-Za-z0-9][A-Za-z0-9:._-]{0,39}$",
"type": "string"
},
"hours": {
"description": "Window in hours (default 24; capped by the plan).",
"maximum": 2880,
"minimum": 1,
"type": "integer"
},
"limit": {
"description": "Number of latest liquidations (default 5, at most 50).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"min_usd": {
"description": "Only liquidations of at least this many USD in the latest list.",
"maximum": 1000000000,
"minimum": 0,
"type": "integer"
},
"side": {
"description": "Only liquidated longs or shorts in the latest list.",
"enum": [
"long",
"short"
],
"type": "string"
},
"venue": {
"description": "Only this venue for the latest liquidations list.",
"enum": [
"hyperliquid",
"lighter",
"binance",
"bybit",
"okx"
],
"type": "string"
}
},
"type": "object"
},
"name": "get_liquidations",
"outputSchema": null
},
{
"description": "Wallets an official source lists (OFAC SDN list, FBI / IC3 announcements, official incident post-mortems), each as \"Listed as <category> by <source>, <date>\" with a link. With an address: its listings, balances and tracked on-chain movements (404 when it is not listed). The other side of a movement is never labelled by us.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"address": {
"description": "One address (EVM, Bitcoin, Tron …): its listings and movements.",
"pattern": "^(0x[0-9a-fA-F]{40}|[A-Za-z0-9:]{20,120})$",
"type": "string"
},
"category": {
"description": "Only this category (sanctioned, stolen_funds, exploit …).",
"enum": [
"sanctioned",
"stolen_funds",
"exploit",
"drainer",
"phishing",
"other"
],
"type": "string"
},
"limit": {
"description": "Number of wallets or movements (default 10, at most 50).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"network": {
"description": "Only this address family (evm, bitcoin, tron …).",
"enum": [
"evm",
"bitcoin",
"tron",
"litecoin",
"monero",
"bitcoin_cash",
"dash",
"zcash",
"solana",
"ripple",
"dogecoin",
"bitcoin_gold",
"bitcoin_sv",
"verge",
"ethereum_classic",
"bnb_beacon",
"other"
],
"type": "string"
},
"source": {
"description": "Only this source: ofac_sdn, fbi_ic3 or incident.",
"enum": [
"ofac_sdn",
"fbi_ic3",
"incident"
],
"type": "string"
}
},
"type": "object"
},
"name": "get_listed_wallets",
"outputSchema": null
},
{
"description": "Long/short positioning per coin: Hyperliquid from tracked positions (USD ratio) and, where the data licence allows, the account ratios the exchanges publish.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"coin": {
"description": "Coin name as on Hyperliquid, e.g. BTC, ETH, kPEPE, xyz:TSLA (case-insensitive).",
"pattern": "^[A-Za-z0-9][A-Za-z0-9:._-]{0,39}$",
"type": "string"
},
"limit": {
"description": "Number of coins (default 10, at most 50).",
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "get_long_short",
"outputSchema": null
},
{
"description": "Large on-chain transfers and whale moves, newest first: exchange in/outflows, transfers between wallets, stablecoin mints and burns, bridges, DEX swaps and large Hyperliquid positions and trades, with labels where a source names the wallet.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"asset": {
"description": "Asset symbol, e.g. BTC, ETH, USDT.",
"pattern": "^[A-Za-z0-9.]{1,20}$",
"type": "string"
},
"chain": {
"description": "Only this chain.",
"enum": [
"ethereum",
"arbitrum",
"base",
"bitcoin",
"hyperliquid"
],
"type": "string"
},
"labelled": {
"description": "Only movements with a labelled sender or receiver.",
"type": "boolean"
},
"limit": {
"description": "Number of movements (default 15, at most 50).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"min_usd": {
"description": "Only movements of at least this many USD.",
"minimum": 0,
"type": "integer"
},
"types": {
"description": "Only these movement types (default all).",
"items": {
"enum": [
"transfer",
"exchange_in",
"exchange_out",
"exchange_exchange",
"mint",
"burn",
"bridge",
"dex_buy",
"dex_sell",
"perp_position",
"big_trade"
],
"type": "string"
},
"type": "array",
"uniqueItems": true
}
},
"type": "object"
},
"name": "get_movements",
"outputSchema": null
},
{
"description": "The plan behind this server's key (or keyless public access): requests per minute and per day and how many are left, the history window, heatmap intervals and whether commercial use is allowed. Use it before a large research task or when a tool reports a rate limit. Not counted against the limits.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_my_limits",
"outputSchema": null
},
{
"description": "Taker flow of one coin over a window: buy vs sell volume, delta and cumulative volume delta in total, per venue, by print size and for tracked whales, plus the volume profile (point of control, value area). Use it for \"who is buying BTC?\".",
"inputSchema": {
"additionalProperties": false,
"properties": {
"coin": {
"description": "Coin name as on Hyperliquid, e.g. BTC, ETH, kPEPE, xyz:TSLA (case-insensitive).",
"pattern": "^[A-Za-z0-9][A-Za-z0-9:._-]{0,39}$",
"type": "string"
},
"hours": {
"description": "Window in hours (default 24; free keys 1).",
"maximum": 168,
"minimum": 1,
"type": "integer"
},
"venue": {
"description": "Only this venue.",
"enum": [
"hyperliquid",
"binance",
"bybit"
],
"type": "string"
}
},
"required": [
"coin"
],
"type": "object"
},
"name": "get_order_flow",
"outputSchema": null
},
{
"description": "Order book liquidity of one coin: depth within bands around the mid (bids vs asks, imbalance) and the largest walls with their status (active, pulled before the price arrived, filled). Use it for support / resistance from resting orders.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"coin": {
"description": "Coin name as on Hyperliquid, e.g. BTC, ETH, kPEPE, xyz:TSLA (case-insensitive).",
"pattern": "^[A-Za-z0-9][A-Za-z0-9:._-]{0,39}$",
"type": "string"
},
"venue": {
"description": "Only this venue (default every venue the licence allows).",
"enum": [
"hyperliquid",
"binance",
"bybit"
],
"type": "string"
},
"walls": {
"description": "Walls to list (default 8).",
"maximum": 20,
"minimum": 1,
"type": "integer"
}
},
"required": [
"coin"
],
"type": "object"
},
"name": "get_orderbook",
"outputSchema": null
},
{
"description": "Every coin in one table: price and open-interest change, funding now and predicted, long/short, liquidations in 24 h, nearest liquidation cluster, RSI and volatility. Sort to find movers, crowded trades or extreme funding.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"coin": {
"description": "Coin name as on Hyperliquid, e.g. BTC, ETH, kPEPE, xyz:TSLA (case-insensitive).",
"pattern": "^[A-Za-z0-9][A-Za-z0-9:._-]{0,39}$",
"type": "string"
},
"dir": {
"description": "desc (default) or asc.",
"enum": [
"desc",
"asc"
],
"type": "string"
},
"limit": {
"description": "Number of coins (default 15, at most 50).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"min_oi_usd": {
"description": "Only coins with at least this open interest (USD).",
"minimum": 0,
"type": "integer"
},
"sort": {
"description": "Sort column (default oi = open interest).",
"enum": [
"oi",
"change1h",
"change24h",
"oiChange1h",
"oiChange24h",
"funding",
"fundingPred",
"ls",
"liq24h",
"cluster",
"rsi1h",
"rsi4h",
"vol",
"coin"
],
"type": "string"
}
},
"type": "object"
},
"name": "get_screener",
"outputSchema": null
},
{
"description": "Hacks, exploits, depegs and other security incidents, newest first: detector events and curated incidents with the reported loss and primary-source links.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"chain": {
"description": "Only this chain.",
"enum": [
"ethereum",
"arbitrum",
"base",
"optimism",
"polygon",
"bnb",
"avalanche",
"solana",
"bitcoin",
"tron",
"hyperliquid",
"sui",
"aptos",
"ronin",
"harmony",
"fantom",
"starknet",
"blast",
"linea",
"zksync",
"mantle",
"sonic",
"ton",
"xrp",
"other"
],
"type": "string"
},
"limit": {
"description": "Number of incidents (default 10, at most 50).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"min_severity": {
"description": "1 info, 2 notable, 3 major, 4 critical (default 1).",
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"origin": {
"description": "all (default), detector or curated.",
"enum": [
"all",
"detector",
"curated"
],
"type": "string"
}
},
"type": "object"
},
"name": "get_security_incidents",
"outputSchema": null
},
{
"description": "What the most profitable tracked wallets do: convergence events (several top wallets opening the same side of a coin within a short window) and their current net positioning per coin.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"coin": {
"description": "Coin name as on Hyperliquid, e.g. BTC, ETH, kPEPE, xyz:TSLA (case-insensitive).",
"pattern": "^[A-Za-z0-9][A-Za-z0-9:._-]{0,39}$",
"type": "string"
},
"limit": {
"description": "Number of events and coins (default 10, at most 50).",
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "get_smart_money",
"outputSchema": null
},
{
"description": "Hyperliquid trader leaderboard: PnL and ROI per window, account value, observed win rate, drawdown, Sharpe and style tags. Use it to find consistently profitable wallets; follow up with get_wallet.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"description": "Number of traders (default 10, at most 50).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"sort": {
"description": "Sort (default pnl_month).",
"enum": [
"pnl_day",
"pnl_week",
"pnl_month",
"pnl_all",
"roi_week",
"roi_month",
"roi_all",
"account_value",
"vlm_month",
"sharpe",
"drawdown"
],
"type": "string"
},
"style": {
"description": "Only traders with this style tag (paid plans).",
"enum": [
"scalper",
"swing",
"position",
"high_turnover",
"high_leverage",
"mostly_long",
"mostly_short"
],
"type": "string"
}
},
"type": "object"
},
"name": "get_traders",
"outputSchema": null
},
{
"description": "One tracked Hyperliquid wallet: account value, open positions with leverage and liquidation prices, totals and the latest position changes.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"address": {
"description": "0x address (40 hex characters).",
"pattern": "^0x[0-9a-fA-F]{40}$",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "get_wallet",
"outputSchema": null
},
{
"description": "Largest tracked Hyperliquid wallets with public labels (and the label source), open notional, all-time PnL, largest position and its distance to liquidation. Use sort=near_liq for whales close to liquidation.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"coin": {
"description": "Coin name as on Hyperliquid, e.g. BTC, ETH, kPEPE, xyz:TSLA (case-insensitive).",
"pattern": "^[A-Za-z0-9][A-Za-z0-9:._-]{0,39}$",
"type": "string"
},
"labelled": {
"description": "Only wallets with a public label from a cited source.",
"type": "boolean"
},
"limit": {
"description": "Number of wallets (default 10, at most 50).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"sort": {
"description": "size = open notional (default), pnl = all-time PnL, near_liq = closest to liquidation, liquidated = most liquidations.",
"enum": [
"size",
"pnl",
"near_liq",
"liquidated"
],
"type": "string"
}
},
"type": "object"
},
"name": "get_whales",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:4c0126592105fd21bda79034db619295a91a1f8f04de16379a6c5db3d8776348 | sha256sum