base-web3-m2m-hub

Gas ONLY: live Base Mainnet gas from eth_feeHistory — latest and 10-block average base fee (gwei), priority-fee percentiles (p25/p50/p75) and a congestion label. Use this when you need gas and nothing else; if you also want WETH/USDC pricing, use market-snapshot instead (one cheaper call). Price: 0.0020 USDC per call (first call free).

{
  "type": "object",
  "properties": {},
  "required": []
}

DEX pricing/spread ONLY: WETH/USDC spot price on-chain from Uniswap v3 and Aerodrome v2, with gross spread in bps and which side is cheaper (fees, gas and slippage excluded). Use this for cross-DEX pricing; for expected slippage of a given trade size use pool-slippage; if you also need gas use market-snapshot. Price: 0.0050 USDC per call (premium: always paid).

{
  "type": "object",
  "properties": {
    "pair": {
      "type": "string",
      "description": "Only \"WETH/USDC\" is supported"
    }
  },
  "required": []
}

Large USDC transfers on Base over the most recent blocks (default ~300), from confirmed Transfer logs: amount, sender, receiver, tx hash, block. Price: 0.0050 USDC per call (premium: always paid).

{
  "type": "object",
  "properties": {
    "minUsdcAmount": {
      "type": "number",
      "description": "Minimum transfer size in USDC (min 1000, default 100000)"
    },
    "windowBlocks": {
      "type": "number",
      "description": "Blocks to scan, 25-600 (default 300, ~2s per block)"
    }
  },
  "required": []
}

Aave v3 on Base: available flash-loan liquidity and flash-loan fee for any listed asset (default WETH), read on-chain. Price: 0.0050 USDC per call (premium: always paid).

{
  "type": "object",
  "properties": {
    "asset": {
      "type": "string",
      "description": "ERC-20 address (0x...) of the asset; default WETH"
    }
  },
  "required": []
}

Token risk flags ONLY: for an ERC-20 on Base (honeypot, tax over 10%, mintable, unverified source, hidden owner, pausable...) from GoPlus plus on-chain facts (symbol, supply, owner). No safety verdict; no flags is not a guarantee. For a full check that ALSO adds contract/proxy facts and pool liquidity in one call, use token-due-diligence instead. Price: 0.0050 USDC per call (premium: always paid).

{
  "type": "object",
  "properties": {
    "tokenAddress": {
      "type": "string",
      "description": "ERC-20 token contract address (0x...) on Base"
    }
  },
  "required": [
    "tokenAddress"
  ]
}

Aave v3 on Base: total collateral, debt, health factor and risk band (LIQUIDATABLE / AT_RISK / WATCH / HEALTHY / NO_DEBT) for any wallet. Price: 0.0050 USDC per call (premium: always paid).

{
  "type": "object",
  "properties": {
    "userAddress": {
      "type": "string",
      "description": "Wallet address (0x...) to inspect"
    }
  },
  "required": [
    "userAddress"
  ]
}

Newest Uniswap v3 pools created on Base (PoolCreated events) with token symbols, fee tier and block. A new pool does not imply a legitimate token. Price: 0.0050 USDC per call (premium: always paid).

{
  "type": "object",
  "properties": {
    "windowBlocks": {
      "type": "number",
      "description": "Blocks to scan, 50-3000 (default 1500)"
    },
    "limit": {
      "type": "number",
      "description": "Max pools returned, 1-30 (default 15)"
    }
  },
  "required": []
}

FULL token check (BUNDLE): combines GoPlus risk flags (= liquidity-health) + contract/proxy/owner facts (= contract-profile) + Uniswap v3 pools vs WETH/USDC with quote-side liquidity in USD, in a single call. Objective signals, not a verdict. Use this instead of calling liquidity-health and contract-profile separately; use the individual tools only if you need just one aspect. Price: 0.0100 USDC per call (premium: always paid).

{
  "type": "object",
  "properties": {
    "tokenAddress": {
      "type": "string",
      "description": "ERC-20 token contract address (0x...) on Base"
    }
  },
  "required": [
    "tokenAddress"
  ]
}

Contract structure ONLY: bytecode size, proxy detection (EIP-1167 / EIP-1967 implementation and admin) and owner() for any address on Base. NOT a security audit. For a full token check that also adds risk flags and pool liquidity, use token-due-diligence; to read an arbitrary view function use contract-read. Price: 0.0030 USDC per call (first call free).

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Address (0x...) to inspect"
    }
  },
  "required": [
    "address"
  ]
}

Price of ONE token: on-chain USD spot price for a single ERC-20 on Base, from the deepest Uniswap v3 pool vs USDC/WETH (slot0), with the pool/fee tier used and its USD depth. No off-chain feed; thin pools are easy to manipulate. To price MANY tokens at once, use multi-token-price instead (one cheaper call). Price: 0.0020 USDC per call (first call free).

{
  "type": "object",
  "properties": {
    "tokenAddress": {
      "type": "string",
      "description": "ERC-20 token contract address (0x...) on Base"
    }
  },
  "required": [
    "tokenAddress"
  ]
}

Portfolio of a wallet on Base: native ETH plus a curated set of major ERC-20s (USDC, WETH, cbETH, cbBTC, DAI, USDbC), each valued in USD on-chain via Uniswap v3. Returns per-token amounts, USD values and the total. Price: 0.0040 USDC per call (premium: always paid).

{
  "type": "object",
  "properties": {
    "userAddress": {
      "type": "string",
      "description": "Wallet address (0x...) to inspect"
    }
  },
  "required": [
    "userAddress"
  ]
}

BUNDLE: one-call Base market snapshot combining live gas (base fee, priority-fee percentiles, congestion) AND WETH/USDC spot price + gross spread across Uniswap v3 / Aerodrome. Use this when you want both gas and DEX pricing in a single cheaper call; do NOT also call gas-optimizer or dex-arbitrage for the same purpose. Prefer the individual tools only if you need just one of the two. Price: 0.0060 USDC per call (premium: always paid).

{
  "type": "object",
  "properties": {},
  "required": []
}

Live Aave v3 reserve rates on Base read on-chain: current supply APY and variable borrow APY for any listed asset (default WETH). For yield and borrow-cost bots. Price: 0.0040 USDC per call (premium: always paid).

{
  "type": "object",
  "properties": {
    "asset": {
      "type": "string",
      "description": "ERC-20 address (0x...); default WETH"
    }
  },
  "required": []
}

Price of MANY tokens (BATCH): on-chain USD spot price for up to 15 ERC-20s in one call, each from its deepest Uniswap v3 pool vs USDC/WETH. Tokens with no pool return an error entry. Use this for 2+ tokens; for a single token use token-spot-price (cheaper). Price: 0.0080 USDC per call (premium: always paid).

{
  "type": "object",
  "properties": {
    "tokenAddresses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of ERC-20 addresses (0x...), max 15"
    }
  },
  "required": [
    "tokenAddresses"
  ]
}

Estimated price impact / slippage for a WETH/USDC trade of a given USD size on Uniswap v3, from on-chain pool depth. Order-of-magnitude signal (v3 is concentrated liquidity), useful for MEV/execution bots before trading. Price: 0.0050 USDC per call (premium: always paid).

{
  "type": "object",
  "properties": {
    "tradeSizeUsd": {
      "type": "number",
      "description": "Trade size in USD, 100-5,000,000 (default 10000)"
    }
  },
  "required": []
}

Generic read-only call to any contract on Base: provide an address and hex calldata (4-byte selector, e.g. 0x18160ddd = totalSupply, optionally followed by ABI-encoded args) and get the raw return data plus best-effort uint/address/bool/string decoding. Read-only (never sends a transaction). Use this for arbitrary view functions not covered by a dedicated tool. Price: 0.0030 USDC per call (first call free).

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Contract address (0x...) on Base"
    },
    "data": {
      "type": "string",
      "description": "Hex calldata starting with a 4-byte function selector (e.g. \"0x18160ddd\")"
    }
  },
  "required": [
    "address",
    "data"
  ]
}

Recent event logs for any contract on Base over a bounded recent window (reads eth_getLogs). Optionally filter by topic0 (event signature hash). Returns up to 50 logs with block, tx hash, topics and data. Window is limited by the RPC log-range quota. Use this for generic event queries not covered by whale-wallet-tracker or token-deploy-radar. Price: 0.0050 USDC per call (premium: always paid).

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Contract address (0x...) to read logs from"
    },
    "topic0": {
      "type": "string",
      "description": "Optional 32-byte event signature hash (0x...) to filter by"
    },
    "windowBlocks": {
      "type": "number",
      "description": "Blocks to scan (10-120, default 100)"
    }
  },
  "required": [
    "address"
  ]
}