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_token
Get individual NFT token metadata: owner, tokenURI, image, attributes. Resolves IPFS URIs. EVM chains only.
bridge_monitor
Detect large token transfers involving known bridge contracts (Across, Wormhole, official bridges). EVM only.
recent_interactions
Show addresses that interacted with a target in recent ~2000 blocks. Labels known entities (CEX, DEX, bridges). EVM only.
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.
contract_events
Read recent event logs from any smart contract. Auto-decodes Transfer, Approval, Swap events. EVM only.
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.
liquidity_depth
Read Uniswap V3 pool state for a token pair: current price, active liquidity, fee tier. EVM only.
governance
Read on-chain DAO governance proposals. Shows last 5 proposals with vote counts and states. Supported: Ethereum, Arbitrum, Optimism.
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.
protocol_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.
yield_farming
Get Uniswap V3 LP pool statistics including liquidity, fee tiers, and current tick data.
flashloan_monitor
Monitor flash loan activity on Aave V3. Detects recent flash loans with amounts and premiums paid.
liquidation_alerts
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.
multi_sig
Analyze a Gnosis Safe multi-sig wallet. Returns owners, threshold, nonce, modules, and security assessment.
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.
portfolio_analyze
Analyze a wallet's portfolio: total USD value, token breakdown, concentration analysis, and diversification score.
smart_money
Track smart money patterns by analyzing whale transfer activity. Identifies accumulation vs distribution behavior and market sentiment.
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).
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.
bridge_flow
Analyze cross-chain bridge capital flow direction. Determines if a chain is seeing net capital inflow (bullish) or outflow (bearish).
protocol_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.
cross_chain
Cross-chain wallet correlation: queries all 7 EVM chains in parallel to show balance, nonce, and activity. Includes diversity score and classification.
sandwich_scanner
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_optimization
Gas price optimization advisor: analyzes recent block patterns to recommend the best time to transact. Includes savings estimate.
yield_aggregator
Cross-chain DeFi yield ranking: scans Aave V3 across all supported chains to find the best supply APY and cheapest borrow rates.
address_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.
block_info
Get latest or specific block data including gas, transactions, and timestamps.
contract_verify
Check if an address is a smart contract or an EOA wallet. Returns code size, balance, and classification.
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.
dex_trades
Get recent DEX swap trades from a Uniswap V3 pool.
stablecoin_supply
Get USDC/USDT/DAI total supply across chains.
address_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.
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.
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)
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)
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)
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)
erc8004_reputation
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)
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)
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)
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)
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)
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)
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.