# ByKaranteli Orderbook History

> ByKaranteli Orderbook History is a paid API for AI agents from bykaranteli.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Retrieves historical orderbook-derived data (liquidations, funding rates, open interest, and more) for crypto perpetual futures across major exchanges.

## Facts

- Endpoint: GET https://bykaranteli.com/api/x402/orderbook-history
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bykaranteli-orderbook-history-c03c508c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Cv2BorW0ISJ8RW_C4aoGz

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 bykaranteli-orderbook-history-c03c508c
```

Example prompt: Pull me the last 500 rows of orderbook history for BTC on Binance from ByKaranteli — I want to see the liquidation and funding rate data from January 1st to January 31st 2025.

## When to prefer this

Choose this endpoint when you need structured historical time-series data combining orderbook-derived metrics (liquidations, funding, open interest) across major crypto venues in a single queryable API, especially when you need to filter by specific symbol, exchange, or date range with up to 5000 rows per call. Prefer this over raw liquidation endpoints when you want aggregated/modeled data rather than individual event prints.

## Known failure modes

- Empty rows array if no data exists for the specified symbol/exchange/date range
- Invalid exchange name returns an error or empty result
- Date range too broad may be capped at 5000 rows limit
- Invalid ISO date format for 'from'/'to' parameters may cause query failure
- Symbol not supported on the specified exchange returns no rows
- Payment failure (non-2xx) if x402 payment of 0.005 USDC is not completed

## How this service works

Six-venue liquidation model with real liquidation prints overlaid, funding rates, open interest, options gamma, ETF flows and CFTC positioning. Free.

## Output

Returns a JSON object with an 'ok' boolean status, a 'rows' array containing historical orderbook records (liquidations, funding rates, open interest, and related derivatives data), a 'count' integer indicating how many rows were returned, and a 'dataset' field identifying the data source as 'orderbook-history'.

## 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",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "to": {
       "type": "string",
       "description": "iso, optional"
      },
      "from": {
       "type": "string",
       "description": "iso, optional"
      },
      "limit": {
       "type": "number",
       "description": "number, optional, max 5000"
      },
      "symbol": {
       "type": "string",
       "description": "string, optional, e.g. BTC"
      },
      "exchange": {
       "type": "string",
       "description": "string, optional venue: binance | coinbase | kraken | bybit | okx"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "rows": [],
  "count": 500,
  "dataset": "orderbook-history"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bykaranteli-orderbook-history-c03c508c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bykaranteli.com](https://www.zero.xyz/host/bykaranteli.com/llms.txt)