# ByKaranteli VPIN Flow Toxicity

> ByKaranteli VPIN Flow Toxicity is a paid API for AI agents from bykaranteli.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns 90-day daily VPIN history with closes, last 500 volume buckets, and a live snapshot for BTC, ETH, or SOL order flow toxicity analysis

## Facts

- Endpoint: GET https://bykaranteli.com/api/x402/flow-vpin
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bykaranteli-vpin-flow-toxicity-bbb9e782
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Y2ME2VG6Qlhl-h1C_Kfb-

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-vpin-flow-toxicity-bbb9e782
```

Example prompt: Pull the full 90-day VPIN history for BTC including daily closes and the last 500 volume buckets so I can assess order flow toxicity trends.

## When to prefer this

Choose this endpoint when you need deep historical VPIN data (90-day daily track + 500 volume buckets) for BTC, ETH, or SOL — especially for backtesting, quantitative analysis, or building a flow toxicity dashboard. For a free live-only snapshot without history, use the public /api/public/flow endpoint instead. Prefer this over generic order book APIs when you specifically need volume-synchronized probability of informed trading (VPIN) methodology.

## Known failure modes

- Unsupported asset symbol returns error (only BTC, ETH, SOL supported)
- Payment failure if x402 USDC payment of $0.002 is not properly submitted
- Rate limiting if too many requests in short succession
- Stale or delayed data if upstream exchange feeds are interrupted

## How this service works

Order flow toxicity (VPIN) HISTORY for BTC, ETH and SOL: 90-day daily VPIN track with closes plus the last 500 volume buckets .

## Output

Returns a JSON payload containing: (1) a live VPIN snapshot, (2) 90 days of daily VPIN values with corresponding price closes, and (3) the last 500 volume buckets used in VPIN computation — all for the requested asset (BTC, ETH, or SOL).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "rows": [
   {
    "vpin": 0.31,
    "symbol": "BTCUSDT",
    "percentile_90d": 62.5
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bykaranteli-vpin-flow-toxicity-bbb9e782/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)