# ByKaranteli Minute Bars With Taker Split

> ByKaranteli Minute Bars With Taker Split is a paid API for AI agents from bykaranteli.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns per-minute OHLCV bars with taker-buy versus total quote volume split, pre-joined across venues and retained beyond exchange data retention limits, for order flow imbalance and VPIN analysis.

## Facts

- Endpoint: GET https://bykaranteli.com/api/x402/spot-microstructure
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bykaranteli-minute-bars-with-taker-split-ddcbc969
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NygYig-Qs8qvfLy3CIq8O

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-minute-bars-with-taker-split-ddcbc969
```

Example prompt: Pull the last 500 minute bars with taker buy versus total quote volume split for BTCUSDT across all venues from ByKaranteli's spot microstructure dataset, starting from 2024-06-01 through 2024-06-02.

## When to prefer this

Choose this endpoint when you need minute-level spot market data with taker buy versus total quote volume split pre-joined across multiple venues, especially when the time window extends beyond what individual exchange APIs retain. It eliminates the need to paginate separate exchange APIs per symbol per venue and is the canonical raw input for order flow imbalance, VPIN, and market toxicity research on BTC, ETH, SOL, and other major spot pairs.

## Known failure modes

- Missing required 'symbol' parameter returns empty or error response
- Date range too wide may be silently capped at the per-dataset row limit
- Invalid exchange name may return zero rows without explicit error
- Malformed date strings for 'from'/'to' may cause 400 or empty result
- Limit exceeding dataset cap is silently truncated to maximum allowed rows

## How this service works

Minute bars with the taker buy versus total quote volume split, pre-joined across venues and kept beyond exchange retention: the raw input behind order flow imbalance and VPIN work, in one query instead of paginating an exchange API per symbol per venue.

## Output

A JSON object with ok status, a dataset label ('spot-microstructure'), a count of rows returned, and an array of rows each containing minute-level OHLCV data plus taker buy quote volume and total quote volume, enabling direct computation of taker buy ratio, order flow imbalance, and VPIN metrics.

## 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"
      },
      "exchange": {
       "type": "string",
       "description": "string, optional"
      }
     }
    }
   },
   "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": "spot-microstructure"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bykaranteli-minute-bars-with-taker-split-ddcbc969/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)