defi.yields
Get live DeFi lending rates. EVM: Aave V3 supply/borrow APY. Solana: Kamino KLend reserves + native staking yield.
nft.collection
Get NFT collection info: name, symbol, total supply, owner count. EVM chains only (ERC-721/1155).
nft.metadata
Get individual NFT token metadata: owner, tokenURI, image, attributes. Resolves IPFS URIs. EVM chains only.
chain.bridge.monitor
Detect large token transfers involving known bridge contracts (Across, Wormhole, official bridges). EVM only.
analyze.recent_interactions
Show addresses that interacted with a target in recent ~2000 blocks. Labels known entities (CEX, DEX, bridges). EVM only.
security.contract.scan
Security scan a smart contract via bytecode analysis. Detects selfdestruct, delegatecall, proxy patterns, ownership. No external APIs. EVM only.
gas.history
Get 6-hour gas fee trend with 36 sampled data points. EVM: base fee per block. Solana: TPS performance samples.
security.contract.events
Read recent event logs from any smart contract. Auto-decodes Transfer, Approval, Swap events. EVM only.
security.mev.detect
Quick sandwich attack detection. Analyzes 5 transactions before/after target in the same block. EVM only.
defi.compare
Compare DeFi lending rates across protocols. EVM: Aave V3 vs Compound V3 side-by-side. Solana: Kamino + staking yield.
token.screener
Screen tokens by risk score and price. Returns sorted list of tokens matching criteria. EVM only.
defi.liquidity
Read Uniswap V3 pool state for a token pair: current price, active liquidity, fee tier. EVM only.
util.governance
Read on-chain DAO governance proposals. Shows last 5 proposals with vote counts and states. Supported: Ethereum, Arbitrum, Optimism.
market.stablecoin.monitor
Monitor stablecoin peg stability. Detects USDC/USDT/DAI price deviations from $1.00 using on-chain DEX pool data.
gas.predict
Predict near-future gas prices using moving average and trend analysis of recent block base fees. Returns prediction, trend, and recommendation.
defi.tvl
Calculate total value locked (TVL) in DeFi protocols (Aave V3, Compound V3) directly from on-chain aToken and Comet supplies.
token.holders
Analyze top token holders by recent accumulation. Scans Transfer events to identify the largest net receivers of a token.
defi.farming
Get Uniswap V3 LP pool statistics including liquidity, fee tiers, and current tick data.
monitor.flashloan
Monitor flash loan activity on Aave V3. Detects recent flash loans with amounts and premiums paid.
monitor.liquidation
Monitor DeFi liquidation events on Aave V3. High liquidation counts indicate market stress and potential cascading risk.
token.approval
Check a wallet's ERC20 token approvals for security risks. Flags unlimited approvals and risky spender contracts.
util.multi_sig
Analyze a Gnosis Safe multi-sig wallet. Returns owners, threshold, nonce, modules, and security assessment.
util.ens_resolve
Resolve ENS domain names to Ethereum addresses (forward) or addresses to ENS names (reverse). Also retrieves text records.
market.overview
Get a cross-chain market snapshot: ETH price, gas costs, and DeFi TVL across Base, Ethereum, Arbitrum, and Optimism in one call.
chain.compare
Side-by-side comparison of EVM chains — gas costs, block time, and best DeFi yields. Helps choose the optimal chain for transactions.
wallet.portfolio
Analyze a wallet's portfolio: total USD value, token breakdown, concentration analysis, and diversification score.
wallet.smart_money
Track smart money patterns by analyzing whale transfer activity. Identifies accumulation vs distribution behavior and market sentiment.
wallet.credit_score
Calculate an on-chain credit score (0-100) for any wallet. Factors: transaction history, native balance, token diversity, stablecoin holdings, DeFi activity. Returns grade (AAA to C).
analyze.risk_dashboard
Get a unified risk assessment for any address: combines contract security scan, token approval risks, and market liquidation stress into one composite risk score.
chain.bridge.flow
Analyze cross-chain bridge capital flow direction. Determines if a chain is seeing net capital inflow (bullish) or outflow (bearish).
defi.health
Assess DeFi protocol health: combines TVL, utilization rates, and liquidation frequency into a composite health score (0-100).
nft.floor
Analyze NFT collection activity: recent transfers, mints, burns, unique buyers, and activity level from on-chain ERC721 events.
chain.cross
Cross-chain wallet correlation: queries all 7 EVM chains in parallel to show balance, nonce, and activity. Includes diversity score and classification.
security.sandwich
Batch scan an address's recent transactions for MEV sandwich attacks. Checks front-run + back-run patterns in surrounding transactions.
token.unlock
Read token vesting/unlock schedule from on-chain contracts. Supports LinearVesting, CliffVesting, and Timelock patterns.
gas.optimize
Gas price optimization advisor: analyzes recent block patterns to recommend the best time to transact. Includes savings estimate.
defi.aggregator
Cross-chain DeFi yield ranking: scans Aave V3 across all supported chains to find the best supply APY and cheapest borrow rates.
wallet.labels
Query the Address Intelligence database for labels on an address (whale, smart_money, etc). Labels are learned automatically from whale alerts and smart money tracking.
token.supply
Get ERC20 token total supply, decimals, symbol, and name from on-chain data.
chain.block
Get latest or specific block data including gas, transactions, and timestamps.
security.contract.verify
Check if an address is a smart contract or an EOA wallet. Returns code size, balance, and classification.
analyze.tx_decode
Decode a transaction: value, gas cost, status, method ID, and whether it's a contract call.
nft.holders
Analyze NFT holder distribution by scanning recent Transfer events.
market.dex_trades
Get recent DEX swap trades from a Uniswap V3 pool.
market.stablecoin.supply
Get USDC/USDT/DAI total supply across chains.
wallet.report
Comprehensive address report combining wallet profile, credit score, token approvals, and recent interactions in one response.
chain.health
Chain health score aggregating gas data, protocol TVL, and stablecoin stability.
defi.opportunity
Find the best DeFi yield opportunity combined with optimal gas timing.
monitor.whale.tracker
Track a specific whale address with Address Intelligence labels and wallet profile.
oracle.gas_avg
Data Oracle: Multi-chain gas price aggregation. Returns gas prices across multiple chains with a cheapest-chain recommendation. Ideal for agents choosing settlement chains.
oracle.price_feed
Data Oracle: Verified token price feed with Chain Proof signature. Returns price, source, and confidence level. Lightweight alternative to Chainlink for agent use cases.
oracle.chain_status
Data Oracle: Real-time health and block freshness across top 15 EVM chains. Detects chain outages, stale blocks, and RPC degradation before agents submit transactions.
agent.reputation
KYA (Know Your Agent): 10-factor on-chain reputation scoring. Evaluates transaction volume, balances, token diversity, DeFi interactions, cross-chain intel, and risk flags. Returns trust score (0-100) and trust level. ERC-8004 compatible.
util.context_brief
CaaS (Context as a Service): Aggregates real-time on-chain signals into a structured context brief for agent decision-making. Intents: swap (gas+price+whales), bridge (multi-chain gas), invest (yields+trending), monitor (whales+gas), general (all signals). No LLM cost — pure data.
agent.card.register
Register an AI Agent in the ChainRay A2A Agent Card registry. Requires agentId, name, and capabilities array. Auto-attaches KYA trust score if paymentAddress provided. Returns registration status. ($0.05)
agent.card.discover
Discover AI Agents by capability, chain, or keyword. Returns matching agents with trust scores. Useful for finding agents to collaborate with. ($0.02)
agent.card.lookup
Look up a specific AI Agent's card by ID. Returns identity, capabilities, trust score, and endpoints. ($0.01)
security.mev.shield
Pre-trade safety analysis. Evaluates sandwich attack risk, recommends optimal slippage, and suggests mitigations before executing on-chain trades. Every agent should call this before swapping. ($0.03)
market.solver_feed
Intent Solver decision intelligence. Provides profitability analysis, gas costs, competition level, and recommendations for ERC-7683 cross-chain intent execution. ($0.02)
token.sentiment
On-chain sentiment oracle for any token/chain. Derives market sentiment from 5 on-chain signals: gas trend, gas level, momentum, chain health, ecosystem trend. No LLM. ($0.03)
util.workflow_brief
Multi-agent workflow intelligence. Generates differentiated context briefs for each agent role in a collaborative workflow (swap, risk, bridge, settle, monitor, analysis agents). ($0.15)
agent.erc8004
Get agent reputation in ERC-8004 standard format (Identity + Reputation + Validation Registry schema). Same KYA analysis but formatted for on-chain registry compatibility. ($0.05)
util.intent_router
🧠 Natural language intent routing: describe what you want to know and ChainRay auto-selects the best combination of endpoints. Supports security analysis, yield search, trade signals, wallet analysis, gas optimization, whale intel, and more. Saves cost vs calling endpoints individually. ($0.03)
util.verify_proof
🔐 Verify data integrity: pass a dataHash from any ChainRay response's _proof field to cryptographically verify the data was produced by ChainRay. Returns VERIFIED, NOT_FOUND, or INVALID. ($0.005)
monitor.watch.address
🧲 Create a watch on any address. Returns full wallet profile snapshot + watchId. Use watch-diff with the watchId later to get only what changed — 75% cheaper than re-fetching. ($0.02)
monitor.watch.diff
🧲 Get changes since last check for a watched address. Returns only what changed (balance, tokens, transactions) with delta calculations. ($0.005)
predict.gas
🔮 Gas price prediction: EMA-based forecast for next 5 minutes and 1 hour. Uses real accumulated gas history. Confidence increases with more data points. ($0.01)
predict.whale_move
🔮 Whale activity prediction: projects next-hour whale transfer count and volume based on current activity patterns. Uses frequency decay model. ($0.03)
predict.liquidity
🔮 Liquidity prediction: TVL trend analysis with health scoring and risk factors. Predicts 24h TVL direction and range. ($0.03)
predict.token_momentum
🔮 Token momentum prediction: BUY/SELL/HOLD signal based on price change, trending status, and volume. ($0.03)
security.mev.intel
⚡ Cross-protocol MEV intelligence: scans for cross-DEX arbitrage opportunities with chain-specific DEX names, profit estimates, sandwich risk rates, and backstop liquidity. ($0.05)
util.stream_info
Get connection info for ChainRay real-time SSE streaming endpoints. These endpoints require a direct HTTP connection with text/event-stream Accept header, not MCP. Use this tool to learn how to connect.