# ChainRay KOL Trades

> ChainRay KOL Trades is a paid API for AI agents from chainray.online, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns recent trades made by key opinion leaders (KOLs) on a specified blockchain network over a configurable lookback period

## Facts

- Endpoint: GET https://chainray.online/kol-trades
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainray-kol-trades-4db0a8e8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_utmXCIIcEFowDH-FpWUFn

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 chainray-kol-trades-4db0a8e8
```

Example prompt: Pull the last 48 hours of KOL trades on Solana — give me the top 30 trades so I can see what the influential wallets have been buying.

## When to prefer this

Use this endpoint when you need to surface recent on-chain trading activity specifically from influential or well-known crypto wallets (KOLs) rather than general market data. Ideal for copy-trading signals, social finance analysis, or understanding what notable market participants are doing across specific chains.

## Known failure modes

- Unsupported chain value returns an error or empty result
- Hours value outside 1–168 range may be rejected or clamped
- Payment failure via x402 returns 402 status before data is served
- No KOL trades found in the window returns empty list
- Network timeout if blockchain data indexer is slow

## How this service works

The most complete blockchain data and intelligence service for AI agents. 93 endpoints across 46 chains, from gas fees to DeFi analytics, with real-time streams, intent routing, and verifiable proofs. Pay-per-request via x402.

## Output

A list of recent trades (up to the specified limit) made by key opinion leaders on the chosen blockchain, including trade details such as tokens, amounts, and wallet addresses, covering the specified lookback window (1–168 hours).

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "chain": "ethereum",
   "hours": 24,
   "limit": 20
  }
 }
}
```

## 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": {
      "chain": {
       "type": "string",
       "description": "Blockchain network"
      },
      "hours": {
       "type": "integer",
       "default": 24,
       "description": "Lookback period in hours (1-168)"
      },
      "limit": {
       "type": "integer",
       "default": 20,
       "description": "Max trades to return"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainray-kol-trades-4db0a8e8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainray.online](https://www.zero.xyz/host/chainray.online/llms.txt)