get_spot_metadata
Retrieve metadata for spot markets on Hyperliquid exchange, including trading pairs and contract details like symbol and tick size.
Instructions
Fetch metadata about spot markets on the Hyperliquid exchange.
Parameters:
include_asset_ctxs (bool, optional): If True, includes asset contexts with metadata. Defaults to False.
ctx (Context, optional): The MCP context object for accessing server state.
Returns:
str: A JSON string containing metadata about spot markets, including trading pairs and contract details
(e.g., symbol, tick size). Returns a JSON string with an error message if the query fails.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| include_asset_ctxs | No |
Implementation Reference
- main.py:360-376 (handler)The core handler function for the 'get_spot_metadata' MCP tool. It is registered via the @mcp.tool() decorator. The function calls the Hyperliquid SDK's spot_meta() or spot_meta_and_asset_ctxs() method based on the include_asset_ctxs parameter and returns the result as a JSON string, handling exceptions appropriately.
async def get_spot_metadata(include_asset_ctxs: bool=False, ctx: Context=None) -> str: """ Fetch metadata about spot markets on the Hyperliquid exchange. Parameters: include_asset_ctxs (bool, optional): If True, includes asset contexts with metadata. Defaults to False. ctx (Context, optional): The MCP context object for accessing server state. Returns: str: A JSON string containing metadata about spot markets, including trading pairs and contract details (e.g., symbol, tick size). Returns a JSON string with an error message if the query fails. """ try: data = info.spot_meta_and_asset_ctxs() if include_asset_ctxs else info.spot_meta() return json.dumps(data) except Exception as e: return json.dumps({"error": f"Failed to fetch spot metadata: {str(e)}"})