Token Buyers and Sellers (Who Bought or Sold)

Who bought and who sold a token in the last hours: buy and sell count and USD volume, net flow, buy/sell ratio, the top buyer and seller wallets with net USD, and the largest trades, read from the swap events of its biggest DEX pools (Uniswap v2/v3 style, Aerodrome, Velodrome, PancakeSwap, Trader Joe and more) on Base, Ethereum, BSC, Arbitrum, Polygon, Avalanche or Optimism. Flags one-sided selling and a single wallet dumping. For trading agents before or after a buy. Window 1 to 24 hours.

Run free trial ↗3 free calls per day with the example input. Paid: $0.006 USDC, no limit.

Call it

import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agentsvc.io/api/v1/proxy/token-flows", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({"token":"0x532f27101965dd16442E59d40670FaF5eBB142E4","chain":"base","hours":2}),
});
const { data, payment } = await res.json();  // payment.status "settling"; header X-Payment-Settle: sync returns payment.transaction

Input

Field	Type	Description
token *	string	Token contract address
chain	string	base, ethereum, bsc, arbitrum, polygon, avalanche or optimism. Default base
hours	number = 6	Window in hours, 1 to 24 (shortened on very fast chains)

Output

Field	Type	Description
summary	object
top_buyers	array
top_sellers	array
largest_trades	array
signals	array
pools	array