santyvv-x402.santyvv1993.workers.dev x402 offerings

Total value locked of a single protocol by its slug (aave, uniswap, lido, curve-dex...), as a single number with provenance. Tiny and fast, made to be called in a loop over a watchlist or to gate a decision ('only act if TVL is above X').

Convert an amount from one currency to another using the ECB reference rate of the day, and return the rate, the converted amount, the date of the rate and a rounding hint. For invoices, expense reports and reports that must cite an official rate.

Event logs emitted by a contract between two block heights, with topics, data, block and transaction reference. This is how you read ERC-20 transfers, swaps or any custom event without an indexing service. The block range is capped so public nodes answer.

Just the receipt: status, gas used and cumulative gas, effective gas price, block, index and logs. Cheaper than the full transaction view when all the caller needs is 'did it land and what did it cost'.

One call returns both the transaction and its receipt: status, from, to, value in native units and wei, gas price and gas used, effective fee in native units, block, nonce and the number of logs emitted. Saves the two round trips a payment verifier always needs.

Name, symbol, decimals and total supply of an ERC-20 contract, read straight from the chain. Use it to label an unknown token, validate a contract before paying it, or compute supply-based metrics without trusting a token list.

Balance of an ERC-20 token for an address, already divided by the token's own decimals and labelled with its symbol, plus the raw atomic amount. Accepts a contract address or a known alias (usdc, usdt, weth) where the alias exists for that chain.

Native coin balance (ETH on Base, Ethereum, Arbitrum and Optimism; POL on Polygon) for any address, returned both in wei and in decimal units. The first check any treasury, gas-station or agent-wallet flow makes.

Best bid and ask, absolute and relative spread, mid price, and the depth available within a configurable percentage of the mid, for a spot pair. Answers 'can I trade this size without moving the price' in one call, without pulling a full order book.

Exchange OHLCV candles for a spot pair: open, high, low, close, volume, quote volume and trade count, up to 200 candles per call at any interval from one minute to one month. Returns one flat object per candle and falls back to a second exchange if the first one rate-limits or blocks.

24h statistics for up to 10 symbols: last price, price change and percent, weighted average, high, low, base volume and quote volume. Flattened from the exchange payload so the numbers are ready to compare or store.

USD price of up to 20 tokens at a specific Unix timestamp (seconds). Same coverage as the live price endpoint, for point-in-time valuation: cost basis, tax lots, historical portfolio snapshots, or auditing what a treasury was worth on a given day.

Official daily reference rates published by the European Central Bank, for the currencies traded against the euro. Not a market feed, the reference rate: what accounting, invoicing and reporting workflows are supposed to use. Keyless and cached.

Generic read-only JSON-RPC passthrough

Read-only eth_call to any contract

Bytecode at an address: tells you instantly whether it is a contract or a plain wallet, how many bytes of code it holds, and whether it is a small proxy. The standard pre-flight check before sending value to an unknown address.

Transactions sent by an address, which is the next nonce to use for the pending or latest block. Used by any agent that signs its own transactions and needs the counter without running a node.

Current gas price plus the 25th, 50th and 75th percentile of effective priority fees over the last blocks, and the base fee trend, all in gwei. What a wallet or a bot needs to decide what to pay, without running a node or hitting an explorer API.

Block number, hash, timestamp as ISO UTC, base fee in gwei, gas used and limit with utilisation, transaction count and miner, for the latest block or the height you pass. Decoded from hex so no client-side conversion is needed.

Chain id, client version and current block height for Base, Ethereum, Arbitrum, Optimism or Polygon, in one call with no API key and no node to run. The cheapest liveness and identity probe for a chain before you build on it.

Full history of a single yield pool by its pool id: APY, base and reward APY, TVL, and the underlying token prices, day by day. For yield strategy backtests and 'was this APY sustained or a spike' questions.

Daily total value locked series, either aggregated across every chain or for the chain passed in the query. The macro backdrop for any DeFi narrative or risk dashboard.

Daily volume series for a single venue, with per-chain breakdown. Complements the fees endpoint when the question is throughput rather than take rate.

Daily fees and revenue series for a single protocol, with breakdowns by chain and by data type. For unit economics, revenue trend work or diligence on a specific app.