Track Hyperliquid perp traders from Windsurf
Connect StalkChain and ask Windsurf what tracked traders do on Hyperliquid perps: live opens and closes, leverage, entry and liquidation prices, PnL.
- Windsurf is now Devin Desktop. Add one link, 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 Windsurf, in short
- Setup
- One config entry, sign in once. 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 Windsurf?
Connect StalkChain to Windsurf once. After that, Hyperliquid questions work in any chat.
- 1
Connect
Add the StalkChain link to ~/.config/devin/mcp_config.json, or run devin mcp add once. Devin Desktop and Devin CLI share it.
- 2
Approve
Start a new Devin Local session. If StalkChain shows Needs auth, click Authenticate, sign in and press Approve. Free, no card.
- 3
Ask
Ask in plain English. The first time it calls StalkChain, allow every tool on the server, permanently.
Then ask your first question:
- Windsurf updated itself to Devin Desktop. Open ~/.config/devin/mcp_config.json, or %APPDATA%\devin\mcp_config.json on Windows.
- Add the stalkchain entry below under mcpServers and save. Create the file if it's missing.
- Start a new Devin Local session and open customizations from the new-tab menu. If StalkChain shows Needs auth, click Authenticate.
- Sign in to StalkChain in your browser and press Approve. No API key needed.
- Want it in a single repo? Put the same entry in .devin/mcp_config.json and commit it. Each teammate signs in.
{
"mcpServers": {
"stalkchain": {
"url": "https://data.stalkchain.com/mcp"
}
}
}- Run both commands once. -s user saves StalkChain for every project, and Devin Desktop picks it up too.
- The login command opens your browser. Sign in to StalkChain and press Approve.
- Type /mcp in a session any time to check the connection.
devin mcp add -s user stalkchain https://data.stalkchain.com/mcp
devin mcp login stalkchain- Create a key in your StalkChain dashboard.
- Add StalkChain with the key as a header. No browser sign-in, so it works over SSH, in cron and CI.
- User scope writes it to ~/.config/devin/mcp_config.json, outside your repo.
devin mcp add -s user stalkchain https://data.stalkchain.com/mcp \
-H "Authorization: Bearer sc_your_key"How does Windsurf 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 Windsurf about Hyperliquid?
Paste any of these into Windsurf. It picks the tools and shows where each number came from.
Which Hyperliquid tools does Windsurf get?
Each line is a real StalkChain tool Windsurf 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 Windsurf 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 Windsurf: questions
Add StalkChain to Windsurf (one config entry, sign in once), 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 Windsurf 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 Windsurf pull?
Which other AI can use Hyperliquid data?
Ask Windsurf about Hyperliquid with receipts
One link, one sign-in. Then Windsurf answers Hyperliquid questions with live and historical data.
