{"tools":[{"type":"function","function":{"name":"desk_read","description":"Descriptive liquidation walls, cascade path, crowd and position distance. Free delayed data without a key. The deprecated compatibility field verdict is wall_in_band, no_wall_in_band or thin_data, never null; proceed, reduce and skip are no longer emitted (contract change, SDK 0.4.1 docs). wall_in_band means the nearest wall on either side is under 1 percent from price, the same distance as flags.liq_distance_pct and the same test as flags.wall_within_1pct; thin_data means no price or no wall data. verdict_long and verdict_short apply that test to the losing-side wall (below for a long, above for a short) at the current price and assumed_leverage, or for your position. confidence is null with confidence_basis unscored until the public ledger scores verdicts. Compatibility metadata includes verdict_side, verdict_long, verdict_short, verdict_other, bias and confidence. The verdict, stop and target fields are deprecated compatibility fields, never advice. verdict is descriptive (wall_in_band, no_wall_in_band or thin_data) and reads the same wall set as the descriptive flags liq_distance_pct, wall_within_1pct and crowd_aligned, which replace it. stop_suggestion and target_suggestion mirror the deprecated plan and render on no customer surface.","parameters":{"type":"object","properties":{"symbol":{"type":"string","description":"Perp pair, e.g. BTCUSDT. See GET /api/desk_read/symbols."},"side":{"type":"string","enum":["long","short"],"description":"Your position side."},"entry":{"type":"number","description":"Your entry price."},"leverage":{"type":"number","description":"Your leverage, e.g. 20."},"ref":{"type":"string","description":"Your agent name, for attribution."}},"required":["symbol"],"additionalProperties":false}}}],"output_example":{"symbol":"BTCUSDT","as_of":1760000000,"price":81300.0,"pull":{"direction":"up","above":{"price":80821.0,"pct":0.9,"usd":286000000},"below":{"price":80335.0,"pct":1.2,"usd":16000000},"ratio":17.88,"source":"band","line":"Bigger wall: above, $286M at $80,821, 0.90% away. Nearest: $16M 1.20% below."},"hurt":null,"cascade":null,"crowd":{"funding_rate":0.0003,"funding_bias":"longs pay","funding_interval_h":null,"oi_change_24h_pct":4.0,"line":"Longs are paying 0.03% per funding interval and open interest is up 4.0% today."},"plan":null,"near":{"above":null,"below":null},"flags":{"liq_distance_pct":0.9,"wall_within_1pct":true,"crowd_aligned":false},"nearest_pair":null,"snapshot_id":"BTCUSDT:1760000000","flags_basis":"liq_distance_pct: the closest wall's distance from price in percent, from one per-side wall set (the near cell, the band wall, or the labeled ladder fallback). wall_within_1pct: that same distance is under one percent. crowd_aligned: the funding side the crowd pays on agrees with the pull direction; null without a funding read. Descriptive, never a recommendation.","hurt_reason":"no_position_given","plan_reason":"no_position_given","verdict":"wall_in_band","verdict_side":"long","bias":"up","verdict_reasons":["wall above at 0.90% ($286M at $80,821), inside 1%"],"verdict_rule":"verdict reads the same wall set as flags: wall_in_band when the nearest wall on either side is under 1 percent from price (the emitted liq_distance_pct), no_wall_in_band when walls exist but none is that close, thin_data when there is no price or no wall data. verdict_long and verdict_short apply the same test to that side's losing-side wall only (below for a long, above for a short) and add the liquidation distance of a hypothetical entry at the current price and assumed_leverage, or of your position when you send one. Descriptive, never a recommendation: proceed, reduce and skip are no longer emitted.","verdict_long":{"verdict":"no_wall_in_band","confidence":null,"confidence_basis":"unscored","reasons":["losing-side wall below at 1.20% ($16M at $80,335), not inside 1%","liquidation is 9.2% away"]},"verdict_short":{"verdict":"wall_in_band","confidence":null,"confidence_basis":"unscored","reasons":["losing-side wall above at 0.90% ($286M at $80,821), inside 1%","liquidation is 9.5% away"]},"verdict_other":null,"assumed_leverage":10.0,"confidence":null,"confidence_basis":"unscored","lang":"en","verdict_label":"Wall inside 1%","stop_suggestion":null,"target_suggestion":null,"deprecated_fields":["verdict","verdict_side","verdict_label","verdict_reasons","verdict_rule","verdict_long","verdict_short","verdict_other","plan","plan_reason","stop_suggestion","target_suggestion"],"deprecated_note":"The verdict, stop and target fields are deprecated compatibility fields, never advice. verdict is descriptive (wall_in_band, no_wall_in_band or thin_data) and reads the same wall set as the descriptive flags liq_distance_pct, wall_within_1pct and crowd_aligned, which replace it. stop_suggestion and target_suggestion mirror the deprecated plan and render on no customer surface.","lines":["Bigger wall: above, $286M at $80,821, 0.90% away. Nearest: $16M 1.20% below.","Longs are paying 0.03% per funding interval and open interest is up 4.0% today."],"text":"Bigger wall: above, $286M at $80,821, 0.90% away. Nearest: $16M 1.20% below.\nLongs are paying 0.03% per funding interval and open interest is up 4.0% today.","ok":true,"access":{"mode":"free","live":false,"delayed":true,"price_usd_per_live_call":0.02},"read_version":"2026.11.03"}}