{"uid":"cap_U4cvLEh_BxF_eweABPyVr","slug":"api-usenami-io-7086615a","name":"Nami Best Execution Endpoint","description":"Naive single-venue best execution for one crypto perpetual: the venue with the lowest precomputed slippage at your requested size. Excludes fees, funding and latency — a baseline to measure a router against, not a router.","url":"https://api.usenami.io/v1/orderbook/best-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":{"size":10000,"input":{"type":"perpetual","method":"BTC"},"ticker":"BTC"},"response":{"best":{"venue":"Lighter","best_ask":63458.8,"best_bid":63458.7,"spread_bps":0.015758280582489084,"updated_at":"2026-06-12T04:14:38.153359Z","slippage_bps":0.0079,"ask_depth_usd":309898.32,"bid_depth_usd":327531.33},"ticker":"BTC","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_considered":21}},"exampleRequest":{"size":10000,"input":{"type":"perpetual","method":"BTC"},"ticker":"BTC"},"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_BD2OXgvFglzloNT8DFMSv","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":"Returns the single venue with the lowest precomputed slippage for a given order size, providing a naive best-execution baseline across venues.","exampleAgentPrompt":"Which venue has the lowest slippage for a $10,000 perpetual futures order on BTC — just the raw baseline, no fees factored in?","exampleUseCases":null,"resultDescription":"Returns the single venue with the lowest precomputed slippage at the requested notional size. Includes the venue name, slippage figure, and basic execution baseline data. Does not account for trading fees, funding rates, or latency — this is a naive baseline only.","failureModes":["Missing required 'type' or 'method' fields returns a 400 validation error","Unsupported ticker or venue combination returns empty or error response","Payment failure (x402) if USDC balance is insufficient or wallet not configured","Stale orderbook data if snapshots are not recently refreshed","Rate limiting if excessive calls are made in a short window"],"whenToPreferThis":"Use this endpoint when you need a quick, single-winner venue recommendation based purely on slippage at a given order size, without factoring in fees, funding rates, or network latency. Ideal for a fast first-pass routing decision or when building a simplified execution strategy. For multi-venue splitting or fee-adjusted comparison, prefer the greedy multi-venue route or per-venue slippage scan siblings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:54:00.137Z","isFirstParty":false}