Base mainnet reads — blocks, gas, balances, transactions, Chainlink prices — settled in USDC on Base, no API key.
Running or renting a Base node means keys, quotas and a provider dashboard before an agent reads a single block. Every route below answers a plain HTTP request and returns the same shape a node would — block number, gas price (with a USD estimate ETH-only providers skip), balances, transactions, receipts with the full L1 fee breakdown, contract and EIP-1967 proxy inspection, and Chainlink spot prices read straight from the aggregators — paid per call in USDC on Base, no key to store. Discover and wire the whole set from one file: the x402 catalog, the OpenAPI spec, or the plain-text catalog.
| Route | Price | What it returns | Try free |
|---|---|---|---|
GET /chain/block-number | $0.002 | Current Base mainnet block number. | free preview |
GET /chain/allowance | $0.002 | ERC-20 allowance(owner, spender) on Base, raw + formatted, flags unlimited approvals. | — |
GET /chain/balance | $0.002 | ETH balance of a Base mainnet address, incl. balance_usd (internal ETH price cross-call). | — |
GET /chain/blob-base-fee | $0.004 | Base EIP-4844 blob base fee from the GasPriceOracle (wei/gwei). Use when an agent estimates L1 data-availability cost for Base batches. | — |
GET /chain/block | $0.002 | Base block summary by number or latest: hash, timestamp, tx count, gas used/limit, base fee. | — |
GET /chain/btc-usd | $0.001 | Base BTC/USD spot price from the Chainlink aggregator (price, round, updatedAt, staleness). Use when an agent needs a trusted on-chain BTC price. | — |
GET /chain/code | $0.002 | Contract-code check for a Base mainnet address (is_contract + code size + EIP-7702 delegated-EOA detection). | — |
GET /chain/erc20-meta | $0.002 | ERC-20 metadata on Base: name, symbol, decimals, totalSupply for any token contract. | — |
GET /chain/eth-usd | $0.001 | Base ETH/USD spot price from the Chainlink aggregator (price, round, updatedAt, staleness). Use when an agent needs a trusted on-chain ETH price. | — |
GET /chain/fee-estimate | $0.004 | Base EIP-1559 fee estimate: base fee, suggested priority fee, max-fee tiers (slow/standard/fast) in gwei and a 21k-gas transfer cost. | — |
GET /chain/fee-history | $0.004 | Base fee history for the last 10 blocks: base fee per block (gwei), gas-used ratios and a min/max/avg summary. Use when an agent times transactions around cheap blocks. | — |
GET /chain/gas-price | $0.002 | Current Base mainnet gas price (wei/gwei), EIP-1559 base_fee_gwei/priority_fee_gwei, and gas_price_usd — no price oracle on ETH-only competitors. | free preview |
GET /chain/is-contract | $0.002 | Is a Base address a smart contract or an EOA (is_contract + bytecode size). | — |
GET /chain/l1-base-fee | $0.004 | Ethereum L1 base fee as seen by Base's GasPriceOracle (wei/gwei) plus estimated L1 data fee for a simple transfer. | — |
GET /chain/link-usd | $0.001 | Base LINK/USD spot price from the Chainlink aggregator (price, round, updatedAt, staleness). Use when an agent needs a trusted on-chain LINK price. | — |
GET /chain/network-status | $0.004 | Base network status snapshot: chain id, latest block, block age, gas used ratio and tx count. | — |
GET /chain/nonce | $0.002 | Transaction count (nonce) for a Base address, latest and pending. | — |
GET /chain/prices | $0.001 | Base crypto price snapshot in one call: BTC, ETH, LINK and SOL USD spot from Chainlink aggregators with per-feed staleness. Use when an agent needs a multi-asset trusted on-chain price board. | — |
GET /chain/proxy-info | $0.002 | EIP-1967 proxy resolver for a Base contract: returns implementation, admin and beacon addresses (read from the standard storage slots) plus is_proxy flag. Use when an agent must know what code actually runs behind a proxy before trusting or calling it. | — |
GET /chain/receipt | $0.005 | Transaction receipt by hash on Base mainnet — status, gas used, full logs, and the L1 fee breakdown (l1_fee_wei, l1_gas_price_wei, l1_gas_used, effective_gas_price_wei) + l1_fee_usd/total_fee_usd an ETH-only competitor can't offer. | — |
GET /chain/simulate | $0.005 | Will this Base transaction revert? Prospective-tx dry-run via eth_simulateV1: pass ?from=&to=&data=&value= and get will_revert + revert_reason + gas_used + token asset_changes BEFORE the agent spends gas sending it. Keyless, Base-native, per-call — Tenderly/Alchemy-class output with no API key or signup. Use before a swap/approve/transfer or alongside /gate/swap. | free preview |
GET /chain/sol-usd | $0.001 | Base SOL/USD spot price from the Chainlink aggregator (price, round, updatedAt, staleness). Use when an agent needs a trusted on-chain SOL price. | — |
GET /chain/storage-at | $0.002 | Raw storage slot read (eth_getStorageAt) for any Base contract; slot defaults to 0x0. Use when an agent needs proxy implementation/admin slots or raw contract state. | — |
GET /chain/token-balance | $0.002 | ERC-20 token balance of a Base mainnet address, incl. symbol, decimals, balance_formatted. | free preview |
GET /chain/token-report | $0.01 | Is this Base token safe to buy? One call returns a trade-safety verdict — SAFE | CAUTION | AVOID — with risk_score (0-100) and reasons: honeypot/sellability simulation, owner-renounced + mint/pause/blacklist/fee-setter/upgradeable-proxy checks, measured transfer tax, symbol/name/decimals, and Uniswap v3 WETH-pool liquidity (USD). Replaces many RPC calls and prevents a bad trade before an agent buys a Base ERC-20. | free preview |
GET /chain/token-security | $0.009 | Is this Base token a scam or rug pull? Honeypot detector for a Base ERC-20: EIP-1967 proxy + upgradeability check, bytecode scan for mint/pause/blacklist/fee-setter/ownership, owner() renouncement, contract source-verification (Sourcify), and a live eth_call state-override sim proving a real wallet can transfer() it. Returns risk_score (0-100) + verdict (clear/review/block) + honeypot/scam/rug flags. Use before an agent buys, holds or approves a token. | free preview |
GET /chain/total-supply | $0.002 | ERC-20 total supply on Base (raw + formatted, with symbol and decimals). | — |
GET /chain/tx | $0.005 | Transaction details by hash on Base mainnet. | — |
GET /chain/wallet | $0.003 | Wallet screening bundle (balance, activity, contract vs EOA check): ETH balance + balance_usd (internal ETH price cross-call) + tx count + contract-code check (EIP-7702 delegated-EOA aware) for a Base mainnet address, in one call. | — |
GET /chain/wallet-screen | $0.004 | Is this wallet sanctioned OR a known scammer? Pre-trade screen for a counterparty / recipient / token-spender address before an agent sends, swaps or approves: exact match against the U.S. Treasury OFAC SDN crypto-address list AND community scam/phishing/wallet-drainer threat-intel (ScamSniffer + MEW darklist). Returns sanctioned (bool) + malicious (bool) + verdict (blocked/clear) + lists + the list sources and snapshot dates. 'clear' means not on these lists, not a safety guarantee. Use alongside /gate/swap and /chain/token-security to avoid sanctioned-or-scammer-counterparty liability. | — |
Prices are per successful call in USDC on Base (eip155:8453). Routes with a free preview return the same JSON shape without payment so an agent can evaluate before it pays.
Point any x402-aware client at a route. The first response carries the price and payment terms; the client pays and retries; the second response is the data. With the x402-fetch wrapper it is one line:
import { wrapFetch } from "x402-fetch";
const fetchPaid = wrapFetch(fetch, { account }); // your agent's Base wallet
const r = await fetchPaid("https://api.greyridgesignals.ai/chain/gas-price");
const gas = await r.json(); // Base gas price + USD estimate, paid inline
No API key is sent or stored. Settlement is a standard USDC transfer the route verifies on-chain before returning data.
The 402 challenge offers native USDC on 3 networks — Base, Polygon or Arbitrum — so an agent holding USDC on any of them settles without bridging. Each offer in accepts[] carries the matching chain id and USDC contract; Base is listed first. Pick whichever network your wallet already funds.
For high-frequency polling, open a session once with a single USDC payment up to a cap, then call any paid route with just the returned session token — no EIP-712 signature per call. Each call debits the cap until it runs out. Open a cap at POST /x402/session (tiers $0.05 / $0.50 / $5.00), check the remaining balance any time at the free GET /x402/session/status. This removes the per-call signing round-trip for agents that make many requests in a row.
These are live Base mainnet reads, not a cached mirror: gas and fee routes carry EIP-1559 base/priority split and a USD cost, /chain/receipt returns the L1 data-fee breakdown an ETH-only RPC cannot, and /chain/proxy-info resolves what code actually runs behind a proxy before an agent trusts it. One keyless rail, priced per read.