{"uid":"cap_TICyEm6121yvDOD-qv2sP","slug":"1gateway-base-token-flow-analysis-78b42801","name":"1gateway Base Token Flow Analysis","description":"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","url":"https://1gateway.dev/v1/onchain/base/token-flows?utm_source=zero.xyz","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","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","null"]},"totalSupply":{"type":["number","null"]}}},"window":{"type":"object","properties":{"to":{"type":"string"},"from":{"type":"string"},"reason":{"type":["string","null"]},"toBlock":{"type":"integer"},"complete":{"type":"boolean"},"fromBlock":{"type":"integer"},"coveredMinutes":{"type":"number"},"requestedMinutes":{"type":"integer"}}},"chainId":{"type":"integer"},"summary":{"type":"object","properties":{"burned":{"type":"integer"},"minted":{"type":"integer"},"volume":{"type":"number"},"netBuyers":{"type":"integer"},"transfers":{"type":"integer"},"netSellers":{"type":"integer"},"transactions":{"type":"integer"},"activeWallets":{"type":"integer"}}},"topNetBuyers":{"type":"array","items":{"type":"object","properties":{"net":{"type":"number"},"sent":{"type":"number"},"address":{"type":"string"},"received":{"type":"number"},"isContract":{"type":["boolean","null"]},"transfersIn":{"type":"integer"},"transfersOut":{"type":"integer"},"netPctOfSupply":{"type":["number","null"]}}}},"topNetSellers":{"type":"array","items":{"type":"object","properties":{"net":{"type":"number"},"sent":{"type":"number"},"address":{"type":"string"},"received":{"type":"number"},"isContract":{"type":["boolean","null"]},"transfersIn":{"type":"integer"},"transfersOut":{"type":"integer"},"netPctOfSupply":{"type":["number","null"]}}}},"largestTransfers":{"type":"array","items":{"type":"object","properties":{"to":{"type":"string"},"tx":{"type":"string"},"from":{"type":"string"},"time":{"type":"string"},"block":{"type":"integer"},"amount":{"type":"number"},"pctOfSupply":{"type":["number","null"]}}}}}}}}}},"responseSchema":{"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}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VUrEW3oylF2aIOwrOx7Iw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Whale activity alert for trading bot","prompt":"Pull the token flows for the Base ERC-20 at 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed over the last 30 minutes and tell me the top 10 net buyers and sellers — I want to know if any whales are accumulating or dumping."},{"title":"DeFi token launch monitoring","prompt":"Check the transfer activity for the token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base for the last 15 minutes — give me volume, number of active wallets, and the single largest transfers so I can see if there's unusual early activity."},{"title":"Post-announcement sentiment via flow data","prompt":"I just saw a big announcement for a Base token — can you look up the flow data for contract 0x4200000000000000000000000000000000000006 over the past 60 minutes with a limit of 25 rows and tell me whether net buyers or net sellers are dominating?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:47:14.669Z","isFirstParty":false,"canonicalSlug":"1gateway-base-token-flow-analysis-78b42801"}