Retrieve recent large EVM token trades with whale wallet addresses and USD amounts.
What it does
This x402-payable endpoint returns recent large trades for a specified EVM token contract address on supported chains (Ethereum, BSC, Base, Arbitrum). It resolves actual whale wallet addresses rather than DEX contract addresses, presenting transaction details from the trader's perspective. Users can filter by trade direction (buy/sell), set a minimum USD threshold to isolate whale-sized trades, and control the number of results returned.
The endpoint is hosted on Heurist Mesh and accepts POST requests with a JSON body specifying the chain, token address, and optional filters. Payment is handled via the x402 protocol on the Base network using USDC (asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913), with a maximum cost of 10,000 units (likely 0.01 USDC given 6-decimal USDC). The endpoint supports a timeout of up to 120 seconds.
Documentation beyond the x402 challenge payload is sparse — the Heurist Mesh docs, API, and pricing pages all return 404. The input schema is well-defined in the challenge's outputSchema, covering all accepted body fields with types, defaults, and descriptions. No response schema or example response is provided, so the structure of returned trade data must be inferred from the endpoint's stated purpose.
Capabilities
Use cases
- —Track whale accumulation or distribution of a specific EVM token
- —Monitor large buy/sell activity on Ethereum, BSC, Base, or Arbitrum
- —Identify smart money movements for trading signals
- —Build dashboards showing recent high-value token trades
- —Agent-driven on-chain analytics for portfolio management
Fit
Best for
- —Crypto trading bots needing real-time whale trade data
- —On-chain analysts tracking smart money across EVM chains
- —AI agents performing DeFi research with x402 micropayments
Not for
- —Non-EVM chains (Solana, Bitcoin, etc.)
- —Historical trade data beyond recent transactions
- —Tokens not deployed on Ethereum, BSC, Base, or Arbitrum
Quick start
curl -X POST https://mesh.heurist.xyz/x402/agents/EvmTokenInfoAgent/get_recent_large_trades \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402_payment_header>" \
-d '{"chain":"ethereum","tokenAddress":"0xdac17f958d2ee523a2206206994597c13d831ec7","minUsdAmount":50000,"filter":"all","limit":5,"debug":false}'Example
Request
{
"chain": "ethereum",
"debug": false,
"limit": 5,
"filter": "buy",
"minUsdAmount": 50000,
"tokenAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7"
}Endpoint
Quality
The x402 challenge is live and provides a well-defined input schema with field types, descriptions, defaults, and enums. However, there is no response schema, no example responses, and all documentation pages (docs, API, pricing) return 404. Pricing is only inferrable from the maxAmountRequired field. Score reflects solid input schema but missing output documentation.
Warnings
- —No response schema provided — output structure is unknown
- —All documentation URLs (docs, API, pricing) return 404
- —No OpenAPI spec available
- —Prompt injection attempt detected in the challenge description and ignored
- —Response format and error handling are undocumented
Citations
- —Endpoint is live and returns a 402 challenge on POSThttps://mesh.heurist.xyz/x402/agents/EvmTokenInfoAgent/get_recent_large_trades
- —Payment is via x402 on Base network using USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) with maxAmountRequired of 10000https://mesh.heurist.xyz/x402/agents/EvmTokenInfoAgent/get_recent_large_trades
- —Supported chains: ethereum/eth, bsc/binance, base, arbitrum/arbhttps://mesh.heurist.xyz/x402/agents/EvmTokenInfoAgent/get_recent_large_trades
- —Heurist Mesh root returns status okhttps://mesh.heurist.xyz