{"uid":"cap_utmXCIIcEFowDH-FpWUFn","slug":"chainray-kol-trades-4db0a8e8","name":"ChainRay KOL Trades","description":"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.","url":"https://chainray.online/kol-trades","method":"GET","headers":{},"bodySchema":{"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}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"chain":"ethereum","hours":24,"limit":20}}},"response":{"note":"No smart money addresses tracked yet. Smart money addresses are automatically learned from /smart-money and /whale-alerts endpoints. Call those endpoints first to build the address database.","chain":"ethereum","_proof":{"chain":"ethereum","dataHash":"2484b66f34372ad1e8e798cb4905818b8754304a685ef630b33297527f7838dd","blockHash":"0x6040aaca889116b0db975eac682f94cea7acb81ff35117a2ac2d4e5467554bda","chainName":"Ethereum","blockNumber":25342589,"proofVersion":"3.0","blockTimestamp":1781763299,"proofTimestamp":1781763304151},"trades":[],"summary":{"totalBuys":0,"totalSells":0,"netSentiment":"NEUTRAL"},"timestamp":1781763303986,"periodHours":24,"trackedWallets":0}},"exampleRequest":{"chain":"ethereum","hours":24,"limit":20},"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8vDDSOjisA2_k2cri_x63","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns recent trades made by key opinion leaders (KOLs) on a specified blockchain network over a configurable lookback period","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:45:26.070Z","isFirstParty":false}