{"uid":"cap_hiRieT-GozkxU-Jp6de-i","slug":"api-usenami-io-07c2b45c","name":"Nami Multi-Venue Greedy Execution Router","description":"Greedy multi-venue execution route for one crypto perpetual: walks venues in slippage order, allocating up to each venue's depth cap until size_usd is filled. Returns the route, total filled and blended slippage — how a large order splits across CEX and DEX venues. NAIVE: excludes fees.","url":"https://api.usenami.io/v1/orderbook/multi-venue-execution","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string"},"method":{"type":"string"}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"swap","method":"greedy","ticker":"ETH","size_usd":1000},"ticker":"ETH"},"response":{"route":[{"venue":"Binance","best_ask":1729.39,"best_bid":1729.38,"slippage_bps":0.0289,"allocated_usd":10000,"max_fillable_usd":315911.16}],"ticker":"ETH","size_usd":10000,"naive_note":"Naive ranking — best venue selected by lowest precomputed slippage_<N>k. Excludes maker/taker fees, withdrawal cost, funding payment timing, latency, and venue-specific quirks. Use as baseline, not executable signal.","venues_used":1,"unfilled_usd":0,"total_filled_usd":10000,"blended_slippage_bps":0.0289}},"exampleRequest":{"input":{"type":"swap","method":"greedy","ticker":"ETH","size_usd":1000},"ticker":"ETH"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xxEoKjWlg9sQhrIXWZxqz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Walks crypto venues in ascending slippage order, allocating up to per-venue depth caps until a target USD size is filled, returning the optimal route, total filled, and blended slippage (fees excluded).","exampleAgentPrompt":"I need to fill $75,000 worth of ETH-PERP using the greedy multi-venue route — walk venues in slippage order and tell me the full execution route, how much gets filled, and the blended slippage across all venues.","exampleUseCases":null,"resultDescription":"Returns a ranked execution route showing which venues are used, how much USD is allocated to each (up to per-venue depth caps), total filled amount, and a blended slippage figure across all venues. Note: fees are not included in the slippage calculation.","failureModes":["Requested size_usd too large for available cross-venue depth — partial fill returned","Unknown or unsupported ticker symbol — 400 error","Per-venue depth caps too restrictive to fill full size — partial route returned","No venues available for the given symbol at query time","Payment failure or missing x402 payment header — 402 error"],"whenToPreferThis":"Use this endpoint when you need to optimally route a large notional crypto order across multiple venues to minimize blended slippage. Prefer this over the single-venue best execution endpoint when your order size exceeds a single venue's depth or when you want to compare multi-venue vs single-venue execution quality. Best for pre-trade analysis rather than live execution, and when fee-exclusive slippage estimates are sufficient.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:44:11.839Z","isFirstParty":false}