# ByKaranteli Positioning History

> ByKaranteli Positioning 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-14).

Returns historical positioning data including liquidations, funding rates, open interest, options gamma, ETF flows and CFTC positioning across multiple crypto derivatives venues

## Facts

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

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-positioning-history-aaa52ce5
```

Example prompt: Pull me the last 500 positioning history records for BTCUSDT on Binance from ByKaranteli — I want to see funding rates, liquidations, and open interest in one dataset.

## When to prefer this

Choose this endpoint when you need multi-dimensional historical positioning data — combining liquidations, funding rates, open interest, and CFTC data — in a single call across Binance, Bybit, or OKX. Prefer it over raw liquidation endpoints when you need the aggregated, modeled view rather than individual liquidation events. Best for backtesting, market structure research, or building dashboards that need normalized cross-venue derivatives data without paying for expensive institutional feeds.

## Known failure modes

- Empty rows array if no data matches the given symbol/exchange/date range filters
- Exceeding the max limit of 20000 records may be capped or rejected
- Invalid ISO date format in 'from'/'to' params may cause query failure
- Unsupported exchange name returns no data or error
- Payment failure (402) if x402 payment is not properly submitted

## 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

A JSON object with an 'ok' boolean, a 'rows' array containing historical positioning records (liquidations, funding rates, open interest, gamma, ETF flows, CFTC data), a 'count' integer of returned records, and a 'dataset' field identifying the dataset as 'positioning-history'. Each row reflects snapshot data from up to six venues.

## 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 20000"
      },
      "symbol": {
       "type": "string",
       "description": "string, optional, e.g. BTCUSDT"
      },
      "exchange": {
       "type": "string",
       "description": "string, optional: binance | 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": "positioning-history"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bykaranteli-positioning-history-aaa52ce5/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)