live_coin_risk_history
Retrieve historical risk metrics for a coin to analyze how positions evolved and whether smart money rotated before price moves.
Instructions
Get the historical risk lane for a coin. Best for questions like 'how did this setup become fragile?' or 'did smart money rotate before the move?'. Returns hourly OI, long/short history, cohort rotation, candle data, mark/oracle dislocation history when available, and liquidation counts over time.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| useToonFormat | No | Return data in compact toon format (default: true). Set to false for standard JSON. | |
| coin | Yes | Coin symbol (e.g. BTC, ETH, SOL). For builder dex markets use prefix:COIN | |
| hours | No | Number of hours of history to return (default 168 = 7 days, max 720 = 30 days) |
Implementation Reference
- src/index.ts:599-611 (registration)Registration of the 'live_coin_risk_history' tool via server.registerTool(). Defines input schema (useToonFormat, coin, hours) and maps to API endpoint /live/risk/coins/{coin}/history.
if (shouldRegister("live_coin_risk_history")) server.registerTool( "live_coin_risk_history", { description: "Get the historical risk lane for a coin. Best for questions like 'how did this setup become fragile?' or 'did smart money rotate before the move?'. Returns hourly OI, long/short history, cohort rotation, candle data, mark/oracle dislocation history when available, and liquidation counts over time.", inputSchema: { useToonFormat: useToonFormatSchema, coin: z.string().min(1).max(20).describe("Coin symbol (e.g. BTC, ETH, SOL). For builder dex markets use prefix:COIN"), hours: z.number().min(1).max(720).default(168).describe("Number of hours of history to return (default 168 = 7 days, max 720 = 30 days)"), }, }, async ({ useToonFormat, coin, hours }) => toolResult(await callAPI(useToonFormat, `/live/risk/coins/${normalizeCoin(coin)}/history`, { hours: String(hours) })) ); - src/index.ts:603-608 (schema)Input schema for the tool: coin (string, required), hours (number, default 168, max 720), and useToonFormat (boolean, default true).
inputSchema: { useToonFormat: useToonFormatSchema, coin: z.string().min(1).max(20).describe("Coin symbol (e.g. BTC, ETH, SOL). For builder dex markets use prefix:COIN"), hours: z.number().min(1).max(720).default(168).describe("Number of hours of history to return (default 168 = 7 days, max 720 = 30 days)"), }, }, - src/index.ts:609-611 (handler)Handler function that calls the Coinversa API at /live/risk/coins/{coin}/history with hours parameter, using the shared callAPI helper to fetch data and toolResult to format the response.
async ({ useToonFormat, coin, hours }) => toolResult(await callAPI(useToonFormat, `/live/risk/coins/${normalizeCoin(coin)}/history`, { hours: String(hours) })) );