1gateway
Use when an agent must see who is buying or dumping a Base ERC-20 right now (smart-money / whale flow). Input: token address, optional wallet, minutes (1-60), limit. Output: JSON DEX buys vs sells (Uniswap v2/v3/v4, Aerodrome swaps) with netflow, buy/sell ratio, top buyers and sellers, largest swaps, pools; transfer net buyers/sellers tagged contract/EOA/pool/whale; wallet drill-down. On-chain only. Example: ?address=0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed
Offering
- Provider
- 1gateway.dev
- Method
- GET
- Offering type
- Api Endpoint
- Transport type
- http
- Category
- Other
- Delivery
- Not provided
- Pricing model
- Not provided
- x402 version
- 2
Endpoint context
- URL
https://1gateway.dev/v1/onchain/base/token-flows- MIME type
- application/json
- First seen
- 2026-10-19T02:32:25.008Z
- Last seen
- Tags
- Base, smart-money, whale-tracking, who-bought-sold, token-flows, dex-trades, Onchain
Payment pricing
x402 payment terms are the authoritative price for calling this endpoint.
- Payment option 1
- 0.018 USDC
Atomic price: 18000 · Network: eip155:8453 · Asset: USDC · Scheme: exact - Payment option 2
- 0.018 USDC
Atomic price: 18000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
{
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "18000",
"payTo": "0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1"
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": "18000",
"payTo": "AwV6UZobYPyTdsuNa2NknZZrnmmUoH5ckEv3wNgL26WT"
}
]Observed health
- Status
- Healthy
- Latest latency
- 45 ms
- Average latency
- 410 ms
- HTTP status
- 402
- Last checked
- Reachability
- 100% over 12 checks
Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.
Input schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"type": "string",
"enum": [
"GET"
]
},
"queryParams": {
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "ERC-20 token contract on Base mainnet. EOA → 400, non-ERC-20 → 422 (not charged)",
"pattern": "^0x[0-9a-fA-F]{40}$",
"examples": [
"0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed"
]
},
"minutes": {
"type": "integer",
"description": "Look-back window in minutes (default 60). Very busy tokens are cut short; see window.complete",
"minimum": 1,
"maximum": 60,
"examples": [
60
]
},
"wallet": {
"type": "string",
"description": "Optional wallet to drill into: its received/sent/net and DEX bought/sold in the window",
"pattern": "^0x[0-9a-fA-F]{40}$",
"examples": [
"0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1"
]
},
"limit": {
"type": "integer",
"description": "Rows per list (default 10)",
"minimum": 1,
"maximum": 25,
"examples": [
10
]
}
},
"required": [
"address"
],
"additionalProperties": false
}
},
"required": [
"type",
"method"
],
"additionalProperties": false
}Output schema
{
"type": "object",
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"properties": {
"chain": {
"type": "string"
},
"chainId": {
"type": "integer"
},
"token": {
"type": "object",
"properties": {
"address": {
"type": "string"
},
"symbol": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"decimals": {
"type": "integer"
},
"totalSupply": {
"type": [
"number",
"null"
]
},
"knownIssuer": {
"type": [
"string",
"null"
]
}
}
},
"window": {
"type": "object",
"properties": {
"requestedMinutes": {
"type": "integer"
},
"coveredMinutes": {
"type": "integer"
},
"fromBlock": {
"type": "integer"
},
"toBlock": {
"type": "integer"
},
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"complete": {
"type": "boolean"
},
"reason": {
"type": [
"string",
"null"
]
}
}
},
"summary": {
"type": "object",
"properties": {
"transfers": {
"type": "integer"
},
"transactions": {
"type": "integer"
},
"activeWallets": {
"type": "integer"
},
"netBuyers": {
"type": "integer"
},
"netSellers": {
"type": "integer"
},
"volume": {
"type": "number"
},
"minted": {
"type": "integer"
},
"burned": {
"type": "integer"
}
}
},
"topNetBuyers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"address": {
"type": "string"
},
"isContract": {
"type": [
"boolean",
"null"
]
},
"isDexPool": {
"type": "boolean"
},
"whale": {
"type": "boolean"
},
"net": {
"type": "number"
},
"netPctOfSupply": {
"type": [
"number",
"null"
]
},
"received": {
"type": "number"
},
"sent": {
"type": "number"
},
"transfersIn": {
"type": "integer"
},
"transfersOut": {
"type": "integer"
}
}
}
},
"topNetSellers": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"largestTransfers": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"dex": {
"type": [
"object",
"null"
],
"properties": {
"swapsDetected": {
"type": "integer"
},
"buys": {
"type": "integer"
},
"sells": {
"type": "integer"
},
"buyVolume": {
"type": "number"
},
"sellVolume": {
"type": "number"
},
"netflow": {
"type": "number"
},
"buySellRatio": {
"type": [
"number",
"null"
]
},
"uniqueBuyers": {
"type": "integer"
},
"uniqueSellers": {
"type": "integer"
},
"pools": {
"type": "array",
"items": {
"type": "object",
"properties": {
"address": {
"type": "string"
},
"events": {
"type": "integer"
},
"kind": {
"type": "string"
}
}
}
},
"topBuyers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"address": {
"type": "string"
},
"isContract": {
"type": [
"boolean",
"null"
]
},
"whale": {
"type": "boolean"
},
"bought": {
"type": "number"
},
"sold": {
"type": "number"
},
"net": {
"type": "number"
},
"buys": {
"type": "integer"
},
"sells": {
"type": "integer"
}
}
}
},
"topSellers": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"largestSwaps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tx": {
"type": "string"
},
"block": {
"type": "integer"
},
"time": {
"type": "string"
},
"side": {
"type": "string"
},
"trader": {
"type": "string"
},
"amount": {
"type": "number"
},
"pctOfSupply": {
"type": [
"number",
"null"
]
}
}
}
}
}
},
"smartMoney": {
"type": [
"object",
"null"
],
"properties": {
"signal": {
"type": "string"
},
"flowDirection": {
"type": "object",
"properties": {
"overall": {
"type": "string"
},
"smartMoney": {
"type": "string"
},
"retail": {
"type": "string"
}
}
},
"smartMoneyNet": {
"type": "number"
},
"retailNet": {
"type": "number"
},
"largeWallets": {
"type": "integer"
},
"top10BuyerShareOfBuyVolume": {
"type": [
"number",
"null"
]
},
"buckets": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"notableWallets": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"whoBought": {
"type": "array",
"items": {
"type": "object",
"properties": {
"address": {
"type": "string"
},
"bucket": {
"type": "string"
},
"labels": {
"type": "array",
"items": {
"type": "string"
}
},
"bought": {
"type": "number"
},
"sold": {
"type": "number"
},
"net": {
"type": "number"
},
"netPctOfSupply": {
"type": [
"number",
"null"
]
},
"buys": {
"type": "integer"
},
"sells": {
"type": "integer"
}
}
}
},
"whoSold": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"recentSwaps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tx": {
"type": "string"
},
"block": {
"type": "integer"
},
"time": {
"type": "string"
},
"side": {
"type": "string"
},
"trader": {
"type": "string"
},
"amount": {
"type": "number"
},
"pctOfSupply": {
"type": [
"number",
"null"
]
},
"traderBucket": {
"type": "string"
},
"traderLabels": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"method": {
"type": "string"
}
}
},
"wallet": {
"type": "null"
},
"rpc": {
"type": "object",
"properties": {
"source": {
"type": "string"
},
"kind": {
"type": "string"
},
"requests": {
"type": "integer"
}
}
},
"note": {
"type": "string"
}
},
"required": [
"chain",
"chainId",
"token",
"window",
"summary",
"topNetBuyers",
"topNetSellers",
"largestTransfers",
"dex",
"smartMoney",
"wallet",
"rpc",
"note"
]
}
},
"required": [
"type"
]
}