get_derivatives_summary
Retrieve volume details for a specific perpetual protocol to analyze derivatives market data and performance metrics.
Instructions
GET /api/summary/derivatives/{protocol}
Volume Details about a specific perp protocol.
Parameters:
protocol: protocol slug (e.g., 'hyperliquid')
exclude_total_data_chart: true to exclude aggregated chart from response
exclude_total_data_chart_breakdown: true to exclude broken down chart from responseInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| protocol | Yes | ||
| exclude_total_data_chart | No | ||
| exclude_total_data_chart_breakdown | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- defillama_server.py:483-503 (handler)The handler function for the 'get_derivatives_summary' tool. It is decorated with @mcp.tool(), which registers it with the MCP server. The function makes an HTTP request to the DefiLlama API for derivatives summary data for a given protocol and returns the result as a string.
@mcp.tool() async def get_derivatives_summary( protocol: str, exclude_total_data_chart: bool = False, exclude_total_data_chart_breakdown: bool = False ) -> str: """GET /api/summary/derivatives/{protocol} Volume Details about a specific perp protocol. Parameters: protocol: protocol slug (e.g., 'hyperliquid') exclude_total_data_chart: true to exclude aggregated chart from response exclude_total_data_chart_breakdown: true to exclude broken down chart from response """ params = { 'excludeTotalDataChart': str(exclude_total_data_chart).lower(), 'excludeTotalDataChartBreakdown': str(exclude_total_data_chart_breakdown).lower() } result = await make_request('GET', f'/api/summary/derivatives/{protocol}', params) return str(result)