# ByKaranteli Whale Trades Raw Data

> ByKaranteli Whale Trades Raw Data 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 raw large-trade (whale) prints from crypto derivatives venues, filterable by symbol, exchange, and time range.

## Facts

- Endpoint: GET https://bykaranteli.com/api/x402/whale-trades-raw
- 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-whale-trades-raw-data-ced176bb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_C-atED-2gY8lYVdzbgpxV

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-whale-trades-raw-data-ced176bb
```

Example prompt: Pull the last 500 raw whale trades for BTCUSDT across all exchanges from ByKaranteli so I can see where the big money has been hitting the tape recently.

## When to prefer this

Choose this endpoint when you need raw, unprocessed large-trade prints from crypto derivatives venues for quant research, backtesting, or building real-time dashboards. It covers up to six venues in a single call, supports flexible time-range and symbol filtering, and provides granular trade-level data rather than aggregated summaries. Prefer it over aggregated derivatives APIs when you need tick-level whale flow data at a low per-call cost.

## Known failure modes

- Empty rows array if no trades match the given filters within the time range
- Exceeding the 10000 row limit may truncate or error the response
- Invalid symbol or exchange strings may return empty results without an explicit error
- Malformed ISO timestamps in 'from'/'to' parameters may cause query failures
- Service may return ok:false on internal data pipeline errors

## How this service works

Every $1M+ aggressive market print recorded live from our own trade sockets, with side, price, quantity and notional, kept for 90 days, filterable by symbol, exchange and time. The free endpoint serves the live tape (newest 100 prints, no filters); this route is the recorded archive behind it.

## Output

A JSON object with an 'ok' boolean, a 'rows' array of raw whale trade records (each containing trade details such as symbol, exchange, size, side, and timestamp), a 'count' integer indicating how many records were returned, and a 'dataset' label confirming the data source.

## 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 10000"
      },
      "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": "whale-trades-raw"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bykaranteli-whale-trades-raw-data-ced176bb/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)