get_liquidation_history
Retrieve historical liquidation events from Derive.xyz to analyze market risk and trading patterns using timestamp-based queries.
Instructions
Get historical liquidation events
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| start_timestamp | No | Start timestamp in seconds (default 0) | |
| end_timestamp | No | End timestamp in seconds (default now) | |
| page | No | Page number (default 1) | |
| page_size | No | Results per page (default 100, max 1000) |
Implementation Reference
- src/client.ts:149-151 (handler)The `getLiquidationHistory` method in the `DeriveClient` class implements the tool logic by making a POST request to the `public/get_liquidation_history` API endpoint.
getLiquidationHistory(params: GetLiquidationHistoryParams): Promise<unknown> { return this.post('public/get_liquidation_history', params); } - src/tools.ts:165-175 (registration)The tool `get_liquidation_history` is defined and registered in `src/tools.ts`, including its input schema description and properties.
name: 'get_liquidation_history', description: 'Get historical liquidation events', inputSchema: { type: 'object', properties: { start_timestamp: { type: 'integer', description: 'Start timestamp in seconds (default 0)' }, end_timestamp: { type: 'integer', description: 'End timestamp in seconds (default now)' }, ...paginationParams, }, }, },