# 1gateway Base Token Flow Analysis > 1gateway Base Token Flow Analysis is a paid API for AI agents from 1gateway.dev, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-30). Retrieves aggregated ERC-20 token transfer flow data for a Base mainnet token over a configurable look-back window, including top net buyers/sellers, largest transfers, and volume summary ## Facts - Endpoint: GET https://1gateway.dev/v1/onchain/base/token-flows?utm_source=zero.xyz - Price: $0.004/call - Payment: x402 - Status: unknown - Last checked: 2026-10-30 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/1gateway-base-token-flow-analysis-78b42801 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TICyEm6121yvDOD-qv2sP 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 1gateway-base-token-flow-analysis-78b42801 ``` Example prompt: Show me the token flow activity for the DEGEN token at 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed on Base over the last 60 minutes — I want to see the top net buyers, top net sellers, and the 10 largest individual transfers. ## When to prefer this Choose this endpoint when you need aggregated buy/sell flow intelligence for a specific Base mainnet ERC-20 token over a recent time window — particularly useful for identifying whale wallets, measuring buy/sell pressure, or detecting unusual transfer activity. Prefer this over raw RPC calls when you need pre-aggregated net buyer/seller rankings and volume summaries without writing custom indexing logic. Use when you need clean JSON output without paying for a full blockchain indexer subscription. Not suitable for historical data beyond 60 minutes or for non-Base chains. ## Known failure modes - 400 error if address is an EOA (externally owned account) rather than a contract — not charged - 422 error if contract exists but is not an ERC-20 token — not charged - No transfers in window returns empty buyer/seller/transfer arrays with zero volume - Very busy tokens may return an incomplete window (window.complete=false) with coveredMinutes less than requestedMinutes - Invalid address format (not matching 0x + 40 hex chars) returns validation error — not charged ## How this service works Use when an agent must see who is accumulating or dumping a Base ERC-20 right now. Input: token address, minutes (1-60, default 60), limit (1-25). Output: JSON top net buyers and sellers (net, received, sent, contract or EOA), largest transfers with tx hash, volume, mints/burns, active wallets, covered window. Busy tokens get a shorter window. Example: ?address=0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed ## Output Returns a JSON object with: chain and chainId (Base/8453), token metadata (name, symbol, address, decimals, totalSupply, knownIssuer), window coverage details (from/to block and timestamp, whether window is complete, minutes covered), summary statistics (volume, transfers, transactions, active wallets, net buyers/sellers count, minted/burned), ranked lists of top net buyers and top net sellers (address, sent, received, net, isContract, transfersIn/Out, netPctOfSupply), and the largest individual transfers (from, to, amount, tx hash, block, time, pctOfSupply). Also includes RPC provenance metadata and an explanatory note. ## 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", "required": [ "address" ], "properties": { "limit": { "type": "integer", "maximum": 25, "minimum": 1, "examples": [ 10 ], "description": "Rows per list (default 10)" }, "address": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$", "examples": [ "0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed" ], "description": "ERC-20 token contract on Base mainnet. EOA → 400, non-ERC-20 → 422 (not charged)" }, "minutes": { "type": "integer", "maximum": 60, "minimum": 1, "examples": [ 60 ], "description": "Look-back window in minutes (default 60). Very busy tokens are cut short; see window.complete" } }, "additionalProperties": false } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object", "required": [ "chain", "chainId", "token", "window", "summary", "topNetBuyers", "topNetSellers", "largestTransfers", "rpc", "note" ], "properties": { "rpc": { "type": "object", "properties": { "kind": { "type": "string" }, "source": { "type": "string" }, "requests": { "type": "integer" } } }, "note": { "type": "string" }, "chain": { "type": "string" }, "token": { "type": "object", "properties": { "name": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "address": { "type": "string" }, "decimals": { "type": "integer" }, "knownIssuer": { "type": [ "string", " … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "rpc": { "kind": "public", "source": "base-rpc.publicnode.com", "requests": 8 }, "note": "Aggregated from ERC-20 Transfer logs. Net = received - sent in the window. isContract=true is usually a pool, router or vault, not a trader. No prices or walle…", "chain": "base", "token": { "name": "Degen", "symbol": "DEGEN", "address": "0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed", "decimals": 18, "knownIssuer": null, "totalSupply": 35997537607.50343 }, "window": { "to": "2026-10-17T08:11:19.000Z", "from": "2026-10-17T07:11:21.000Z", "reason": null, "toBlock": 52717666, "complete": true, "fromBlock": 52715867, "coveredMinutes": 60, "requestedMinutes": 60 }, "chainId": 8453, "summary": { "burned": 0, "minted": 0, "volume": 69814153.75948562, "netBuyers": 61, "transfers": 182, "netSellers": 18, "transactions": 132, "activeWallets": 95 }, "topNetBuyers": [ { "net": 49950, "sent": 950, "address": "0x32c8fd7B11a5185a6ff57bD4f93eedD7b8A9B371", "received": 50900, "isContract": false, "transfersIn": 2, "transfersOut": 2, "netPctOfSupply": 0.0001 } ], "topNetSellers": [ { "net": -50900, "sent": 50900, "address": "0x4e3ae00E8323558fA5Cac04b152238924AA31B60", "received": 0, "isContract": false, "transfersIn": 0, "transfersOut": 2, "netPctOfSupply": 0.0001 } ], "largestTransfers": [ { "to": "0x182dB467327f1dAfb82F87102BaCa028fFfbD2B0", "tx": "0x0cc3ff3d8a468a5e6f591c0598e4c019f72967df2eb893c60e65e8bee8e855d2", "from": "0xc9034c3E7F58003E6ae0C8438e7c8f4598d5ACAA", "time": "2026-10-17T07:33:23.000Z", "block": 52716528, "amount": 28853907.65011959, "pctOfSupply": 0.0801 } ] } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/1gateway-base-token-flow-analysis-78b42801/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from 1gateway.dev](https://www.zero.xyz/host/1gateway.dev/llms.txt)