pulse_trader_closed_position_stats
Analyze a trader's closed positions: average hold time, win rate by position, total closed positions, and PnL summary. Determine if the trader is a scalper or swing trader.
Instructions
Get aggregate statistics about a trader's closed positions: average hold duration, win rate by position (not by fill), total positions closed, and PnL summary. Use this to understand how long a trader typically holds and their position-level performance. Answers: 'What is this trader's average hold time?', 'Win rate by position (not by fill)?', 'Is this trader a scalper or swing trader?', 'Average PnL per position?'
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| useToonFormat | No | Return data in compact toon format (default: true). Set to false for standard JSON. | |
| address | Yes | Ethereum wallet address (0x...) |
Implementation Reference
- src/index.ts:886-887 (handler)The handler function for pulse_trader_closed_position_stats. It takes useToonFormat and address parameters, then calls the Coinversa API at /pulse/trader/{address}/closed-positions/stats to return aggregate statistics about a trader's closed positions.
async ({ useToonFormat, address }) => toolResult(await callAPI(useToonFormat, `/pulse/trader/${address}/closed-positions/stats`)) ); - src/index.ts:881-885 (schema)Input schema for pulse_trader_closed_position_stats. Accepts useToonFormat (boolean, default true) for compact toon format, and address (Ethereum address regex-validated).
inputSchema: { useToonFormat: useToonFormatSchema, address: ethAddressSchema, }, }, - src/index.ts:877-887 (registration)Registration of the pulse_trader_closed_position_stats MCP tool. Conditionally registered via shouldRegister() which checks if an API key is present or if the tool is in the free-tier set (it is NOT in FREE_TIER_TOOLS, so it requires an API key).
if (shouldRegister("pulse_trader_closed_position_stats")) server.registerTool( "pulse_trader_closed_position_stats", { description: "Get aggregate statistics about a trader's closed positions: average hold duration, win rate by position (not by fill), total positions closed, and PnL summary. Use this to understand how long a trader typically holds and their position-level performance. Answers: 'What is this trader's average hold time?', 'Win rate by position (not by fill)?', 'Is this trader a scalper or swing trader?', 'Average PnL per position?'", inputSchema: { useToonFormat: useToonFormatSchema, address: ethAddressSchema, }, }, async ({ useToonFormat, address }) => toolResult(await callAPI(useToonFormat, `/pulse/trader/${address}/closed-positions/stats`)) );