{"slug":"api-tradebot-devs-surf-v1-pre-trade-execution-gate-bf3e88","title":"Check execution risk before placing a crypto trade","host":"api.tradebot.devs.surf","method":"POST","resource":"https://api.tradebot.devs.surf/v1/pre-trade-execution-gate","category":"code","description":"Check execution risk before placing a crypto trade. Submit a visible order book, trade side and notional; receive PASS, CAUTION or AVOID with estimated slippage, spread, fill ratio, visible liquidity and depth utilization. Built for autonomous trading agents that need a fast pre-trade liquidity and ","price_listed":0.02,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"asset":"BTC","book":{"asks":[[63000.5,0.1],[63001,0.1],[63001.5,0.1],[63002,0.1],[63002.5,0.1],[63003,0.1],[63003.5,0.1],[63004,0.1],[63004.5,0.1],[63005,0.1],[63005.5,0.1],[63006,0.1],[63006.5,0.1],[63007,0.1],[63007.5,0.1],[63008,0.1],[63008.5,0.1],[63009,0.1],[63009.5,0.1],[63010,0.1],[63010.5,0.1],[63011,0.1],[63011.5,0.1],[63012,0.1],[63012.5,0.1]],"bids":[[63000,0.1],[62999.5,0.1],[62999,0.1],[62998.5,0.1],[62998,0.1],[62997.5,0.1],[62997,0.1],[62996.5,0.1],[62996,0.1],[62995.5,0.1],[62995,0.1],[62994.5,0.1],[62994,0.1],[62993.5,0.1],[62993,0.1],[62992.5,0.1],[62992,0.1],[62991.5,0.1],[62991,0.1],[62990.5,0.1],[62990,0.1],[62989.5,0.1],[62989,0.1],[62988.5,0.1],[62988,0.1]],"symbol":"BTCUSDT"},"caller_data":true,"notional_usd":1000,"provenance":{"caller_authorized_use":true,"latest_data_at":"2026-10-20T09:39:04.093704Z","source_label":"caller-market-data-feed"},"side":"buy"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"allOf":[{"if":{"properties":{"asset":{"const":"BTC"}},"required":["asset"]},"then":{"properties":{"book":{"properties":{"symbol":{"const":"BTCUSDT"}}}}}},{"if":{"properties":{"asset":{"const":"ETH"}},"required":["asset"]},"then":{"properties":{"book":{"properties":{"symbol":{"const":"ETHUSDT"}}}}}},{"if":{"properties":{"asset":{"const":"BNB"}},"required":["asset"]},"then":{"properties":{"book":{"properties":{"symbol":{"const":"BNBUSDT"}}}}}},{"if":{"properties":{"asset":{"const":"SOL"}},"required":["asset"]},"then":{"properties":{"book":{"properties":{"symbol":{"const":"SOLUSDT"}}}}}},{"if":{"properties":{"asset":{"const":"XRP"}},"required":["asset"]},"then":{"properties":{"book":{"properties":{"symbol":{"const":"XRPUSDT"}}}}}},{"if":{"properties":{"asset":{"const":"DOGE"}},"required":["asset"]},"then":{"properties":{"book":{"properties":{"symbol":{"const":"DOGEUSDT"}}}}}},{"if":{"properties":{"asset":{"const":"ADA"}},"required":["asset"]},"then":{"properties":{"book":{"properties":{"symbol":{"const":"ADAUSDT"}}}}}},{"if":{"properties":{"asset":{"const":"LINK"}},"required":["asset"]},"then":{"properties":{"book":{"properties":{"symbol":{"const":"LINKUSDT"}}}}}}],"properties":{"asset":{"enum":["BTC","ETH","BNB","SOL","XRP","DOGE","ADA","LINK"],"title":"Asset","type":"string"},"book":{"additionalProperties":false,"properties":{"asks":{"items":{"items":{"type":"number"},"minItems":2,"prefixItems":[{"exclusiveMinimum":0,"type":"number"},{"exclusiveMinimum":0,"type":"number"}],"type":"array"},"minItems":25,"title":"Asks","type":"array"},"bids":{"items":{"items":{"type":"number"},"minItems":2,"prefixItems":[{"exclusiveMinimum":0,"type":"number"},{"exclusiveMinimum":0,"type":"number"}],"type":"array"},"minItems":25,"title":"Bids","type":"array"},"symbol":{"title":"Symbol","type":"string"}},"required":["symbol","bids","asks"],"title":"ExecutionBook","type":"object"},"caller_data":{"const":true,"title":"Caller Data","type":"boolean"},"notional_usd":{"maximum":1000000,"minimum":10,"title":"Notional Usd","type":"number"},"provenance":{"additionalProperties":false,"properties":{"caller_authorized_use":{"const":true,"title":"Caller Authorized Use","type":"boolean"},"latest_data_at":{"format":"date-time","pattern":"Z$","title":"Latest Data At","type":"string"},"source_label":{"maxLength":120,"minLength":1,"pattern":"^[^\\x00-\\x1F]*[^\\s\\x00-\\x1F][^\\x00-\\x1F]*$","title":"Source Label","type":"string"}},"required":["source_label","latest_data_at","caller_authorized_use"],"title":"ExecutionProvenance","type":"object"},"side":{"enum":["buy","sell"],"title":"Side","type":"string"}},"required":["asset","side","notional_usd","caller_data","provenance","book"],"title":"ExecutionRiskRequest","type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"additionalProperties":false,"properties":{"asset":{"type":"string"},"avg_fill_price":{"type":"number"},"capability":{"const":"pre_trade_execution_gate","type":"string"},"decision":{"enum":["PASS","CAUTION","AVOID"],"type":"string"},"decision_scope":{"const":"visible_orderbook_execution_admissibility_only","type":"string"},"depth_utilization_ratio":{"type":"number"},"disclaimer":{"type":"string"},"execution_authorized":{"const":false,"type":"boolean"},"execution_risk_level":{"enum":["low","moderate","high","insufficient_depth"],"type":"string"},"fill_ratio":{"type":"number"},"full_fill":{"type":"boolean"},"limitations":{"items":{"type":"string"},"type":"array"},"market_type":{"const":"caller_supplied_visible_orderbook","type":"string"},"policy":{"additionalProperties":false,"properties":{"mapping":{"additionalProperties":false,"properties":{"high":{"const":"AVOID","type":"string"},"insufficient_depth":{"const":"AVOID","type":"string"},"low":{"const":"PASS","type":"string"},"moderate":{"const":"CAUTION","type":"string"}},"required":["low","moderate","high","insufficient_depth"],"type":"object"},"version":{"type":"string"}},"required":["version","mapping"],"type":"object"},"reason":{"type":"string"},"requested_notional_usd":{"type":"number"},"runtime_permission":{"const":"NO","type":"string"},"side":{"enum":["buy","sell"],"type":"string"},"slippage_bps":{"type":"number"},"source":{"additionalProperties":false,"properties":{"caller_authorized_use":{"const":true,"type":"boolean"},"depth_levels":{"minimum":25,"type":"integer"},"endpoint":{"const":"caller_payload","type":"string"},"observed_at":{"format":"date-time","type":"string"},"provider":{"const":"caller_supplied","type":"string"},"source_label":{"maxLength":120,"minLength":1,"type":"string"}},"required":["provider","endpoint","observed_at","depth_levels","source_label","caller_authorized_use"],"type":"object"},"spread_bps":{"type":"number"},"status":{"const":"OK","type":"string"},"symbol":{"type":"string"},"venue":{"const":"caller_supplied","type":"string"},"visible_side_depth_usd":{"type":"number"},"worst_fill_price":{"type":"number"}},"required":["status","capability","decision","decision_scope","reason","asset","symbol","venue","market_type","side","requested_notional_usd","full_fill","fill_ratio","spread_bps","slippage_bps","avg_fill_price","worst_fill_price","visible_side_depth_usd","depth_utilization_ratio","execution_risk_level","source","policy","execution_authorized","limitations","disclaimer","runtime_permission"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"Check execution risk before placing a crypto trade. Submit a visible order book, trade side and notional; receive PASS, CAUTION or AVOID with estimated slippage, spread, fill ratio, visible liquidity and depth utilization. Built for autonomous trading agents that need a fast pre-trade liquidity and execution-risk check. Read-only: never places orders, accesses exchange accounts or gives investment advice.","last_updated":"2026-10-20T11:39:38.233Z","schemes":["exact"]}