# Orderbook Liquidity API by SYNTHORA

> Orderbook Liquidity API by SYNTHORA is a paid API for AI agents from orderbook-liquidity.hergertsynthora.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns live order book depth, bid/ask walls, spread, and imbalance metrics for any cryptocurrency trading pair

## Facts

- Endpoint: POST https://orderbook-liquidity.hergertsynthora.com/service
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/orderbook-liquidity-api-by-synthora-524c03ab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_j2w4vRcgVe_MkMgvjZcPy

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 orderbook-liquidity-api-by-synthora-524c03ab -d '<json body>'
```

Example prompt: Pull the live order book depth for BTC/USDT with a limit of 50 levels — I want to see the bid and ask walls, the spread, and whether there's any significant imbalance before I place a large order.

## When to prefer this

Use this endpoint when an AI agent needs real-time order book depth and liquidity metrics for crypto execution decisions, slippage estimation, or market microstructure analysis. Prefer it when you need bid/ask walls and imbalance data rather than just a last price or OHLCV data. The free first 3 calls per wallet and no-charge-on-upstream-failure policy makes it low-risk for exploratory use.

## Known failure modes

- Unknown or unsupported trading pair symbol returns an error or empty result
- Upstream exchange feed failure — no charge applied per stated policy
- Invalid limit parameter (non-integer or out-of-range) may return a validation error
- Network timeout or service unavailability returns a 5xx error
- Wallet address missing or malformed in X-WALLET header may block free-tier access

## How this service works

Live order book depth and liquidity (bid/ask walls, spread, imbalance) for any crypto pair. For execution and slippage-aware agents. Free source. $0.01 USDC via x402 on Base. SYNTHORA.

## Output

Returns real-time order book data including bid and ask price levels (walls), best bid/ask spread, and order book imbalance metrics for the requested trading pair, scoped to the specified depth limit. Useful for slippage estimation and execution planning.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "limit"
  },
  "symbol": {
   "type": "string",
   "description": "symbol"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "niche": "orderbook-liquidity",
  "result": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/orderbook-liquidity-api-by-synthora-524c03ab/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from orderbook-liquidity.hergertsynthora.com](https://www.zero.xyz/host/orderbook-liquidity.hergertsynthora.com/llms.txt)