# Nami Cross-Venue Mark-Price Spread Scanner

> Nami Cross-Venue Mark-Price Spread Scanner is a paid API for AI agents from api.usenami.io, paid per call via x402, $0.003000/call, status unknown (last checked 2026-09-15).

Scans perpetual futures mark-prices across multiple venues to identify cross-venue price spreads for a given ticker, excluding fees, slippage, and funding differentials.

## Facts

- Endpoint: GET https://api.usenami.io/v1/perp/arbitrage/price
- Price: $0.003000/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-usenami-io-19f363d4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NU9bC2G0ff4TnwdmSrIx2

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-19f363d4
```

Example prompt: Scan across all venues and show me the current mark-price spread for ETH perpetuals — I want to see which exchanges have the widest price gap right now.

## When to prefer this

Use this endpoint when you need a real-time snapshot of mark-price divergence across perpetual futures venues — ideal for identifying raw price-based cross-venue arbitrage candidates. Prefer this over the funding-rate arbitrage scanner when you want price-level spreads rather than rate spreads, and over the top-of-book endpoint when you need a multi-venue comparative view rather than a single venue quote.

## Known failure modes

- Invalid or unsupported ticker symbol returns error
- Missing required 'type' or 'method' fields returns 400 validation error
- No spread data available for illiquid tickers
- Payment failure (402) if x402 USDC payment not provided
- Rate limiting if called too frequently
- Venue data unavailable during maintenance windows

## How this service works

Cross-venue mark-price spread scan for crypto perpetuals — where the same perp trades at different marks across venues. Quoted spread is not net edge: it excludes fees, slippage and funding differences.

## Output

Returns cross-venue mark-price spread data showing price differences across trading venues for a given perpetual futures ticker, including the venues with the highest and lowest mark prices and the spread magnitude in basis points. Note: quoted spread is gross and excludes fees, slippage, and funding rate differentials.

## 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-19f363d4/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)