# Nami Multi-Venue Greedy Execution Router

> Nami Multi-Venue Greedy Execution Router is a paid API for AI agents from api.usenami.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

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).

## Facts

- Endpoint: GET https://api.usenami.io/v1/orderbook/multi-venue-execution
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-usenami-io-07c2b45c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hiRieT-GozkxU-Jp6de-i

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-usenami-io-07c2b45c
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Example request

```json
{
 "input": {
  "type": "swap",
  "method": "greedy",
  "ticker": "ETH",
  "size_usd": 1000
 },
 "ticker": "ETH"
}
```

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-usenami-io-07c2b45c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.usenami.io](https://www.zero.xyz/host/api.usenami.io/llms.txt)