perpbrain-sdk
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PERPBRAIN_HL_NETWORK | No | Live reads use the public Hyperliquid `/info` endpoint (mainnet by default). Optional: set PERPBRAIN_HL_NETWORK=testnet for testnet. | mainnet |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| marketsA | List perpetual markets from the public info endpoint. |
| order_bookB | Read a capped order book and its data age. |
| fundingB | Read funding, mark, and open interest for one coin. |
| positionsB | Read positions for one address. |
| feesB | Read the address fee rates and their data age. |
| simulateC | Simulate a closed-bar decision on a supplied book. Result is SIMULATED. |
| funding_extremesB | Z-score of the public hourly funding rate against a trailing window. |
| book_imbalanceC | Bid depth divided by ask depth inside a public-book band. |
| get_limitsB | Read the owner limits and the remaining headroom. |
| trigger_kill_switchB | Latch the kill switch. A tool call cannot clear it. |
| get_cost_breakdownB | Recompute the execution-cost breakdown from a simulation receipt. The result is SIMULATED. |
| verify_receiptC | Check a simulation receipt against manifest and inputs bytes. The check is verified and reproducible. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Most tools target clearly distinct reads (markets, order_book, positions, fees, get_limits) or distinct actions (simulate, trigger_kill_switch, verify_receipt). The main overlap risk is funding vs funding_extremes (raw read vs derived z-score) and order_book vs book_imbalance (raw book vs derived ratio), but the descriptions distinguish them well enough.
Conventions are mixed: bare nouns (markets, order_book, funding, positions, fees), noun+metric (funding_extremes, book_imbalance), get_-prefixed reads (get_limits, get_cost_breakdown), and imperative verbs (simulate, trigger_kill_switch, verify_receipt). Readable throughout, but there is no single predictable pattern.
12 tools is well-scoped for a perp/SDK surface covering market data, account reads, simulation, and risk controls. Each tool earns its place with no obvious redundancy.
Covers market data, account/position/fee/limit reads, simulation, cost breakdown, receipt verification, and a risk kill switch — a coherent analysis-and-simulation lifecycle. Gaps are minor and likely intentional (no order execution, and the kill switch is deliberately one-way with no clear/reset tool).