senpi-ai/senpi-agent
Turn your AI assistant into your AI quant researcher for perpetual futures markets. Read the day's market pulse, scan for signals and anomalies, see where smart money is positioned, research and compare Hyperliquid traders, score any wallet with the Quant Desk, browse Senpi's strategy catalog, and review your own portfolio and trade history. Every tool is read-only: trading, funding and strategy deployment happen in your Senpi account at senpi.ai, never through this plugin.
The user's own standing across Senpi, with the Senpi connector. Use for "how many points do I have?", "what's my rank?", "what are my fees?", "my referral rewards", "what plan am I on?", "how many credits do I have left?". Calls get_account_status (the user's own account). A question about which plans Senpi has or what one costs is answered with a link to senpi.ai/pricing, never a list. Read-only.
Review the signed-in user's own closed Hyperliquid trades with the Senpi connector. Use for "review my trades", "how did I trade this month?", "where am I losing money?", "what should I fix?", "my win rate?", "how did my exits do?", "did I sell too early?". Calls get_wallet_closed_trades (with review), get_wallet_pnl_history and get_my_stop_events with no address, which reads the connected user's own book. Read-only.
Read the Hyperliquid market as a whole with the Senpi connector. Use for "what's moving the markets today?", "how are markets?", "market overview", "what's the regime?", "anything happening in crypto perps?" — any cross-market question that names no single asset. Calls get_market_pulse, then get_leaderboard and get_whale_moves (the last 4 hours) and scan_market_signals (a short signals brief). Also for funding: "funding extremes?", "which coins pay the most funding?", "what's funding on ETH?" — calls get_funding. For one asset's signals, use read_asset_signal instead; for ranked anomalies, scan_market_signals (senpi-signals).
Show the signed-in user their own Senpi account with the Senpi connector. Use for "my portfolio", "my balance", "my positions", "my strategies", "how am I doing?" — and for their stops: "did any of my stops trigger?", "my ratchet-stop events", "did my stop fire?". Calls get_my_portfolio, get_wallet_positions (what a saved wallet or a strategy holds, and its stops) and get_my_stop_events. Reads only the connected user's own account. Read-only — nothing here trades, moves funds, or changes the account.
Quant Desk — read a Hyperliquid wallet like a quant with the Senpi connector: a 0-100 quant score with six explained dimensions, archetype and verdict, the live book's protection, the P&L waterfall and leaks priced in dollars, the strategy read, market fit, smart-money comparison and where the edge is. Use for "run quant desk", "run AI quant", "score my trading", "rate my trading", "find leaks", "where am I leaking money", "analyze my wallet", "score this trader 0x…", "is my book protected?", "compare these wallets with the desk", "which of these is the better trader", "find me traders to analyze / run the desk on", "what fits me today". Calls get_wallet_analysis (the analysis, by parts) and get_wallet_positions (the live book), with find_top_traders (size_band) for candidates, get_my_portfolio for the user's wallets (one by one or all as one book) and compare_wallets for two to five wallets side by side. The user's own book needs their Senpi sign-in; any other address is public data. Read-only.
Scan Hyperliquid markets for ranked anomalies with the Senpi connector. Use for "scan the market for signals", "any anomalies?", "what's unusual today?", "where's the momentum?" — requests for a ranked sweep rather than a general overview. Calls scan_market_signals, then read_asset_signal and get_asset_market_data on the top hits. For the overall read use get_market_pulse (senpi-market-pulse). Funding extremes are get_funding and whale movements are get_whale_moves (senpi-smart-money), not this skill.
Read where top Hyperliquid traders sit with the Senpi connector. Use for "what's smart money doing?", "are the whales long or short?", "smart money on ETH?", "big moves lately?", "who's buying?", "whale movements?", "what did smart money do today?". Calls get_smart_money_positioning (the cohort's current lean), get_smart_money_flow (what the cohorts did over a window) and get_whale_moves (top traders whose 4h P&L crossed a tier). Public wallets, read-only.
Help the user explore Senpi's public strategy catalog with the Senpi connector. Use for "what strategies does Senpi have?", "recommend a strategy for a choppy market", "something low-risk", "what's in the catalog?", "details on Athena". Calls browse_strategy_catalog and get_catalog_strategy, with get_my_portfolio (the user's budget and holdings, when signed in) and get_asset_market_data (why now). Read-only catalog: nothing is deployed, funded, or started from here — that happens in senpi.ai.
Research public Hyperliquid traders with the Senpi connector. Use for "find top traders", "best traders this month", "who's consistent?", "find traders to copy", "who could I mirror?", "compare these wallets", "is 0x… any good?", "show me their trades". Calls find_top_traders (ranked search, or with shortlist a ranking for copyability), get_wallet_profile (who a wallet is, 1–5 at once; with vet, its current book read for copyability), get_wallet_closed_trades (a wallet's trades), get_wallet_pnl_history (its P&L curve) and get_market_pulse (the day's tape a shortlist is read against). Read-only public data; nothing here copies or follows anyone.
The positioning answer for "why Senpi?". Use for "what makes Senpi different?", "why should I use Senpi?", "Senpi vs other trading apps or AI chatbots", "is Senpi just another trading UI?", "why not just ask ChatGPT?", "where's the proof?" — in any language. Needs no tool call; optionally grounds claims with the connector's read-only tools (list_instruments for the live market count, get_market_pulse or scan_market_signals for a live read).