# Nami Aggregated Order Book - Best Bid/Ask for BTC

> Nami Aggregated Order Book - Best Bid/Ask for BTC is a paid API for AI agents from api-internal.usenami.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns the best aggregated bid and ask prices for BTC across all trading venues

## Facts

- Endpoint: GET https://api-internal.usenami.io/v1/orderbook/aggregate/BTC
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-internal-usenami-io-82acdfd3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XWRRX3xXucy5LLNuGwoIi

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-internal-usenami-io-82acdfd3
```

Example prompt: What's the best aggregated bid and ask for BTC right now across all venues on Nami?

## When to prefer this

Use this endpoint when you need the best available BTC bid/ask price across all venues simultaneously, rather than checking a single exchange. Ideal for smart order routing, pre-trade analysis, arbitrage detection, or when you need to know the true market-wide best price. Prefer over single-venue top-of-book endpoints when cross-venue aggregation matters.

## Known failure modes

- Symbol not found or unsupported — returns 404 or error indicating invalid symbol
- No venues available or all venues unresponsive — may return empty or stale data
- Payment not provided or insufficient — x402 payment required error
- Rate limit exceeded — too many requests in a short window
- Internal aggregation failure — 500 error if upstream venue data unavailable

## How this service works

Best bid/ask aggregated across all venues

## Output

Returns the best (highest) bid and best (lowest) ask prices for BTC aggregated across all trading venues, effectively giving the tightest possible spread available in the market at that moment.

## Example request

```json
{
 "input": {
  "type": "GET",
  "method": "aggregate_orderbook"
 }
}
```

## 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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "symbol",
  "best_ask",
  "best_bid"
 ],
 "properties": {
  "symbol": {
   "type": "string"
  },
  "best_ask": {
   "type": "object",
   "required": [
    "size",
    "price",
    "venue"
   ],
   "properties": {
    "size": {
     "type": "number"
    },
    "price": {
     "type": "number"
    },
    "venue": {
     "type": "string"
    }
   }
  },
  "best_bid": {
   "type": "object",
   "required": [
    "size",
    "price",
    "venue"
   ],
   "properties": {
    "size": {
     "type": "number"
    },
    "price": {
     "type": "number"
    },
    "venue": {
     "type": "string"
    }
   }
  }
 }
}
```

## More

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