Track Hyperliquid perp traders from Hermes Agent
Connect StalkChain and ask Hermes Agent what tracked traders do on Hyperliquid perps: live opens and closes, leverage, entry and liquidation prices, PnL.
- One click in Hermes Desktop, or one command. Sign in once.
- Live feed: 100 tracked-trader perp opens and closes in 7 hours on Oct 3, each with side, leverage and coin.
- Per trader: open perps with size, entry price, liquidation price, margin used and live perp PnL.
Free to connect · No card · No API key

Hyperliquid data in Hermes Agent, in short
- Setup
- One click or one command. No API key needed.
- Connection
- One MCP link for every chain and source: https://data.stalkchain.com/mcp
- Coverage
- Two layers. Hyperliquid perps (FOMO network 1337, aliases hype, hl, perps) for tracked traders. HyperEVM (chain id 999, native HYPE) for any wallet or token.
- Data
- Perp opens and closes with side and leverage, realized PnL on closes, open perps with entry and liquidation prices, margin and live perp PnL. HyperEVM holdings, transfers, token metadata and prices.
- History
- Perp feed: the newest 100 Hyperliquid events per call, about 7 hours of activity on Oct 3. Open perps are read live. HyperEVM: a wallet's full transfer history, and HYPE price history by day, hour or 5 minutes.
- Freshness
- Perp events arrive as FOMO posts them, and the margin read is live at call time. The live-stream tool samples the feed as it happens. HyperEVM reads hit the chain live.
- IDs
- Traders by FOMO handle or userId. Perp markets by coin ticker (ZEC, SOL, HYPE); builder markets carry a dex prefix like xyz:META. HyperEVM wallets and tokens are 0x addresses.
- Upstream
- FOMO (fomo.family) for traders and perps. EVM RPC and price feeds for HyperEVM. DefiLlama for chain TVL, yields and exploits, where Hyperliquid is listed as Hyperliquid L1.
- Best for
- Seeing which tracked traders are long or short, at what leverage, with what entry and liquidation price, and who just closed with a profit or a loss.
- Not covered
- No theses, no price or smart-money alerts on Hyperliquid. Perps do not appear in the positions or fills tools. HyperEVM token holders, dev checks and candles are not available.
How do I get Hyperliquid data in Hermes Agent?
Connect StalkChain to Hermes Agent once. After that, Hyperliquid questions work in any chat.
- 1
Connect
Click Add to Hermes, then Add server in Hermes Desktop. Or run hermes mcp add stalkchain in your terminal.
- 2
Approve
Click Authenticate, or let the command open your browser. Sign in to StalkChain and press Approve. Free, no card.
- 3
Ask
Start a new chat in the terminal, Desktop or Telegram. Ask in plain English and Hermes picks the StalkChain tools.
Then ask your first question:
- Click Add to Hermes on this page. Hermes Desktop opens and asks: Add MCP server?
- Check the Server JSON matches the one below, then click Add server.
- On the Connectors page, StalkChain shows Needs authentication. Click Authenticate, sign in to StalkChain and press Approve.
- Start a new chat. Hermes now sees the StalkChain tools.
- Nothing opens? Update Hermes Desktop to v2026.8.16 or newer, or use the terminal command.
{
"url": "https://data.stalkchain.com/mcp",
"auth": "oauth"
}- Run this once. Your browser opens: sign in to StalkChain and press Approve.
- When Hermes lists the StalkChain tools, press Enter to enable them all.
- Start a new hermes session, or type /reload-mcp in a running one. A running gateway picks it up within a minute.
- Hermes on a VPS? Open the printed link on your laptop, approve, then paste the URL your browser lands on back into the terminal.
- Run hermes mcp test stalkchain any time to check the connection.
hermes mcp add stalkchain --url https://data.stalkchain.com/mcp --auth oauth- Create a key in your StalkChain dashboard.
- Run this. Press Enter when Hermes asks if the server needs authentication, then paste your key.
- Hermes keeps it in ~/.hermes/.env, not config.yaml. No browser sign-in, so it works on a VPS, in Docker and for cron.
hermes mcp add stalkchain --url https://data.stalkchain.com/mcp --auth headerHow does Hermes Agent answer a Hyperliquid question?
A real question, answered through StalkChain. The numbers are the tools' real output, trimmed to fit.
Tracked traders logged 100 perp opens and closes on Hyperliquid in the 7 hours to 06:51 UTC. The standouts:
| Trader | Action | Market | Detail |
|---|---|---|---|
| 000000 | Closed | PUMP perp | +$55K realized, 01:12 UTC |
| Salem1299534 | Closed | ZEC perp | +$37K realized, 04:19 UTC |
| excesscapital | Closed short, re-shorted | ZEC perp, 10× | +$12K, then 114 ZEC short from $1,315, liq $1,461 |
| TheHappySwan | Opened long | SOL perp, 20× | 10 open prints, 2 closes, 01:17 to 05:20 UTC |
| TheGhate | Closed | PONS perp | −$10,113 realized, 05:14 UTC |
| OneUnipcsHair | Opened long | BTC perp, 40× | 01:44 UTC |
excesscapital banked +$12K closing a 10× ZEC short at 05:48 UTC and was short again by 06:50: the live margin read shows 114 ZEC from $1,315 with liquidation at $1,461 and $24.9k isolated margin. Want the same read on TheHappySwan's 20× SOL longs?
Real StalkChain answers, trimmed to fit. Handles are public FOMO traders. Data, not financial advice.
What can I ask Hermes Agent about Hyperliquid?
Paste any of these into Hermes Agent. It picks the tools and shows where each number came from.
Which Hyperliquid tools does Hermes Agent get?
Each line is a real StalkChain tool Hermes Agent can call, and the kind of question it answers.
Perp activity, live
stalkchain_fomo_alertsWhat perps did tracked traders open or close on Hyperliquid in the last hour?stalkchain_fomo_watch_streamWatch the Hyperliquid perp feed for 60 seconds and tell me who opened or closed what.
Positions and PnL per trader
stalkchain_fomo_trader_balancesWhat is excesscapital short on Hyperliquid right now, at what entry and liquidation price?stalkchain_fomo_searchFind TheHappySwan: userId, wallets and PnL.stalkchain_fomo_leaderboardWhere do today's Hyperliquid perp traders sit on the 24h PnL leaderboard?
HyperEVM wallets and prices
stalkchain_wallet_portfolioWhat does this 0x wallet hold on HyperEVM, and what is it worth?stalkchain_wallet_transfersWhat has this 0x wallet done on HyperEVM lately, and who funded it?stalkchain_wallet_ageIs this HyperEVM wallet fresh or a long-standing trader?stalkchain_token_infoWhat token is this 0x contract on HyperEVM?stalkchain_token_prices_multichainPrice HYPE and this HyperEVM contract.stalkchain_price_historyWhat was HYPE worth each day in September?
Chain-level DeFi
stalkchain_chain_healthHow much TVL and stablecoin supply sits on Hyperliquid versus Base?stalkchain_token_yieldsWhere can I earn on HYPE, and what does it actually pay?stalkchain_defi_hacksWhat has been exploited on Hyperliquid, and for how much?
Agent wallet on HyperEVM
stalkchain_agent_walletWhere do I send HYPE to fund my agent, and what are my limits?stalkchain_agent_buyBuy 2 HYPE of this HyperEVM token from my agent wallet.
What should Hermes Agent know about Hyperliquid data?
- Two chain ids
- In trader tools, chain=hyperliquid (or hype, hl, perps) means Hyperliquid perps, FOMO network 1337. In wallet, price and token tools it means HyperEVM, chain id 999, native HYPE. Pick the layer that matches the question.
- Where perps live
- Open perps come from stalkchain_fomo_trader_balances: hyperliquidPerps lists coin, side, size, leverage, isolated or cross, entry, liquidation and margin, and livePerpPnl is the trader's live perp PnL. Opens and closes come from stalkchain_fomo_alerts and the live stream, type perp. stalkchain_fomo_trader_positions and _swaps are spot only and return no Hyperliquid rows.
- Reading the feed
- Perp events carry no token address or trade id; the text holds side, leverage and coin. usdValue is set only on 'closed ... PnL' events and is realized PnL. Builder markets show a dex prefix, like xyz:META.
- Nulls
- In hyperliquidPerps, mark price, position value and unrealized PnL can be null. Say so rather than treating null as zero. totalValueUsd counts spot holdings only and excludes perps.
- Not here
- No theses, price alerts or smart-money alerts on Hyperliquid. Agent-wallet buys and sells with chain=hyperliquid are HyperEVM spot swaps paid in HYPE, not perp orders.
Hyperliquid data in Hermes Agent: questions
Add StalkChain to Hermes Agent (one click or one command), then ask a Hyperliquid question in plain words. It takes about a minute and needs no API key. The same connection covers every other chain and source too.
Yes. stalkchain_fomo_trader_balances with chain=hyperliquid returns each open perp: coin, long or short, size, leverage and whether it is isolated or cross, entry price, liquidation price and margin used, plus the trader's live perp PnL and available USDC. Mark price and unrealized PnL per position can come back null, and Hermes Agent will say so instead of guessing.
Yes. The FOMO feed emits a perp event every time a tracked trader opens or closes, with side, leverage and coin, and realized PnL on closes. Ask for the last hour, or watch the live stream for up to two minutes. On Oct 3 the feed carried 100 Hyperliquid events in about 7 hours.
Both, in different tools. Trader tools read the perp exchange, FOMO network 1337. Wallet, price and token tools read HyperEVM, chain id 999 with HYPE as the native coin, so any 0x address works there: holdings, transfers, wallet age, token metadata and prices.
Because those tools cover spot token trades, and perps are not spot. A trader with a live ZEC short shows seven open spot positions on Solana and Robinhood Chain and none on Hyperliquid. Use trader balances for open perps and the alert feed for opens and closes.
Not yet. Price and smart-money alerts cover Solana, Ethereum, Base and BNB Chain only, and there are no written theses on Hyperliquid. Ask for the perp feed on a schedule if your setup runs headless, or watch the live stream.
It can swap on HyperEVM: buy or sell a token with HYPE from your agent's EVM address, within the per-trade and daily limits you set, and only when you ask. It cannot open or close perps. The research tools never touch your wallet.
Connecting is free and needs no card. Free tools, like the live feed sample, work right away. Most research lookups are paid; the plans are listed on data.stalkchain.com.
What else can Hermes Agent pull?
Which other AI can use Hyperliquid data?
Ask Hermes Agent about Hyperliquid with receipts
One link, one sign-in. Then Hermes Agent answers Hyperliquid questions with live and historical data.
