live_coin_risk_snapshot
Assess current market risk for any coin: view OI, wallet count, long/short posture, position concentration, top holders, liquidation heatmap, and 7-day liquidation totals.
Instructions
Get the current risk snapshot for a single coin. Use this when a user asks 'is BTC crowded?', 'who is holding the risk?', or 'how liquidation-prone is this market right now?'. Returns OI, wallet count, long/short posture, position-size concentration, top positions, liquidation heatmap, and 7-day liquidation totals.
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 (e.g. xyz:GOLD, km:OIL, cash:TSLA) |
Implementation Reference
- src/index.ts:593-593 (handler)The handler function for the live_coin_risk_snapshot tool. It takes a coin symbol and optional useToonFormat, normalizes the coin symbol, and calls the Coinversa API endpoint /live/risk/coins/{coin} to return the risk snapshot data.
async ({ useToonFormat, coin }) => toolResult(await callAPI(useToonFormat, `/live/risk/coins/${normalizeCoin(coin)}`)) - src/index.ts:588-591 (schema)Input schema for live_coin_risk_snapshot: accepts a coin symbol string and optional useToonFormat boolean.
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 (e.g. xyz:GOLD, km:OIL, cash:TSLA)"), }, - src/index.ts:584-594 (registration)Registration of the live_coin_risk_snapshot tool with the MCP server. It is gated behind shouldRegister() so it is only available with a valid API key (not in the FREE_TIER_TOOLS set).
if (shouldRegister("live_coin_risk_snapshot")) server.registerTool( "live_coin_risk_snapshot", { description: "Get the current risk snapshot for a single coin. Use this when a user asks 'is BTC crowded?', 'who is holding the risk?', or 'how liquidation-prone is this market right now?'. Returns OI, wallet count, long/short posture, position-size concentration, top positions, liquidation heatmap, and 7-day liquidation totals.", 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 (e.g. xyz:GOLD, km:OIL, cash:TSLA)"), }, }, async ({ useToonFormat, coin }) => toolResult(await callAPI(useToonFormat, `/live/risk/coins/${normalizeCoin(coin)}`)) );