cerebrus_funding
Retrieve funding rate analysis for Hyperliquid perpetuals. Returns current rate, annualized percentage, and historical min/max/average for any coin ticker with adjustable lookback up to 168 hours.
Instructions
Get funding rate analysis for a Hyperliquid perpetual. Returns current rate, annualized percentage, historical min/max/average. Cost: $0.01 USDC via x402.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| coin | Yes | Coin ticker (e.g., BTC, ETH, SOL). Case-insensitive. | |
| lookback_hours | No | Hours of historical data (1-168). Default: 24 |
Implementation Reference
- Registration and schema definition for the cerebrus_funding tool in the list_tools function. Defines the tool name, description, and input schema (coin required, lookback_hours optional with default 24).
Tool( name="cerebrus_funding", description=( "Get funding rate analysis for a Hyperliquid perpetual. " "Returns current rate, annualized percentage, historical min/max/average. " "Cost: $0.01 USDC via x402." ), inputSchema={ "type": "object", "properties": { "coin": { "type": "string", "description": "Coin ticker (e.g., BTC, ETH, SOL). Case-insensitive.", }, "lookback_hours": { "type": "integer", "description": "Hours of historical data (1-168). Default: 24", "default": 24, "minimum": 1, "maximum": 168, }, }, "required": ["coin"], }, ), - src/cerebrus_pulse_mcp/server.py:386-389 (handler)Handler implementation in call_tool. Validates the coin, extracts optional lookback_hours (default 24), and makes a GET request to /funding/{coin} with the parameters.
elif name == "cerebrus_funding": coin = _validate_coin(arguments["coin"]) lookback = arguments.get("lookback_hours", 24) result = _api_get(f"/funding/{coin}", params={"lookback_hours": lookback}) - CLI helper mapping for the funding tool, defining the API path template and parameter specs.
"funding": ("/funding/{coin}", [("coin", True, str, None), ("lookback_hours", False, int, 24)]),