# SqueezeOS Order Flow Imbalance Signal

> SqueezeOS Order Flow Imbalance Signal is a paid API for AI agents from squeezeos-api.onrender.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Computes and returns an order flow imbalance signal from buy and sell volume inputs for AI-driven crypto market intelligence.

## Facts

- Endpoint: POST https://squeezeos-api.onrender.com/v1/market/orderflow-imbalance
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/squeezeos-order-flow-imbalance-signal-5a64a2a3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rZd9hIjHf-PhJMrKRf3Xs

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 squeezeos-order-flow-imbalance-signal-5a64a2a3 -d '<json body>'
```

Example prompt: Calculate the order flow imbalance right now using a buy volume of 84500 and a sell volume of 61200 observed at 2025-01-15T14:30:00Z from the Binance feed — I need to see whether buyers or sellers are dominating.

## When to prefer this

Choose this endpoint when you need a fast, pay-per-call order flow imbalance computation from raw buy/sell volume data for crypto market microstructure analysis. It is best suited for agents that already have volume data and need an AI-scored imbalance metric without maintaining their own quantitative infrastructure. Prefer it over general market data APIs when you specifically need order flow pressure signals rather than price feeds or OHLCV data.

## Known failure modes

- Missing required buy_volume or sell_volume fields returns a 400 validation error
- Non-numeric volume values cause schema rejection
- Payment not included or invalid causes 402 Payment Required response
- Service may be unavailable or cold-starting on Render free tier, causing timeout or 503
- Invalid observed_at timestamp format may cause processing errors
- Extremely large or zero volume values may yield undefined or edge-case signals

## How this service works

SCRIPTMASTERLABS SqueezeOS: agent-native APIs, MCP discovery, verifiable x402 payments, market intelligence, and machine-commerce infrastructure. Truth First. Proof Always. Pay Only for Accepted Delivery.

## Output

Returns a JSON object containing the computed order flow imbalance metric derived from the provided buy and sell volumes, indicating the directional pressure or asymmetry in market order flow. The response schema is open-ended and may include additional AI-derived market intelligence fields.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "source": {
   "type": "string"
  },
  "buy_volume": {
   "type": "number"
  },
  "observed_at": {
   "type": "string"
  },
  "sell_volume": {
   "type": "number"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "imbalance": 0.111111
  },
  "status": "accepted_delivery"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/squeezeos-order-flow-imbalance-signal-5a64a2a3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from squeezeos-api.onrender.com](https://www.zero.xyz/host/squeezeos-api.onrender.com/llms.txt)