santyvv-data

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.

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.

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.

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.

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.

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.

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.

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'.

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.

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.

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.

Price in any fiat or crypto quote currency plus market cap, 24h change and last update, for up to 20 coins by their CoinGecko id (bitcoin, ethereum, usd-coin...). Keyless access with edge caching in front, so the caller does not burn CoinGecko's per-IP rate limit.

Full rate table for a base currency (USDC or any currency the venue quotes), including crypto and fiat pairs. Handy to convert between hundreds of assets in one call. Raw upstream payload, cached at the edge.

Whole-market snapshot, already flattened to the numbers an agent usually needs: total market cap, 24h volume, BTC and ETH dominance, active cryptocurrencies and markets, 24h market cap change. One call instead of parsing a deeply nested payload.

Time series of price, market cap and total volume for one coin over 1 to 365 days, at the resolution CoinGecko serves (hourly up to 90 days, daily beyond). For charting, backtesting a strategy or computing volatility.

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.

Market table of the top coins by market capitalisation: price, market cap, volume, circulating supply, all-time high and 1h/24h/7d changes, up to 250 rows per call with pagination. Normalised into one flat row per coin; falls back to a second provider if the first one rate-limits.

Open/high/low/close candles for one coin (timestamp, open, high, low, close) over 1 to 365 days. The candle granularity is chosen by the upstream provider for the requested window. Drop-in input for a trading or charting pipeline without a CoinGecko key.

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.

Consensus USD spot price for up to 5 crypto tickers (BTC, ETH, SOL, XRP, ADA, DOGE, AVAX, LINK, DOT, LTC, BCH, UNI, ATOM, NEAR, APT, ARB, OP, SUI, TON, POL). Queries four independent venues (MEXC, OKX, Coinbase and Kraken), returns the median plus min, max and a divergence flag, so a single venue printing a bad price cannot fool the caller. Call it when you need one trustworthy number instead of four API integrations.

Resolve a name, ticker or partial string to canonical ids, symbols and market-cap ranks, before calling a price endpoint. Includes coins, exchanges, categories and non-fungible collections.

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.

Spot price in USD for up to 20 tokens identified by contract address, on Base, Ethereum, Arbitrum, Optimism or Polygon, with decimals and confidence. No API key, no rate limit surprises: useful to value a wallet, a treasury or an invoice in tokens that an exchange price endpoint cannot resolve.

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.

What the market is searching for right now: the trending coin list plus trending search terms and non-fungible collections, exactly as the upstream search index reports it. Useful for content agents, news summarisation or meme-coin screening.

Daily TVL history for a single chain (Base, Ethereum, Arbitrum, Optimism, Polygon, Solana, ...). Use it for growth charts, delta computations and cohort analysis. Raw upstream series, cached at the edge.

Ranked TVL for every tracked chain with its token symbol and chain id, biggest first, plus the grand total. The cheapest honest read on where liquidity sits. Normalised from the upstream payload into a flat list.

Decentralised exchange volumes: totals, 24h/7d/30d windows, per-chain and per-protocol breakdowns, all in one payload cached at the edge. For market-structure work and volume share screens.

Fees and revenue generated across protocols: totals, window changes and per-protocol rows. The dataset most 'is this protocol actually used' questions reduce to. Raw upstream payload, cached at the edge.

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.

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').

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

Circulating stablecoin supply per chain, with the grand total, normalised into a flat ranked list. Answers 'which chain holds the dollar liquidity' without pulling the full stablecoin table.

Every tracked stablecoin with circulating supply, supply yesterday and a week ago, chain breakdown, peg type and mechanism. The supply table behind most stablecoin dashboards. Raw upstream payload, cached at the edge.

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.

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.

One verdict on a concrete order before it is sent: effective price, slippage in bps and in USD, how much of the visible book the order eats, and the largest size that still fits your slippage budget. Walks the live order book level by level (you never download the book) and answers ok / ajustado / riesgo with the reasons. Use it to size an order, to compare venues, or before quoting a fill.

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.

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.