# Nami Sized-Depth Quote: Hyperliquid BTC Orderbook

> Nami Sized-Depth Quote: Hyperliquid BTC Orderbook 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-13).

Returns best bid/ask plus precomputed slippage at $1K, $5K, and $10K notional for BTC on Hyperliquid

## Facts

- Endpoint: GET https://api.usenami.io/v1/orderbook/depth/aggregate/hyperliquid/BTC
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-usenami-io-a123ce8a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YYkWZrsA89XyKgRefpF03

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-a123ce8a
```

Example prompt: What's the current best bid/ask for BTC on Hyperliquid, and how much slippage should I expect if I trade $1K, $5K, or $10K notional?

## When to prefer this

Use this endpoint when you need a ready-to-use, precomputed slippage estimate for BTC on Hyperliquid at standardized notional tiers ($1K/$5K/$10K) without having to reconstruct the full orderbook yourself. Ideal for execution cost estimation, pre-trade analysis, and routing decisions where speed and simplicity matter over full orderbook depth.

## Known failure modes

- Symbol not found or unsupported on the specified venue — returns 404 or empty result
- Venue (Hyperliquid) temporarily unavailable or rate-limited — returns 503 or timeout
- Orderbook is too thin to compute slippage at requested notional — may return null or partial data
- Payment of $0.01 USDC not received or x402 auth failure — returns 402 Payment Required
- Stale orderbook data if feed latency is elevated — response may carry a staleness warning

## How this service works

Sized-depth quote: best bid/ask + precomputed slippage at $1K/$5K/$10K notional for a venue/symbol. $10K cap protects execution edge per DIS-022.

## Output

A sized-depth quote containing the best bid and ask prices for BTC on Hyperliquid, along with precomputed slippage estimates for $1K, $5K, and $10K notional trade sizes, capped at $10K per the DIS-022 execution edge protection policy.

## Example request

```json
{
 "input": {
  "type": "GET",
  "method": "orderbook/depth/aggregate/hyperliquid/BTC"
 }
}
```

## 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-a123ce8a/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)
