# TradeSonar Large Trades (Whale Fills)

> TradeSonar Large Trades (Whale Fills) is a paid API for AI agents from api.tradesonar.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-10).

Returns large on-chain trades (whale-sized fills) for a given dYdX market ticker within a configurable lookback window and notional threshold

## Facts

- Endpoint: GET https://api.tradesonar.io/v1/markets/:ticker/large-trades?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tradesonar-large-trades-whale-fills-201a8e91
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_k3KlKJfn9V9s9zFbQd1eQ

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 tradesonar-large-trades-whale-fills-201a8e91
```

Example prompt: Show me all whale-sized fills on BTC-USD from the last 60 minutes where the notional was at least $100,000 — pull up to 200 trades.

## When to prefer this

Use this endpoint when you specifically need to identify large institutional or whale-sized fills on dYdX perpetual markets. It is distinct from general candlestick or order book data because it surfaces individual large trades above a configurable notional threshold, making it ideal for smart money flow analysis, whale tracking, and market impact detection. Prefer it over general OHLCV endpoints when trade-level granularity and notional size filtering matter.

## Known failure modes

- Invalid ticker format (e.g. using BTC-USDT instead of BTC-USD) returns an error — use /v1/markets to validate tickers
- lookback_min exceeding 1440 or below 1 returns a validation error
- limit exceeding 500 returns a validation error
- No trades found matching filters returns an empty list
- Network or payment authentication failure returns a 402 or 5xx error

## How this service works

Large trades (whale-sized fills)

## Output

A list of whale-sized trade fills for the specified market, each record containing details such as trade size, notional value in USD, direction, and timestamp. Results are bounded by the requested lookback window (up to 1440 minutes), minimum notional threshold, and record limit (up to 500).

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "ticker"
     ],
     "properties": {
      "ticker": {
       "type": "string",
       "description": "Market ticker, e.g. BTC-USD (NOT BTC-USDT). See /v1/markets for valid tickers."
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "default": 100,
       "maximum": 500,
       "minimum": 1
      },
      "lookback_min": {
       "type": "integer",
       "default": 60,
       "maximum": 1440,
       "minimum": 1,
       "description": "Lookback window in minutes"
      },
      "min_notional": {
       "type": "number",
       "default": 50000,
       "description": "Minimum trade notional in USD"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradesonar-large-trades-whale-fills-201a8e91/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tradesonar.io](https://www.zero.xyz/host/api.tradesonar.io/llms.txt)