{"success":true,"data":{"id":"svc_token_flows_01","slug":"token-flows","name":"Token Buyers and Sellers (Who Bought or Sold)","description":"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.","category":"finance","endpoint":"https://agentsvc.io/api/v1/proxy/token-flows","price_usdc":0.006,"latency_p99_ms":8000,"input_schema":{"type":"object","required":["token"],"properties":{"token":{"type":"string","description":"Token contract address"},"chain":{"type":"string","description":"base, ethereum, bsc, arbitrum, polygon, avalanche or optimism. Default base"},"hours":{"type":"number","default":6,"description":"Window in hours, 1 to 24 (shortened on very fast chains)"}}},"output_schema":{"type":"object","properties":{"summary":{"type":"object"},"top_buyers":{"type":"array"},"top_sellers":{"type":"array"},"largest_trades":{"type":"array"},"signals":{"type":"array"},"pools":{"type":"array"}}},"is_active":true,"provider":"agentsvc.io","tags":["token-flows","who-bought","dex-trades","smart-money","trading-bot"],"method":"POST","example_input":{"token":"0x532f27101965dd16442E59d40670FaF5eBB142E4","chain":"base","hours":2},"price_atomic":"6000","price_display":"$0.006 USDC","try_url":"https://agentsvc.io/api/v1/try/token-flows","try_limit_per_day":3,"info_url":"https://agentsvc.io/api/v1/services/token-flows","page_url":"https://agentsvc.io/services/token-flows","curl_example":"curl -X POST https://agentsvc.io/api/v1/proxy/token-flows -H \"Content-Type: application/json\" -d '{\"token\":\"0x532f27101965dd16442E59d40670FaF5eBB142E4\",\"chain\":\"base\",\"hours\":2}'","status":{"ok":true,"latency_ms":null,"checked_at":null}},"payment":{"protocol":"x402","x402_versions_accepted":[1,2],"scheme":"exact","network":"eip155:8453","network_v1":"base","chain_id":8453,"asset":"USDC","asset_contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","asset_decimals":6,"eip712_domain":{"name":"USD Coin","version":"2","chainId":8453,"verifyingContract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"pay_to":"0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","request_header_v2":"PAYMENT-SIGNATURE","request_header_v1":"X-PAYMENT","requirements_v2":"base64 JSON in the PAYMENT-REQUIRED response header of the 402","requirements_v1":"JSON body of the 402 (accepts[0])","receipt_header":"PAYMENT-RESPONSE (and X-PAYMENT-RESPONSE): base64 JSON with transaction hash","accounts_required":false,"api_keys_required":false,"settlement":"per call, on-chain, after the service succeeded. Failed calls are never charged.","also_accepted":[{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","network_v1":"solana","asset":"USDC","asset_mint":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","pay_to":"5JzPS5qpEwUM1vTC9GG7uqvwJdHzbEwfoPHf2Ki977tg","note":"Solana option is accepts[1] in the 402. The facilitator pays the transaction fee (extra.feePayer); the payer needs only USDC, no SOL."}]},"links":{"catalog":"https://agentsvc.io/api/v1/services","payment_requirements":"https://agentsvc.io/api/v1/payment-requirements","credits":"https://agentsvc.io/api/v1/credits","openapi":"https://agentsvc.io/openapi.json","llms_txt":"https://agentsvc.io/llms.txt","llms_full_txt":"https://agentsvc.io/llms-full.txt","agents_md":"https://agentsvc.io/AGENTS.md","skill_md":"https://agentsvc.io/SKILL.md","status":"https://agentsvc.io/api/v1/status","docs":"https://agentsvc.io/docs","mcp_server":"https://agentsvc.io/mcp-server.mjs","discovery":"https://agentsvc.io/.well-known/x402","agent_card":"https://agentsvc.io/.well-known/agent-card.json"}}