{"name":"teardrop-tools","title":"Teardrop","description":"The native infrastructure layer for autonomous economic agents. Teardrop exposes its curated Web3, data, and utility tools over MCP with public discovery and authenticated execution.","homepage":"https://api.teardrop.dev","documentationUrl":"https://api.teardrop.dev/docs","serverInfo":{"name":"teardrop-tools","title":"Teardrop","description":"The native infrastructure layer for autonomous economic agents. Teardrop exposes its curated Web3, data, and utility tools over MCP with public discovery and authenticated execution.","version":"2.13.0","websiteUrl":"https://api.teardrop.dev","icons":[{"src":"https://teardrop.dev/teardrop.png"}]},"authentication":{"required":true,"schemes":["bearer","x402"]},"tools":[{"name":"assess_counterparty_risk","description":"Return a decision-ready counterparty-risk verdict for an EVM address before funds or authority are committed. The result branches to high_risk, caution, acceptable, or insufficient_data with the evidence needed for the calling agent to act.","inputSchema":{"properties":{"wallet_address":{"description":"EVM wallet address (0x-prefixed)","title":"Wallet Address","type":"string"},"chain_ids":{"description":"DeBank chain identifiers scoping approvals and history; positions and net worth remain all-chain.","items":{"type":"string"},"title":"Chain Ids","type":"array"}},"required":["wallet_address"],"title":"AssessCounterpartyRiskInput","type":"object"},"title":"Assess Counterparty Risk","annotations":{"readOnlyHint":true},"use_when":"Delegate this check before sending funds, granting approvals, or interacting with an unknown EVM address when the caller needs a bounded risk decision.","limitations":"Analytics and heuristic risk assessment; not a credit bureau, fraud guarantee, or legal endorsement. Relies on DeBank indexing and on-chain Aave/Compound contract states.","alternatives":["get_wallet_approvals","get_liquidation_risk","get_wallet_positions"],"outputSchema":{"$defs":{"ActivitySummary":{"properties":{"tx_count":{"default":0,"title":"Tx Count","type":"integer"},"distinct_counterparties":{"default":0,"title":"Distinct Counterparties","type":"integer"},"cex_names":{"items":{"type":"string"},"title":"Cex Names","type":"array"}},"title":"ActivitySummary","type":"object"},"ApprovalSummary":{"properties":{"total":{"default":0,"title":"Total","type":"integer"},"unlimited":{"default":0,"title":"Unlimited","type":"integer"},"sum_exposure_usd":{"default":0.0,"title":"Sum Exposure Usd","type":"number"},"hacked_spenders":{"default":0,"title":"Hacked Spenders","type":"integer"},"abandoned_spenders":{"default":0,"title":"Abandoned Spenders","type":"integer"},"unverified_spenders":{"default":0,"title":"Unverified Spenders","type":"integer"}},"title":"ApprovalSummary","type":"object"},"DataProvenance":{"description":"Machine-readable source and freshness metadata for a tool response.","properties":{"provider":{"title":"Provider","type":"string"},"source_urls":{"items":{"type":"string"},"title":"Source Urls","type":"array"},"retrieved_at":{"title":"Retrieved At","type":"string"},"source_fetched_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Fetched At"},"cache_hit":{"default":false,"title":"Cache Hit","type":"boolean"},"cache_age_seconds":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Cache Age Seconds"},"cache_ttl_seconds":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Cache Ttl Seconds"}},"required":["provider","retrieved_at"],"title":"DataProvenance","type":"object"},"LiquidationSummary":{"properties":{"status":{"default":"no_debt","title":"Status","type":"string"},"worst_health_factor":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Worst Health Factor"},"has_borrow_positions":{"default":false,"title":"Has Borrow Positions","type":"boolean"}},"title":"LiquidationSummary","type":"object"},"RiskFactor":{"properties":{"category":{"title":"Category","type":"string"},"severity":{"enum":["high","medium","low"],"title":"Severity","type":"string"},"detail":{"title":"Detail","type":"string"}},"required":["category","severity","detail"],"title":"RiskFactor","type":"object"}},"properties":{"wallet_address":{"title":"Wallet Address","type":"string"},"verdict":{"enum":["high_risk","caution","acceptable","insufficient_data"],"title":"Verdict","type":"string"},"risk_factors":{"items":{"$ref":"#/$defs/RiskFactor"},"title":"Risk Factors","type":"array"},"approval_summary":{"$ref":"#/$defs/ApprovalSummary"},"liquidation":{"$ref":"#/$defs/LiquidationSummary"},"activity":{"$ref":"#/$defs/ActivitySummary"},"total_net_worth_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Total Net Worth Usd"},"partial_errors":{"items":{"type":"string"},"title":"Partial Errors","type":"array"},"data_complete":{"default":true,"title":"Data Complete","type":"boolean"},"provenance":{"$ref":"#/$defs/DataProvenance"},"as_of":{"title":"As Of","type":"string"}},"required":["wallet_address","verdict","provenance","as_of"],"title":"AssessCounterpartyRiskOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":35000,"unit":"call"}}},{"name":"assess_market_resolution","description":"Return a decision-ready resolution-risk verdict for one Polymarket market before an agent trades, quotes, or forecasts it. The result branches to tradeable, ambiguous, avoid, or insufficient_data and names the resolution basis (price_feed, official_source, media_consensus, unspecified), UMA dispute state, rule-wording risks, and executability (liquidity, spread) so the calling agent can act without reading the full rules.","inputSchema":{"properties":{"market":{"description":"Polymarket market slug (e.g. 'will-bitcoin-reach-150k-in-2026'), numeric Gamma market id, or a polymarket.com market URL (the last path segment is used).","title":"Market","type":"string"}},"required":["market"],"title":"AssessMarketResolutionInput","type":"object"},"title":"Assess Market Resolution","annotations":{"readOnlyHint":true},"use_when":"Call once per market before placing, quoting, or forecasting a Polymarket position when the caller needs to know whether the rules and resolution state make the outcome well-defined. Repeat calls within two minutes return cached data.","limitations":"Heuristic analysis of Polymarket rule wording and Gamma API state; not a probability forecast, legal advice, or a guarantee of how UMA voters resolve. Does not read order-book depth, event-level augmented negative-risk settings, or clarifications published off-platform.","alternatives":["web_search","http_fetch"],"outputSchema":{"$defs":{"DataProvenance":{"description":"Machine-readable source and freshness metadata for a tool response.","properties":{"provider":{"title":"Provider","type":"string"},"source_urls":{"items":{"type":"string"},"title":"Source Urls","type":"array"},"retrieved_at":{"title":"Retrieved At","type":"string"},"source_fetched_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Fetched At"},"cache_hit":{"default":false,"title":"Cache Hit","type":"boolean"},"cache_age_seconds":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Cache Age Seconds"},"cache_ttl_seconds":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Cache Ttl Seconds"}},"required":["provider","retrieved_at"],"title":"DataProvenance","type":"object"},"MarketRiskFactor":{"properties":{"code":{"title":"Code","type":"string"},"category":{"enum":["state","resolution","rules","execution"],"title":"Category","type":"string"},"severity":{"enum":["high","medium","low"],"title":"Severity","type":"string"},"detail":{"title":"Detail","type":"string"}},"required":["code","category","severity","detail"],"title":"MarketRiskFactor","type":"object"}},"properties":{"market_id":{"title":"Market Id","type":"string"},"slug":{"title":"Slug","type":"string"},"question":{"title":"Question","type":"string"},"verdict":{"enum":["tradeable","ambiguous","avoid","insufficient_data"],"title":"Verdict","type":"string"},"verdict_reason":{"title":"Verdict Reason","type":"string"},"resolution_basis":{"enum":["price_feed","official_source","media_consensus","unspecified"],"title":"Resolution Basis","type":"string"},"resolution_source":{"default":"","title":"Resolution Source","type":"string"},"uma_status":{"default":"","title":"Uma Status","type":"string"},"disputed":{"default":false,"title":"Disputed","type":"boolean"},"rule_flags":{"items":{"type":"string"},"title":"Rule Flags","type":"array"},"risk_factors":{"items":{"$ref":"#/$defs/MarketRiskFactor"},"title":"Risk Factors","type":"array"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"End Date"},"hours_to_end":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Hours To End"},"outcome_prices":{"additionalProperties":{"type":"number"},"title":"Outcome Prices","type":"object"},"best_bid":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Best Bid"},"best_ask":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Best Ask"},"spread":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Spread"},"liquidity_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Liquidity Usd"},"neg_risk":{"default":false,"title":"Neg Risk","type":"boolean"},"provenance":{"$ref":"#/$defs/DataProvenance"},"as_of":{"title":"As Of","type":"string"}},"required":["market_id","slug","question","verdict","verdict_reason","resolution_basis","provenance","as_of"],"title":"AssessMarketResolutionOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":25000,"unit":"call"}}},{"name":"calculate","description":"Evaluate a safe arithmetic expression and return the numeric result. Supports +,-,*,/,**,%,sqrt,abs,round,floor,ceil,log,sin,cos,tan,pi,e. Use for derived figures (ratios, differences, percentages) that no tool output already provides.","inputSchema":{"properties":{"expression":{"description":"A safe arithmetic expression, e.g. '(3 + 4) * 2 / sqrt(9)'","maxLength":200,"title":"Expression","type":"string"}},"required":["expression"],"title":"CalculateInput","type":"object"},"title":"Calculate","annotations":{"readOnlyHint":true},"use_when":"Use when an agent must derive a value that tool outputs do not already include, such as a ratio, spread, or percentage. Do not use to re-derive pre-computed fields like std_30d or dca_baseline_90d that get_token_price_historical returns.","limitations":"Arithmetic only — no aggregation over tool history, no unit conversion, and no financial modeling beyond the listed functions. Errors return an error field rather than raising.","alternatives":["get_token_price_historical","get_datetime"],"outputSchema":{"properties":{"expression":{"title":"Expression","type":"string"},"result":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Result"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Error"}},"required":["expression"],"title":"CalculateOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":0,"unit":"call"}}},{"name":"convert_currency","description":"Convert an amount between fiat currencies (USD, EUR, GBP) and crypto assets (BTC, ETH, USDC, SOL) and return the converted amount plus the exchange rate used.","inputSchema":{"properties":{"amount":{"description":"Amount to convert","exclusiveMinimum":0,"title":"Amount","type":"number"},"from_currency":{"description":"Source currency (e.g. 'ETH', 'USD', 'BTC')","maxLength":20,"minLength":1,"title":"From Currency","type":"string"},"to_currency":{"description":"Target currency (e.g. 'USD', 'EUR', 'BTC')","maxLength":20,"minLength":1,"title":"To Currency","type":"string"}},"required":["amount","from_currency","to_currency"],"title":"ConvertCurrencyInput","type":"object"},"title":"Convert Currency","annotations":{"readOnlyHint":true},"use_when":"Use when an amount must be expressed in a different currency than the source data — for example converting a USD portfolio value into EUR, or a fiat amount into its crypto equivalent. For prices only, get_token_price returns the rate directly without a second call.","limitations":"Spot-rate conversion at request time; no historical or forward rates, and no slippage or fee modeling. Actual swap execution differs — use get_dex_quote for executable on-chain quotes.","alternatives":["get_token_price","get_dex_quote"],"outputSchema":{"properties":{"amount":{"title":"Amount","type":"number"},"from_currency":{"title":"From Currency","type":"string"},"to_currency":{"title":"To Currency","type":"string"},"converted_amount":{"title":"Converted Amount","type":"number"},"rate":{"title":"Rate","type":"number"},"source":{"title":"Source","type":"string"}},"required":["amount","from_currency","to_currency","converted_amount","rate","source"],"title":"ConvertCurrencyOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"decode_transaction","description":"Decode a transaction's calldata into a human-readable function name and arguments, and return transaction status (1=success, 0=revert), gas used, and block number. Uses a supplied ABI when provided, otherwise 4byte.directory. Supports Ethereum mainnet and Base.","inputSchema":{"properties":{"tx_hash":{"description":"Transaction hash (0x… 64 hex chars)","title":"Tx Hash","type":"string"},"chain_id":{"default":1,"description":"Chain ID (1=Ethereum, 8453=Base)","title":"Chain Id","type":"integer"},"abi_json":{"anyOf":[{"maxLength":65536,"type":"string"},{"type":"null"}],"default":null,"description":"Optional ABI JSON array for decoding. If omitted, 4byte.directory is used.","title":"Abi Json"}},"required":["tx_hash"],"title":"DecodeTransactionInput","type":"object"},"title":"Decode Transaction","annotations":{"readOnlyHint":true},"use_when":"Use when one known transaction must be explained — what function was called, with what arguments, and whether it succeeded. For wallet-wide activity patterns use get_wallet_history instead.","limitations":"4byte.directory matching can be ambiguous or absent for custom contracts; supply an ABI for precise decoding. One transaction per call; Ethereum mainnet and Base only.","alternatives":["get_transaction","get_wallet_history"],"outputSchema":{"properties":{"tx_hash":{"title":"Tx Hash","type":"string"},"from_address":{"title":"From Address","type":"string"},"to_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"To Address"},"value_eth":{"title":"Value Eth","type":"string"},"status":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"1=success, 0=revert, None=pending","title":"Status"},"gas_used":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Gas Used"},"block_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Block Number"},"function_selector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Function Selector"},"function_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Function Name"},"decoded_args":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Decoded Args"},"raw_calldata":{"title":"Raw Calldata","type":"string"},"decode_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Decode Source"},"chain_id":{"title":"Chain Id","type":"integer"},"note":{"default":"decoded_args values are raw ABI-decoded types; uint256 amounts have not been decimals-formatted — do not call read_contract or get_erc20_balance to interpret them unless the user explicitly asks. Addresses (from_address, to_address, decoded_args) are plain hex — do not call resolve_ens to label them unless the user explicitly asks.","title":"Note","type":"string"}},"required":["tx_hash","from_address","to_address","value_eth","gas_used","block_number","function_selector","function_name","decoded_args","raw_calldata","decode_source","chain_id"],"title":"DecodeTransactionOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"delegate_to_agent","description":"Delegate a task to a remote A2A-compliant agent: discover its capabilities via its agent card, send it a message, handle payment, and return the result. Use only when no local platform tool can fulfil the request.","inputSchema":{"properties":{"agent_url":{"description":"Base URL of the remote A2A agent (e.g. https://agent.example.com)","maxLength":2000,"minLength":10,"title":"Agent Url","type":"string"},"task_description":{"description":"Natural language description of the task to delegate","maxLength":4096,"minLength":1,"title":"Task Description","type":"string"},"task_type":{"default":"general","description":"Broad task class for routing telemetry; never include user data or task text.","enum":["general","research","analysis","data_retrieval","coding","transaction","automation"],"title":"Task Type","type":"string"}},"required":["agent_url","task_description"],"title":"DelegateToAgentInput","type":"object"},"title":"Delegate To Agent","annotations":{"readOnlyHint":false,"openWorldHint":true,"idempotentHint":false},"use_when":"Use when a task requires specialist capabilities beyond the local tool set. Call discover_agents first when the remote agent URL is unknown. Do not retry unchanged after error_type=advertised_price_exceeds_cap; pick another result or adjust the cap.","limitations":"Requires an allowlisted remote URL and sufficient delegation budget; the remote agent's price and capability claims are read from its card and are not independently verified. Involves real payment.","alternatives":["discover_agents","web_search"],"outputSchema":{"properties":{"agent_name":{"description":"Name of the remote agent (from its agent card)","title":"Agent Name","type":"string"},"status":{"description":"A2A task state: completed, failed, etc.","title":"Status","type":"string"},"result":{"description":"Text result extracted from the remote agent's response","title":"Result","type":"string"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Error message, if any","title":"Error"},"error_type":{"anyOf":[{"const":"advertised_price_exceeds_cap","type":"string"},{"type":"null"}],"default":null,"description":"Stable error type for delegation failures that require planner recovery.","title":"Error Type"},"cost_usdc":{"default":0,"description":"Cost of this delegation in atomic USDC","title":"Cost Usdc","type":"integer"}},"required":["agent_name","status","result"],"title":"DelegateToAgentOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":0,"unit":"call"}}},{"name":"discover_agents","description":"Find opt-in remote A2A agents, published tool capabilities, endpoints, and public reputation status.","inputSchema":{"properties":{"q":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Optional search across agent name, organization slug, or published tool name","title":"Q"},"limit":{"default":20,"description":"Maximum number of agents to return","maximum":50,"minimum":1,"title":"Limit","type":"integer"}},"title":"DiscoverAgentsInput","type":"object"},"title":"Discover Agents","annotations":{"readOnlyHint":true},"use_when":"Use before delegate_to_agent when a specialist agent is needed but its URL is unknown.","limitations":"Discovery is read-only and does not add an agent to the org allowlist; delegate_to_agent remains authoritative.","alternatives":["delegate_to_agent"],"outputSchema":{"$defs":{"AgentReputation":{"properties":{"status":{"enum":["rated","unrated"],"title":"Status","type":"string"},"score":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Score"},"success_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Success Rate"},"sample_size":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Sample Size"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Confidence"},"unique_caller_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Unique Caller Count"},"last_event_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Last Event At"},"is_stale":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Is Stale"}},"required":["status"],"title":"AgentReputation","type":"object"},"DiscoveredAgent":{"properties":{"org_slug":{"title":"Org Slug","type":"string"},"org_name":{"title":"Org Name","type":"string"},"agent_url":{"title":"Agent Url","type":"string"},"agent_card_url":{"title":"Agent Card Url","type":"string"},"message_endpoint":{"title":"Message Endpoint","type":"string"},"catalog_endpoint":{"title":"Catalog Endpoint","type":"string"},"tool_count":{"title":"Tool Count","type":"integer"},"tool_names":{"description":"Names of up to 20 active published tools exposed by the agent organization","items":{"type":"string"},"title":"Tool Names","type":"array"},"registered_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"UTC timestamp when the organization first registered its A2A endpoint","title":"Registered At"},"allowlisted":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the caller's org has this endpoint in its allowlist; null when caller context is unavailable","title":"Allowlisted"},"reputation":{"$ref":"#/$defs/AgentReputation"}},"required":["org_slug","org_name","agent_url","agent_card_url","message_endpoint","catalog_endpoint","tool_count","allowlisted","reputation"],"title":"DiscoveredAgent","type":"object"}},"properties":{"generated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generated At"},"count":{"title":"Count","type":"integer"},"agents":{"items":{"$ref":"#/$defs/DiscoveredAgent"},"title":"Agents","type":"array"},"registration_endpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Endpoint where an organization can publish its own A2A endpoint.","title":"Registration Endpoint"},"registration_benefits_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Machine-readable registration benefits, requirements, and non-guarantees.","title":"Registration Benefits Url"}},"required":["generated_at","count","agents"],"title":"DiscoverAgentsOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":0,"unit":"call"}}},{"name":"get_datetime","description":"Return the current UTC date and time as a formatted string and ISO 8601 timestamp, for grounding time-relative reasoning in the actual clock rather than training-data assumptions.","inputSchema":{"properties":{"format":{"default":"%Y-%m-%d %H:%M:%S UTC","description":"strftime format string for the output","maxLength":100,"title":"Format","type":"string"}},"title":"GetDatetimeInput","type":"object"},"title":"Get Datetime","annotations":{"readOnlyHint":true},"use_when":"Use when a task must anchor on the current date or time — computing ages, windows, deadlines, or 'as of today' context. The runtime context block already states the date, so call this only when a specific strftime format or a precise timestamp is needed.","limitations":"UTC only — no timezone conversion. An unsupported strftime format silently falls back to the default format instead of erroring.","alternatives":["calculate","get_block"],"outputSchema":{"properties":{"datetime":{"title":"Datetime","type":"string"},"iso8601":{"title":"Iso8601","type":"string"}},"required":["datetime","iso8601"],"title":"GetDatetimeOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":0,"unit":"call"}}},{"name":"get_block","description":"Get block details (timestamp, gas used, base fee, miner, transaction count) for an Ethereum or Base block by number, hash, or 'latest'. Use to anchor events to a point in chain time.","inputSchema":{"properties":{"block_identifier":{"default":"latest","description":"Block number, block hash, or 'latest'/'earliest'/'pending'","title":"Block Identifier","type":"string"},"chain_id":{"default":1,"description":"Chain ID (1=Ethereum, 8453=Base)","title":"Chain Id","type":"integer"}},"title":"GetBlockInput","type":"object"},"title":"Get Block","annotations":{"readOnlyHint":true},"use_when":"Use when a question depends on when a block occurred, how full it was, or its base fee — for example dating a transaction or checking congestion at a specific height. For current fee levels use get_gas_price instead.","limitations":"One block per call; Ethereum mainnet and Base only. Historical base fee data depends on RPC node retention for older heights.","alternatives":["get_transaction","get_gas_price"],"outputSchema":{"properties":{"number":{"title":"Number","type":"integer"},"hash":{"title":"Hash","type":"string"},"timestamp":{"title":"Timestamp","type":"integer"},"transaction_count":{"title":"Transaction Count","type":"integer"},"gas_used":{"title":"Gas Used","type":"integer"},"base_fee_gwei":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Fee Gwei"}},"required":["number","hash","timestamp","transaction_count","gas_used","base_fee_gwei"],"title":"GetBlockOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"get_chain_metrics","description":"Compare blockchain ecosystem health via DeFiLlama: current TVL, 7/30-day TVL change, and aggregate fee activity. Pass chains such as ['Ethereum', 'Arbitrum', 'Solana'] for a focused comparison, or omit chains to inspect the highest-TVL ecosystems.","inputSchema":{"properties":{"chains":{"anyOf":[{"items":{"type":"string"},"maxItems":50,"type":"array"},{"type":"null"}],"default":null,"description":"Optional chain names to compare, such as ['Ethereum', 'Arbitrum', 'Solana']. When omitted, return the highest-TVL chains up to limit.","title":"Chains"},"days":{"default":30,"description":"Lookback window used when selecting the historical TVL points to inspect.","maximum":365,"minimum":7,"title":"Days","type":"integer"},"limit":{"default":20,"description":"Maximum number of chain rows to return when the result is not explicitly filtered.","maximum":50,"minimum":1,"title":"Limit","type":"integer"}},"title":"GetChainMetricsInput","type":"object"},"title":"Get Chain Metrics","annotations":{"readOnlyHint":true},"use_when":"Use for ecosystem-level comparisons — which chains are growing, where fee activity concentrates, or how a chain's TVL trended. For a single protocol's economics use get_protocol_tvl instead.","limitations":"Third-party DeFiLlama analytics; historical and fee fields fail open (null) for uncovered chains. Not a real-time measure of chain throughput or security.","alternatives":["get_protocol_tvl","get_dex_volume"],"outputSchema":{"$defs":{"ChainMetricsEntry":{"properties":{"chain":{"title":"Chain","type":"string"},"chain_id":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Chain Id"},"token_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token Symbol"},"tvl_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Tvl Usd"},"tvl_7d_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Tvl 7D Change Pct"},"tvl_30d_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Tvl 30D Change Pct"},"fees_24h_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Fees 24H Usd"},"fees_7d_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Fees 7D Usd"},"fees_30d_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Fees 30D Usd"},"fees_7d_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Fees 7D Change Pct"},"fees_30d_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Fees 30D Change Pct"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Error"},"error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Error Type"}},"required":["chain","chain_id","token_symbol","tvl_usd","tvl_7d_change_pct","tvl_30d_change_pct","fees_24h_usd","fees_7d_usd","fees_30d_usd","fees_7d_change_pct","fees_30d_change_pct"],"title":"ChainMetricsEntry","type":"object"},"DataProvenance":{"description":"Machine-readable source and freshness metadata for a tool response.","properties":{"provider":{"title":"Provider","type":"string"},"source_urls":{"items":{"type":"string"},"title":"Source Urls","type":"array"},"retrieved_at":{"title":"Retrieved At","type":"string"},"source_fetched_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Fetched At"},"cache_hit":{"default":false,"title":"Cache Hit","type":"boolean"},"cache_age_seconds":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Cache Age Seconds"},"cache_ttl_seconds":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Cache Ttl Seconds"}},"required":["provider","retrieved_at"],"title":"DataProvenance","type":"object"}},"properties":{"chains":{"items":{"$ref":"#/$defs/ChainMetricsEntry"},"title":"Chains","type":"array"},"requested_chains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Requested Chains"},"total_available":{"title":"Total Available","type":"integer"},"note":{"title":"Note","type":"string"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Error"},"error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Error Type"},"provenance":{"anyOf":[{"$ref":"#/$defs/DataProvenance"},{"type":"null"}],"default":null,"description":"Source and freshness metadata for the DeFiLlama response."}},"required":["chains","requested_chains","total_available","note"],"title":"GetChainMetricsOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"get_dex_quote","description":"Get the best Uniswap v3 swap quote on Ethereum (chain_id=1) or Base (chain_id=8453) via direct on-chain QuoterV2 calls. Queries all four fee tiers (100/500/3000/10000 bps) in parallel and returns the tier with the highest output amount, along with per-tier breakdown. Inputs are raw uint256 amounts and EIP-55 checksummed addresses; native ETH is not quoted directly — pass the WETH address. Returns no_liquidity=true when no pool exists for the pair. Point-in-time quote at the returned block_number; do not cache.","inputSchema":{"properties":{"token_in":{"description":"EIP-55 checksummed address of the token being sold. For native ETH, pass the WETH address (Ethereum: 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2; Base: 0x4200000000000000000000000000000000000006).","title":"Token In","type":"string"},"token_out":{"description":"EIP-55 checksummed address of the token being bought.","title":"Token Out","type":"string"},"amount_in":{"description":"Input amount in RAW uint256 units (e.g. '1000000' for 1 USDC, '1000000000000000000' for 1 WETH). Must be > 0 and < 2^128. Common token decimals: WETH/ETH/DAI/wstETH/cbETH/weETH 18, WBTC/cbBTC 8, USDC/USDT 6. Do not call read_contract to look up decimals — use these values directly.","title":"Amount In","type":"string"},"chain_id":{"default":1,"description":"1 = Ethereum mainnet, 8453 = Base mainnet. Other chains unsupported.","title":"Chain Id","type":"integer"}},"required":["token_in","token_out","amount_in"],"title":"GetDexQuoteInput","type":"object"},"title":"Get Dex Quote","annotations":{"readOnlyHint":true},"use_when":"Choose when you need a best-execution Uniswap v3 swap quote on Ethereum or Base before executing a trade — e.g. price impact, output amount, or route selection.","limitations":"Quotes raw uint256 amounts with EIP-55 checksummed addresses only; native ETH is not quoted directly (pass WETH). Point-in-time at the returned block_number — do not cache.","alternatives":["get_token_price","get_dex_volume"],"outputSchema":{"$defs":{"TierQuote":{"properties":{"fee_tier":{"title":"Fee Tier","type":"integer"},"success":{"title":"Success","type":"boolean"},"amount_out":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Amount Out"},"sqrt_price_x96_after":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Sqrt Price X96 After"},"gas_estimate":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Gas Estimate"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Error"}},"required":["fee_tier","success"],"title":"TierQuote","type":"object"}},"properties":{"chain_id":{"title":"Chain Id","type":"integer"},"token_in":{"title":"Token In","type":"string"},"token_out":{"title":"Token Out","type":"string"},"amount_in":{"title":"Amount In","type":"string"},"amount_in_decimals":{"title":"Amount In Decimals","type":"integer"},"amount_out":{"title":"Amount Out","type":"string"},"amount_out_decimals":{"title":"Amount Out Decimals","type":"integer"},"amount_out_human":{"title":"Amount Out Human","type":"string"},"effective_rate":{"title":"Effective Rate","type":"string"},"fee_tier_used":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Fee Tier Used"},"quotes_per_tier":{"items":{"$ref":"#/$defs/TierQuote"},"title":"Quotes Per Tier","type":"array"},"no_liquidity":{"title":"No Liquidity","type":"boolean"},"block_number":{"title":"Block Number","type":"integer"}},"required":["chain_id","token_in","token_out","amount_in","amount_in_decimals","amount_out","amount_out_decimals","amount_out_human","effective_rate","fee_tier_used","quotes_per_tier","no_liquidity","block_number"],"title":"GetDexQuoteOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"get_dex_volume","description":"Compare decentralized exchange activity via DeFiLlama: 24h/7d/30-day volume, period-over-period changes, and each protocol's share of reported global 24-hour DEX volume. Filter by protocol and rank by a 1-, 7-, or 30-day lookback window.","inputSchema":{"properties":{"protocols":{"anyOf":[{"items":{"type":"string"},"maxItems":50,"type":"array"},{"type":"null"}],"default":null,"description":"Optional protocol names or DeFiLlama slugs, such as ['uniswap-v3', 'curve-dex']. When omitted, return the largest DEX protocols.","title":"Protocols"},"lookback_days":{"default":30,"description":"Window used to rank the returned protocols: 1, 7, or 30 days (nearest supported window is used).","maximum":30,"minimum":1,"title":"Lookback Days","type":"integer"},"limit":{"default":20,"description":"Maximum number of DEX protocols to return.","maximum":50,"minimum":1,"title":"Limit","type":"integer"}},"title":"GetDexVolumeInput","type":"object"},"title":"Get Dex Volume","annotations":{"readOnlyHint":true},"use_when":"Use for landscape questions — which DEXs dominate volume, how activity shifted week-over-week, or a specific protocol's relative share. For executable swap pricing use get_dex_quote instead.","limitations":"Third-party DeFiLlama reporting, not on-chain truth; coverage gaps understate smaller protocols. 24-hour share is computed against the unfiltered global total, so filtered results retain landscape context.","alternatives":["get_dex_quote","get_chain_metrics"],"outputSchema":{"$defs":{"DexVolumeEntry":{"properties":{"protocol":{"title":"Protocol","type":"string"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"volume_24h_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Volume 24H Usd"},"volume_7d_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Volume 7D Usd"},"volume_30d_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Volume 30D Usd"},"volume_7d_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Volume 7D Change Pct"},"volume_30d_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Volume 30D Change Pct"},"volume_share_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Volume Share Pct"},"chains":{"items":{"type":"string"},"title":"Chains","type":"array"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Error"},"error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Error Type"}},"required":["protocol","slug","category","volume_24h_usd","volume_7d_usd","volume_30d_usd","volume_7d_change_pct","volume_30d_change_pct","volume_share_pct","chains"],"title":"DexVolumeEntry","type":"object"}},"properties":{"dexes":{"items":{"$ref":"#/$defs/DexVolumeEntry"},"title":"Dexes","type":"array"},"total_matching":{"title":"Total Matching","type":"integer"},"total_available":{"title":"Total Available","type":"integer"},"volume_share_basis":{"title":"Volume Share Basis","type":"string"},"note":{"title":"Note","type":"string"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Error"},"error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Error Type"}},"required":["dexes","total_matching","total_available","volume_share_basis","note"],"title":"GetDexVolumeOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"get_defi_positions","description":"Block-accurate DeFi positions for a wallet across Aave v3, Compound v3, Uniswap v3 LP, and Lido on Ethereum or Base. Returns Aave account health (collateral, debt, health factor, LTV) with per-reserve breakdown, Compound v3 market positions, Uniswap v3 LP positions by token ID, and on Ethereum the Lido stETH/wstETH balances with the current wstETH-to-stETH equivalent. Per-protocol failures are isolated — other protocols still return.","inputSchema":{"properties":{"wallet_address":{"description":"Wallet address (0x…)","title":"Wallet Address","type":"string"},"chain_id":{"default":1,"description":"Chain ID (1=Ethereum, 8453=Base)","title":"Chain Id","type":"integer"}},"required":["wallet_address"],"title":"GetDefiPositionsInput","type":"object"},"title":"Get Defi Positions","annotations":{"readOnlyHint":true},"use_when":"Use when a block-accurate single-wallet protocol snapshot is needed, including health factor and LP position detail. For broad all-chain discovery or net worth across many protocols use get_wallet_positions instead.","limitations":"On-chain RPC view of four protocol families on Ethereum and Base only; does not discover wallets' unknown or long-tail protocol positions. Compound v3 reports only a boolean liquidation flag — never state a numeric Compound health factor. Errors list which protocols were unavailable.","alternatives":["get_wallet_positions","get_liquidation_risk","get_wallet_portfolio"],"outputSchema":{"$defs":{"AavePosition":{"properties":{"total_collateral_usd":{"title":"Total Collateral Usd","type":"number"},"total_debt_usd":{"title":"Total Debt Usd","type":"number"},"available_borrows_usd":{"title":"Available Borrows Usd","type":"number"},"ltv_bps":{"title":"Ltv Bps","type":"integer"},"liquidation_threshold_bps":{"title":"Liquidation Threshold Bps","type":"integer"},"health_factor":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Health Factor"},"health_factor_status":{"title":"Health Factor Status","type":"string"},"reserves":{"items":{"$ref":"#/$defs/AaveReservePosition"},"title":"Reserves","type":"array"}},"required":["total_collateral_usd","total_debt_usd","available_borrows_usd","ltv_bps","liquidation_threshold_bps","health_factor","health_factor_status","reserves"],"title":"AavePosition","type":"object"},"AaveReservePosition":{"properties":{"symbol":{"title":"Symbol","type":"string"},"asset_address":{"title":"Asset Address","type":"string"},"supplied_amount":{"title":"Supplied Amount","type":"string"},"variable_debt_amount":{"title":"Variable Debt Amount","type":"string"},"stable_debt_amount":{"title":"Stable Debt Amount","type":"string"},"usage_as_collateral":{"title":"Usage As Collateral","type":"boolean"}},"required":["symbol","asset_address","supplied_amount","variable_debt_amount","stable_debt_amount","usage_as_collateral"],"title":"AaveReservePosition","type":"object"},"CompoundCollateral":{"properties":{"asset_address":{"title":"Asset Address","type":"string"},"amount":{"title":"Amount","type":"string"},"borrow_collateral_factor":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Borrow Collateral Factor"},"liquidate_collateral_factor":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Liquidate Collateral Factor"}},"required":["asset_address","amount"],"title":"CompoundCollateral","type":"object"},"CompoundMarketPosition":{"properties":{"market_name":{"title":"Market Name","type":"string"},"market_address":{"title":"Market Address","type":"string"},"base_asset_symbol":{"title":"Base Asset Symbol","type":"string"},"base_asset_address":{"title":"Base Asset Address","type":"string"},"supplied_amount":{"title":"Supplied Amount","type":"string"},"borrowed_amount":{"title":"Borrowed Amount","type":"string"},"collateral":{"items":{"$ref":"#/$defs/CompoundCollateral"},"title":"Collateral","type":"array"},"is_liquidatable":{"title":"Is Liquidatable","type":"boolean"}},"required":["market_name","market_address","base_asset_symbol","base_asset_address","supplied_amount","borrowed_amount","collateral","is_liquidatable"],"title":"CompoundMarketPosition","type":"object"},"LidoStakingPosition":{"properties":{"steth_balance":{"title":"Steth Balance","type":"string"},"wsteth_balance":{"title":"Wsteth Balance","type":"string"},"wsteth_steth_equivalent":{"title":"Wsteth Steth Equivalent","type":"string"},"total_steth_equivalent":{"title":"Total Steth Equivalent","type":"string"}},"required":["steth_balance","wsteth_balance","wsteth_steth_equivalent","total_steth_equivalent"],"title":"LidoStakingPosition","type":"object"},"ProtocolErrorInfo":{"properties":{"protocol":{"title":"Protocol","type":"string"},"error":{"title":"Error","type":"string"}},"required":["protocol","error"],"title":"ProtocolErrorInfo","type":"object"},"UniswapV3Position":{"properties":{"token_id":{"title":"Token Id","type":"string"},"token0_address":{"title":"Token0 Address","type":"string"},"token0_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Token0 Symbol"},"token1_address":{"title":"Token1 Address","type":"string"},"token1_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Token1 Symbol"},"fee_tier_raw":{"title":"Fee Tier Raw","type":"integer"},"tick_lower":{"title":"Tick Lower","type":"integer"},"tick_upper":{"title":"Tick Upper","type":"integer"},"liquidity":{"title":"Liquidity","type":"string"},"tokens_owed_0":{"title":"Tokens Owed 0","type":"string"},"tokens_owed_1":{"title":"Tokens Owed 1","type":"string"},"status":{"title":"Status","type":"string"}},"required":["token_id","token0_address","token1_address","fee_tier_raw","tick_lower","tick_upper","liquidity","tokens_owed_0","tokens_owed_1","status"],"title":"UniswapV3Position","type":"object"}},"properties":{"wallet_address":{"title":"Wallet Address","type":"string"},"chain_id":{"title":"Chain Id","type":"integer"},"data_block_number":{"title":"Data Block Number","type":"integer"},"aave_v3":{"anyOf":[{"$ref":"#/$defs/AavePosition"},{"type":"null"}],"default":null},"compound_v3":{"items":{"$ref":"#/$defs/CompoundMarketPosition"},"title":"Compound V3","type":"array"},"uniswap_v3":{"items":{"$ref":"#/$defs/UniswapV3Position"},"title":"Uniswap V3","type":"array"},"lido_staking":{"anyOf":[{"$ref":"#/$defs/LidoStakingPosition"},{"type":"null"}],"default":null},"errors":{"items":{"$ref":"#/$defs/ProtocolErrorInfo"},"title":"Errors","type":"array"},"note":{"default":"On-chain position snapshot at data_block_number. Aave USD values are from the Aave oracle (base currency = USD, 8 decimals on Ethereum/Base). Compound collateral and Uniswap v3 amounts are raw integer units — divide by 10**decimals to format. Compound collateral factors are decimals (e.g., 0.90 = 90%) when available from Comet getAssetInfo. Token symbols are resolved for well-known tokens; None means unrecognised — do NOT call read_contract, web_search, or any external lookup to identify these tokens. Report them as 'unrecognized token (0x…)' in the final answer and move on. Uniswap v3 liquidity is returned raw (no underlying token valuation in v1); tokensOwed0/1 are uncollected fees only. Lido staking contains canonical Ethereum stETH/wstETH balances and a current wstETH-to-stETH equivalent in raw integer units; it does not include APR, rewards accounting, validator positions, or withdrawal queue status. Lido staking is null on Base because its wstETH representation there is bridged. If a protocol is missing (e.g., aave_v3 is null) and appears in errors, its risk could not be verified from this snapshot and must not be treated as no debt. Does not include COMP accruals or unlisted protocols.","title":"Note","type":"string"}},"required":["wallet_address","chain_id","data_block_number"],"title":"GetDefiPositionsOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":13000,"unit":"call"}}},{"name":"get_gas_price","description":"Get current EIP-1559 gas fees on Ethereum or Base: base fee, priority fee, next-block base fee estimate, and congestion (gas_used_ratio >0.5 busy, >0.9 very congested). Optional USD estimates cover a simple transfer and a swap-like transaction. Cached 10 seconds per chain.","inputSchema":{"properties":{"chain_id":{"default":1,"description":"Chain ID (1=Ethereum, 8453=Base)","title":"Chain Id","type":"integer"},"include_usd_estimate":{"default":false,"description":"If true, include ETH spot price and rough USD cost estimates for a simple transfer (21k gas) and a swap-like transaction (150k gas).","title":"Include Usd Estimate","type":"boolean"}},"title":"GetGasPriceInput","type":"object"},"title":"Get Gas Price","annotations":{"readOnlyHint":true},"use_when":"Use before advising a transaction — to time execution, size a gas budget, or judge congestion. Call once per decision; the 10-second cache makes rapid re-calls pointless.","limitations":"Point-in-time estimate that changes every block; USD figures are rough heuristics at 21k/150k gas, not an execution quote. Ethereum mainnet and Base only.","alternatives":["get_block","get_dex_quote"],"outputSchema":{"properties":{"chain_id":{"title":"Chain Id","type":"integer"},"gas_price_gwei":{"title":"Gas Price Gwei","type":"string"},"base_fee_gwei":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Fee Gwei"},"priority_fee_gwei":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Priority Fee Gwei"},"next_base_fee_gwei":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Base Fee Gwei"},"gas_used_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gas Used Ratio"},"eth_price_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Eth Price Usd"},"estimated_transfer_cost_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Estimated Transfer Cost Usd"},"estimated_swap_cost_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Estimated Swap Cost Usd"}},"required":["chain_id","gas_price_gwei","base_fee_gwei","priority_fee_gwei","next_base_fee_gwei","gas_used_ratio"],"title":"GetGasPriceOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"get_lending_rates","description":"Get current on-chain lending supply/borrow APYs for Aave v3 reserves and Compound v3 markets on Ethereum or Base, with per-asset snapshots and Compound utilization. Use for protocol-specific yield comparisons such as USDC on Aave vs Compound.","inputSchema":{"properties":{"protocol":{"default":"all","description":"Protocol to query: 'aave-v3', 'compound-v3', or 'all'.","enum":["all","aave-v3","compound-v3"],"title":"Protocol","type":"string"},"chain_id":{"default":1,"description":"Chain ID (1=Ethereum, 8453=Base).","title":"Chain Id","type":"integer"},"assets":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Optional asset-symbol filter (e.g., ['USDC','DAI']). Case-insensitive. Max 20 symbols.","title":"Assets"}},"title":"GetLendingRatesInput","type":"object"},"title":"Get Lending Rates","annotations":{"readOnlyHint":true},"use_when":"Use for protocol-specific lending-rate questions (e.g. 'Aave vs Compound USDC rates'). Prefer over get_yield_rates when the protocols are known; use get_yield_rates for broad pool discovery across many protocols. Do not fall back to web_search when this returns errors — report them.","limitations":"On-chain snapshots of Aave v3 and Compound v3 on Ethereum and Base only; not a multi-protocol yield aggregator. Rates are point-in-time and change per block. Returns an errors list — report each unavailable protocol explicitly and treat empty rates with empty errors as transient RPC unavailability.","alternatives":["get_yield_rates","get_defi_positions","get_liquidation_risk"],"outputSchema":{"$defs":{"LendingRateEntry":{"properties":{"protocol":{"enum":["aave-v3","compound-v3"],"title":"Protocol","type":"string"},"chain_id":{"title":"Chain Id","type":"integer"},"market_name":{"title":"Market Name","type":"string"},"asset_symbol":{"title":"Asset Symbol","type":"string"},"supply_apy_pct":{"title":"Supply Apy Pct","type":"number"},"borrow_apy_pct":{"title":"Borrow Apy Pct","type":"number"},"utilization_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Utilization Pct"},"source":{"const":"on-chain","default":"on-chain","title":"Source","type":"string"}},"required":["protocol","chain_id","market_name","asset_symbol","supply_apy_pct","borrow_apy_pct"],"title":"LendingRateEntry","type":"object"}},"properties":{"protocol":{"title":"Protocol","type":"string"},"chain_id":{"title":"Chain Id","type":"integer"},"data_block_number":{"title":"Data Block Number","type":"integer"},"rates":{"items":{"$ref":"#/$defs/LendingRateEntry"},"title":"Rates","type":"array"},"errors":{"items":{"type":"string"},"title":"Errors","type":"array"},"note":{"default":"On-chain lending market snapshot at data_block_number. Aave rates are derived from ProtocolDataProvider.getReserveData (ray-scaled). Compound rates are derived from Comet getUtilization/getSupplyRate/getBorrowRate (per-second 1e18-scaled), annualized to APY.","title":"Note","type":"string"}},"required":["protocol","chain_id","data_block_number","rates"],"title":"GetLendingRatesOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"get_liquidation_risk","description":"Assess DeFi liquidation risk for up to 50 wallets across Aave v3 and Compound v3 on Ethereum or Base. Returns per-wallet health factor, tiered risk classification (liquidatable, critical, warning, caution, healthy, no_debt), and an overall_tier aggregate. Per-protocol failures are isolated — one protocol's RPC error does not blank the other's result.","inputSchema":{"properties":{"wallet_addresses":{"description":"Wallet addresses to assess (max 50; duplicates are silently removed).","items":{"type":"string"},"minItems":1,"title":"Wallet Addresses","type":"array"},"chain_id":{"default":1,"description":"Chain ID (1=Ethereum, 8453=Base)","title":"Chain Id","type":"integer"}},"required":["wallet_addresses"],"title":"GetLiquidationRiskInput","type":"object"},"title":"Get Liquidation Risk","annotations":{"readOnlyHint":true},"use_when":"Use for multi-wallet batch risk assessment (2+ wallets). For a single-wallet DeFi analysis use get_defi_positions, which already includes risk metrics. Use assess_counterparty_risk when the question is counterparty trust rather than position health.","limitations":"View-only scan of Aave v3 and Compound v3 on Ethereum and Base with hardcoded market addresses; not a liquidation simulation or guarantee. Compound v3 exposes only a boolean liquidation flag — no numeric health factor. Duplicate wallet addresses are silently removed.","alternatives":["get_defi_positions","assess_counterparty_risk","get_wallet_positions"],"outputSchema":{"$defs":{"AaveRisk":{"properties":{"health_factor":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Health Factor"},"risk_tier":{"title":"Risk Tier","type":"string"},"total_collateral_usd":{"title":"Total Collateral Usd","type":"number"},"total_debt_usd":{"title":"Total Debt Usd","type":"number"},"liquidation_threshold_bps":{"title":"Liquidation Threshold Bps","type":"integer"},"ltv_bps":{"title":"Ltv Bps","type":"integer"}},"required":["health_factor","risk_tier","total_collateral_usd","total_debt_usd","liquidation_threshold_bps","ltv_bps"],"title":"AaveRisk","type":"object"},"CompoundRisk":{"properties":{"market_name":{"title":"Market Name","type":"string"},"market_address":{"title":"Market Address","type":"string"},"base_asset_symbol":{"title":"Base Asset Symbol","type":"string"},"is_liquidatable":{"title":"Is Liquidatable","type":"boolean"},"borrow_balance_raw":{"title":"Borrow Balance Raw","type":"string"},"risk_tier":{"title":"Risk Tier","type":"string"}},"required":["market_name","market_address","base_asset_symbol","is_liquidatable","borrow_balance_raw","risk_tier"],"title":"CompoundRisk","type":"object"},"ProtocolErrorInfo":{"properties":{"protocol":{"title":"Protocol","type":"string"},"error":{"title":"Error","type":"string"}},"required":["protocol","error"],"title":"ProtocolErrorInfo","type":"object"},"RiskSummary":{"properties":{"total_wallets":{"title":"Total Wallets","type":"integer"},"liquidatable_count":{"title":"Liquidatable Count","type":"integer"},"critical_count":{"title":"Critical Count","type":"integer"},"warning_count":{"title":"Warning Count","type":"integer"},"caution_count":{"title":"Caution Count","type":"integer"},"healthy_count":{"title":"Healthy Count","type":"integer"},"no_debt_count":{"title":"No Debt Count","type":"integer"}},"required":["total_wallets","liquidatable_count","critical_count","warning_count","caution_count","healthy_count","no_debt_count"],"title":"RiskSummary","type":"object"},"WalletRiskResult":{"properties":{"wallet_address":{"title":"Wallet Address","type":"string"},"chain_id":{"title":"Chain Id","type":"integer"},"aave":{"anyOf":[{"$ref":"#/$defs/AaveRisk"},{"type":"null"}],"default":null},"compound":{"items":{"$ref":"#/$defs/CompoundRisk"},"title":"Compound","type":"array"},"overall_tier":{"title":"Overall Tier","type":"string"},"errors":{"items":{"$ref":"#/$defs/ProtocolErrorInfo"},"title":"Errors","type":"array"}},"required":["wallet_address","chain_id","overall_tier"],"title":"WalletRiskResult","type":"object"}},"properties":{"chain_id":{"title":"Chain Id","type":"integer"},"data_block_number":{"title":"Data Block Number","type":"integer"},"results":{"items":{"$ref":"#/$defs/WalletRiskResult"},"title":"Results","type":"array"},"summary":{"$ref":"#/$defs/RiskSummary"},"note":{"default":"On-chain liquidation-risk snapshot at data_block_number. Aave risk_tier is derived from the numeric health factor: liquidatable (<1.0), critical (<1.05), warning (<1.15), caution (<1.5), healthy (≥1.5). Compound v3 exposes only a boolean isLiquidatable — a numeric health factor is not available from this tool; do not attempt to compute, estimate, or infer it via additional tool calls. Do not infer a Compound liquidation or breach price from this output. overall_tier is the worst tier across protocols for each wallet. Aave USD values are base-currency 8-decimal from the Aave oracle. Duplicate wallet addresses in the request are deduplicated silently.","title":"Note","type":"string"}},"required":["chain_id","data_block_number","results","summary"],"title":"GetLiquidationRiskOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":10000,"unit":"call"}}},{"name":"get_token_approvals","description":"Block-accurate audit of ERC-20 allowances for a wallet across curated DeFi spenders (Uniswap, Aave, Compound, 1inch, 0x, OpenSea) on Ethereum or Base. Flags unlimited approvals by risk level (high=unknown spender, medium=trusted protocol, low=bounded). Use before swaps or after security incidents to detect active exploit vectors.","inputSchema":{"properties":{"wallet_address":{"description":"Wallet address (0x…)","title":"Wallet Address","type":"string"},"chain_id":{"default":1,"description":"Chain ID (1=Ethereum, 8453=Base)","title":"Chain Id","type":"integer"},"tokens":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Token contract addresses to check (max 50). Defaults to the platform tracked token list.","title":"Tokens"},"spenders":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Spender contract addresses to check (max 20). Defaults to the curated DeFi protocol list.","title":"Spenders"}},"required":["wallet_address"],"title":"GetTokenApprovalsInput","type":"object"},"title":"Get Token Approvals","annotations":{"readOnlyHint":true},"use_when":"Use for a free, block-accurate Ethereum/Base check of an address's exposure to the curated spender list. For broad all-chain spender discovery, hacked/abandoned flags, or NFT-adjacent exposure use get_wallet_approvals instead.","limitations":"Covers only the tracked-asset registry and curated spenders — untracked tokens and custom spenders are excluded. Does not inspect NFT approvals or off-chain Permit2 sub-permits. An error field marks results as incomplete rather than clean.","alternatives":["get_wallet_approvals","assess_counterparty_risk"],"outputSchema":{"$defs":{"ApprovalEntry":{"properties":{"token_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token Symbol"},"token_address":{"title":"Token Address","type":"string"},"spender_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Spender Name"},"spender_address":{"title":"Spender Address","type":"string"},"allowance_raw":{"title":"Allowance Raw","type":"string"},"allowance_formatted":{"title":"Allowance Formatted","type":"string"},"is_unlimited":{"title":"Is Unlimited","type":"boolean"},"is_permit2":{"title":"Is Permit2","type":"boolean"},"risk_level":{"enum":["low","medium","high"],"title":"Risk Level","type":"string"}},"required":["token_symbol","token_address","spender_name","spender_address","allowance_raw","allowance_formatted","is_unlimited","is_permit2","risk_level"],"title":"ApprovalEntry","type":"object"},"RiskSummary":{"properties":{"total_approvals":{"title":"Total Approvals","type":"integer"},"unlimited_approvals":{"title":"Unlimited Approvals","type":"integer"},"high_risk_approvals":{"title":"High Risk Approvals","type":"integer"},"unknown_spenders":{"title":"Unknown Spenders","type":"integer"}},"required":["total_approvals","unlimited_approvals","high_risk_approvals","unknown_spenders"],"title":"RiskSummary","type":"object"}},"properties":{"wallet_address":{"title":"Wallet Address","type":"string"},"chain_id":{"title":"Chain Id","type":"integer"},"approvals":{"items":{"$ref":"#/$defs/ApprovalEntry"},"title":"Approvals","type":"array"},"risk_summary":{"$ref":"#/$defs/RiskSummary"},"note":{"title":"Note","type":"string"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Error"}},"required":["wallet_address","chain_id","approvals","risk_summary","note"],"title":"GetTokenApprovalsOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"get_wallet_approvals","description":"Inspect a wallet's current ERC-20 token authorization exposure on one DeBank-supported chain. Returns discovered spenders, USD exposure, protocol attribution, and hacked or abandoned protocol flags. This is broader than the curated block-accurate get_token_approvals tool.","inputSchema":{"properties":{"wallet_address":{"description":"EVM wallet address (0x-prefixed)","title":"Wallet Address","type":"string"},"chain_id":{"description":"DeBank chain identifier, for example eth, arb, or base","title":"Chain Id","type":"string"}},"required":["wallet_address","chain_id"],"title":"GetWalletApprovalsInput","type":"object"},"title":"Get Wallet Approvals","annotations":{"readOnlyHint":true},"use_when":"Use when broad spender discovery or cross-chain security screening is needed. Call once per chain because DeBank requires a chain_id. Use get_token_approvals for a free, block-accurate Ethereum or Base scan of curated tokens and spenders.","limitations":"The result is third-party analytics and may be stale. It covers token approvals only, not NFT approvals or off-chain Permit2 sub-permits; each chain consumes a separate billable provider call.","alternatives":["get_token_approvals"],"outputSchema":{"$defs":{"DataProvenance":{"description":"Machine-readable source and freshness metadata for a tool response.","properties":{"provider":{"title":"Provider","type":"string"},"source_urls":{"items":{"type":"string"},"title":"Source Urls","type":"array"},"retrieved_at":{"title":"Retrieved At","type":"string"},"source_fetched_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Fetched At"},"cache_hit":{"default":false,"title":"Cache Hit","type":"boolean"},"cache_age_seconds":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Cache Age Seconds"},"cache_ttl_seconds":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Cache Ttl Seconds"}},"required":["provider","retrieved_at"],"title":"DataProvenance","type":"object"},"WalletApprovalSpender":{"properties":{"id":{"title":"Id","type":"string"},"value":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"null"}],"default":null,"title":"Value"},"exposure_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Exposure Usd"},"protocol":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"default":null,"title":"Protocol"},"is_contract":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Is Contract"},"is_open_source":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Is Open Source"},"is_hacked":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Is Hacked"},"is_abandoned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Is Abandoned"}},"required":["id"],"title":"WalletApprovalSpender","type":"object"},"WalletApprovalToken":{"properties":{"id":{"title":"Id","type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Symbol"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Logo Url"},"chain":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Chain"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Price"},"balance":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Balance"},"spenders":{"items":{"$ref":"#/$defs/WalletApprovalSpender"},"title":"Spenders","type":"array"},"sum_exposure_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Sum Exposure Usd"},"exposure_balance":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Exposure Balance"}},"required":["id"],"title":"WalletApprovalToken","type":"object"},"WalletApprovalsError":{"properties":{"operation":{"title":"Operation","type":"string"},"error_type":{"title":"Error Type","type":"string"},"message":{"title":"Message","type":"string"}},"required":["operation","error_type","message"],"title":"WalletApprovalsError","type":"object"}},"properties":{"wallet_address":{"title":"Wallet Address","type":"string"},"chain_id":{"title":"Chain Id","type":"string"},"approvals":{"items":{"$ref":"#/$defs/WalletApprovalToken"},"title":"Approvals","type":"array"},"data_complete":{"title":"Data Complete","type":"boolean"},"errors":{"items":{"$ref":"#/$defs/WalletApprovalsError"},"title":"Errors","type":"array"},"provenance":{"$ref":"#/$defs/DataProvenance"},"note":{"default":"DeBank authorization exposure is analytics data for one chain and may be stale. It does not inspect NFT approvals or off-chain Permit2 sub-permits.","title":"Note","type":"string"}},"required":["wallet_address","chain_id","data_complete","provenance"],"title":"GetWalletApprovalsOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"get_token_price","description":"Get current price, 24h change, market cap, FDV, and volume for one or more crypto tokens. Accepts ticker symbols, full names, or CoinGecko IDs; unknown symbols resolve automatically. Batch up to 50 tokens. Reuse price_usd/value_usd already returned by get_wallet_portfolio instead of re-calling.","inputSchema":{"properties":{"tokens":{"description":"Token symbols or CoinGecko IDs (e.g. ['BTC', 'ETH', 'SOL'])","items":{"type":"string"},"maxItems":50,"minItems":1,"title":"Tokens","type":"array"},"vs_currency":{"default":"usd","description":"Quote currency (usd, eur, gbp, btc, eth)","title":"Vs Currency","type":"string"}},"required":["tokens"],"title":"GetTokenPriceInput","type":"object"},"title":"Get Token Price","annotations":{"readOnlyHint":true},"use_when":"Use for spot pricing of named tokens — including batched multi-token queries. Do not call for tokens whose price get_wallet_portfolio already returned, or for address-only unknown tokens (report them as unrecognized). For historical windows use get_token_price_historical.","limitations":"CoinGecko spot data; point-in-time and not an executable swap quote. Bare 0x addresses are not resolvable and should be treated as unknown tokens.","alternatives":["get_token_price_historical","get_wallet_portfolio","get_dex_quote"],"outputSchema":{"$defs":{"TokenPriceEntry":{"properties":{"id":{"title":"Id","type":"string"},"symbol":{"title":"Symbol","type":"string"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price"},"market_cap":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Market Cap"},"volume_24h":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Volume 24H"},"change_24h_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Change 24H Pct"},"fully_diluted_valuation":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Fully Diluted Valuation"}},"required":["id","symbol","price","market_cap","volume_24h","change_24h_pct"],"title":"TokenPriceEntry","type":"object"}},"properties":{"vs_currency":{"title":"Vs Currency","type":"string"},"prices":{"items":{"$ref":"#/$defs/TokenPriceEntry"},"title":"Prices","type":"array"}},"required":["vs_currency","prices"],"title":"GetTokenPriceOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"get_protocol_tvl","description":"Get Total Value Locked for one or many DeFi protocols from DeFiLlama: current USD TVL, 7/30-day change, fees and revenue when reported, per-chain breakdown, and optional daily historical series. Batch multiple protocols via protocols=[...] — batch responses return one compact economic summary per protocol; single-protocol calls add chain and historical detail. Supports 3,000+ protocols; use DeFiLlama slugs ('aave-v3', 'uniswap-v3'); common aliases are auto-corrected.","inputSchema":{"properties":{"protocol":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"DeFiLlama protocol slug (e.g. 'aave-v3', 'uniswap-v3', 'curve-dex'). Use lowercase with hyphens as shown on DeFiLlama. Tip: 'aave' works for the combined Aave TVL; 'aave-v3' for V3 only. Optional when using batch mode via protocols=[...].","title":"Protocol"},"protocols":{"description":"Optional batch mode: list of DeFiLlama protocol slugs. When provided, the tool returns one TVL result object per protocol.","items":{"type":"string"},"title":"Protocols","type":"array"},"include_historical":{"default":false,"description":"If true, return a daily historical TVL series for the requested window.","title":"Include Historical","type":"boolean"},"days":{"default":30,"description":"Lookback window in days for the historical series (only used when include_historical=True).","maximum":365,"minimum":1,"title":"Days","type":"integer"}},"title":"GetProtocolTvlInput","type":"object"},"title":"Get Protocol Tvl","annotations":{"readOnlyHint":true},"use_when":"Use for protocol-level economic questions — size, growth, fees, or revenue of a specific protocol. For 2+ protocols always batch in one call rather than calling per-protocol. Pass include_historical=true with days when a trend is needed; without it the response is a current TVL scalar. For ecosystem-level chain comparisons use get_chain_metrics instead.","limitations":"Third-party DeFiLlama analytics, not on-chain truth. Upstream revenue failures surface as revenue_error_type and null economic fields are data gaps — never fabricate values for them.","alternatives":["get_chain_metrics","get_yield_rates","get_dex_volume"],"outputSchema":{"anyOf":[{"properties":{"protocol":{"title":"Protocol","type":"string"},"current_tvl_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Current Tvl Usd"},"tvl_7d_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Tvl 7D Change Pct"},"tvl_30d_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Tvl 30D Change Pct"},"chain_breakdown":{"items":{"$ref":"#/$defs/ChainTvlEntry"},"title":"Chain Breakdown","type":"array"},"historical_series":{"anyOf":[{"items":{"$ref":"#/$defs/DailyTvlPoint"},"type":"array"},{"type":"null"}],"title":"Historical Series"},"current_fees_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Current Fees Usd"},"fees_7d_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Fees 7D Change Pct"},"fees_30d_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Fees 30D Change Pct"},"current_revenue_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Current Revenue Usd"},"revenue_7d_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Revenue 7D Change Pct"},"revenue_30d_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Revenue 30D Change Pct"},"revenue_error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Revenue Error Type"},"note":{"title":"Note","type":"string"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Error"},"error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Error Type"},"provenance":{"anyOf":[{"$ref":"#/$defs/DataProvenance"},{"type":"null"}],"default":null,"description":"Source and freshness metadata for the DeFiLlama response."}},"required":["protocol","current_tvl_usd","tvl_7d_change_pct","tvl_30d_change_pct","chain_breakdown","historical_series","note"],"title":"GetProtocolTvlOutput","type":"object"},{"type":"array","items":{"properties":{"protocol":{"title":"Protocol","type":"string"},"current_tvl_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Current Tvl Usd"},"tvl_7d_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Tvl 7D Change Pct"},"tvl_30d_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Tvl 30D Change Pct"},"chain_breakdown":{"items":{"$ref":"#/$defs/ChainTvlEntry"},"title":"Chain Breakdown","type":"array"},"historical_series":{"anyOf":[{"items":{"$ref":"#/$defs/DailyTvlPoint"},"type":"array"},{"type":"null"}],"title":"Historical Series"},"current_fees_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Current Fees Usd"},"fees_7d_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Fees 7D Change Pct"},"fees_30d_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Fees 30D Change Pct"},"current_revenue_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Current Revenue Usd"},"revenue_7d_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Revenue 7D Change Pct"},"revenue_30d_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Revenue 30D Change Pct"},"revenue_error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Revenue Error Type"},"note":{"title":"Note","type":"string"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Error"},"error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Error Type"},"provenance":{"anyOf":[{"$ref":"#/$defs/DataProvenance"},{"type":"null"}],"default":null,"description":"Source and freshness metadata for the DeFiLlama response."}},"required":["protocol","current_tvl_usd","tvl_7d_change_pct","tvl_30d_change_pct","chain_breakdown","historical_series","note"],"title":"GetProtocolTvlOutput","type":"object"},"minItems":1}],"$defs":{"ChainTvlEntry":{"properties":{"chain":{"title":"Chain","type":"string"},"tvl_usd":{"title":"Tvl Usd","type":"number"}},"required":["chain","tvl_usd"],"title":"ChainTvlEntry","type":"object"},"DailyTvlPoint":{"properties":{"date":{"title":"Date","type":"string"},"tvl_usd":{"title":"Tvl Usd","type":"number"}},"required":["date","tvl_usd"],"title":"DailyTvlPoint","type":"object"},"DataProvenance":{"description":"Machine-readable source and freshness metadata for a tool response.","properties":{"provider":{"title":"Provider","type":"string"},"source_urls":{"items":{"type":"string"},"title":"Source Urls","type":"array"},"retrieved_at":{"title":"Retrieved At","type":"string"},"source_fetched_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Fetched At"},"cache_hit":{"default":false,"title":"Cache Hit","type":"boolean"},"cache_age_seconds":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Cache Age Seconds"},"cache_ttl_seconds":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Cache Ttl Seconds"}},"required":["provider","retrieved_at"],"title":"DataProvenance","type":"object"}}},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"get_token_price_historical","description":"Get historical crypto prices over a 1–365 day window: period statistics (start, end, % change, high, low), a downsampled daily series, high_30d, std_30d, and dca_baseline_90d. Use for period comparisons and trend analysis; prefer over web_search for time-comparative financial queries. Pass stats_only=true when the daily series is unnecessary.","inputSchema":{"properties":{"tokens":{"description":"Token symbols or CoinGecko IDs (e.g. ['BTC', 'ETH']). Max 10 per call.","items":{"type":"string"},"maxItems":10,"minItems":1,"title":"Tokens","type":"array"},"days":{"default":30,"description":"Lookback window in days (1–365). 1=5-min granularity, 2-90=hourly, 91+=daily.","maximum":365,"minimum":1,"title":"Days","type":"integer"},"vs_currency":{"default":"usd","description":"Quote currency (usd, eur, gbp, btc, eth). Lowercase 3–10 letters.","pattern":"^[a-z]{3,10}$","title":"Vs Currency","type":"string"},"stats_only":{"default":false,"description":"If true, omit the daily price series and return period stats plus precomputed 30-day high/volatility and 90-day DCA baseline metrics.","title":"Stats Only","type":"boolean"}},"required":["tokens"],"title":"GetTokenPriceHistoricalInput","type":"object"},"title":"Get Token Price Historical","annotations":{"readOnlyHint":true},"use_when":"Use for time-comparative financial questions — month-over-month, YTD, volatility, or DCA baselines. Prefer over web_search for such queries. Use the pre-computed stats directly; do not re-derive them with calculate.","limitations":"Daily granularity (downsampled), max 365-day window, CoinGecko coverage only. Check dca_baseline_90d_partial before relying on the baseline — incomplete history yields a partial baseline.","alternatives":["get_token_price","web_search"],"outputSchema":{"$defs":{"DailyPricePoint":{"properties":{"date":{"title":"Date","type":"string"},"price":{"title":"Price","type":"number"}},"required":["date","price"],"title":"DailyPricePoint","type":"object"},"TokenHistoricalEntry":{"properties":{"id":{"title":"Id","type":"string"},"symbol":{"title":"Symbol","type":"string"},"price_start":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Start"},"price_end":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price End"},"price_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Change Pct"},"price_high":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price High"},"price_low":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Low"},"high_30d":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Maximum raw price observation in the trailing 30 UTC days, in vs_currency.","title":"High 30D"},"std_30d":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Population standard deviation of trailing 30-day simple daily returns, as a decimal.","title":"Std 30D"},"dca_baseline_90d":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Mean of weekly daily-close samples from the preceding 90 UTC days, in vs_currency.","title":"Dca Baseline 90D"},"dca_baseline_90d_partial":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True when the DCA baseline uses incomplete 90-day history; null when unavailable.","title":"Dca Baseline 90D Partial"},"daily_prices":{"items":{"$ref":"#/$defs/DailyPricePoint"},"title":"Daily Prices","type":"array"}},"required":["id","symbol","price_start","price_end","price_change_pct","price_high","price_low","daily_prices"],"title":"TokenHistoricalEntry","type":"object"}},"properties":{"vs_currency":{"title":"Vs Currency","type":"string"},"days":{"title":"Days","type":"integer"},"tokens":{"items":{"$ref":"#/$defs/TokenHistoricalEntry"},"title":"Tokens","type":"array"}},"required":["vs_currency","days","tokens"],"title":"GetTokenPriceHistoricalOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"get_yield_rates","description":"Get DeFi yield pool rates from DeFiLlama across 1,000+ protocols and all chains: pools sorted by APY with TVL, base/reward APY, and 7d/30d mean APY context, filterable by protocol, chain, min TVL, min/max APY, and symbol. Returns up to 50 pools. For protocol-specific lending comparisons (Aave vs Compound) prefer get_lending_rates.","inputSchema":{"properties":{"protocols":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Filter by DeFiLlama project slugs (e.g. ['aave-v3', 'compound-v3']). None or empty list = include all protocols.","title":"Protocols"},"chain":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by chain name (e.g. 'Ethereum', 'Base', 'Arbitrum'). Case-insensitive. None = all chains.","title":"Chain"},"min_tvl_usd":{"default":1000000.0,"description":"Exclude pools with TVL below this threshold (USD). Default $1M filters noise.","minimum":0.0,"title":"Min Tvl Usd","type":"number"},"min_apy":{"default":0.0,"description":"Exclude pools with APY below this value (%). Default 0 includes all.","minimum":0.0,"title":"Min Apy","type":"number"},"max_apy":{"anyOf":[{"minimum":0.0,"type":"number"},{"type":"null"}],"default":null,"description":"Exclude pools with APY above this value (%). Default None = no upper bound. Use to filter out leveraged/boosted pools (e.g. max_apy=30) so genuine stablecoin yields surface.","title":"Max Apy"},"limit":{"default":20,"description":"Maximum number of pools to return, sorted by APY descending.","maximum":50,"minimum":1,"title":"Limit","type":"integer"},"symbols_any":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Optional symbol filter. If provided, include pools whose symbol field contains at least one token from this list (case-insensitive). Use held token symbols from get_wallet_portfolio to focus results.","title":"Symbols Any"},"stable_only":{"default":false,"description":"When true, return only stablecoin pools and rank by 30d mean APY first to emphasize consistency over short-term spikes.","title":"Stable Only","type":"boolean"}},"title":"GetYieldRatesInput","type":"object"},"title":"Get Yield Rates","annotations":{"readOnlyHint":true},"use_when":"Use for broad cross-protocol yield discovery. Call at most once per request — filter with min_apy, max_apy, min_tvl_usd, and symbols_any in a single call, then sort client-side rather than re-calling. For protocol-specific rate questions use get_lending_rates.","limitations":"Third-party DeFiLlama analytics; up to 50 pools per call. The `symbol` field lists underlying tokens (e.g. 'ETH-USDC') — filter client-side instead of re-calling with different arguments. Reward APY indicates reward-dependent yield; do not present spot APY as durable.","alternatives":["get_lending_rates","get_protocol_tvl","get_token_price"],"outputSchema":{"$defs":{"DataProvenance":{"description":"Machine-readable source and freshness metadata for a tool response.","properties":{"provider":{"title":"Provider","type":"string"},"source_urls":{"items":{"type":"string"},"title":"Source Urls","type":"array"},"retrieved_at":{"title":"Retrieved At","type":"string"},"source_fetched_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Fetched At"},"cache_hit":{"default":false,"title":"Cache Hit","type":"boolean"},"cache_age_seconds":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Cache Age Seconds"},"cache_ttl_seconds":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Cache Ttl Seconds"}},"required":["provider","retrieved_at"],"title":"DataProvenance","type":"object"},"YieldPoolEntry":{"properties":{"pool_id":{"title":"Pool Id","type":"string"},"project":{"title":"Project","type":"string"},"symbol":{"title":"Symbol","type":"string"},"chain":{"title":"Chain","type":"string"},"tvl_usd":{"title":"Tvl Usd","type":"number"},"apy":{"title":"Apy","type":"number"},"apy_mean_7d":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Apy Mean 7D"},"apy_mean_30d":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Apy Mean 30D"},"apy_base":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Apy Base"},"apy_reward":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Apy Reward"},"stable":{"title":"Stable","type":"boolean"},"il_risk":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Il Risk"}},"required":["pool_id","project","symbol","chain","tvl_usd","apy","apy_mean_7d","apy_mean_30d","apy_base","apy_reward","stable","il_risk"],"title":"YieldPoolEntry","type":"object"}},"properties":{"pools":{"items":{"$ref":"#/$defs/YieldPoolEntry"},"title":"Pools","type":"array"},"total_matching":{"title":"Total Matching","type":"integer"},"filters_applied":{"additionalProperties":true,"title":"Filters Applied","type":"object"},"note":{"title":"Note","type":"string"},"provenance":{"anyOf":[{"$ref":"#/$defs/DataProvenance"},{"type":"null"}],"default":null,"description":"Source and freshness metadata for the DeFiLlama response."}},"required":["pools","total_matching","filters_applied","note"],"title":"GetYieldRatesOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"web_search","description":"Real-time web search via Tavily for current events, fact-checking, and research. Use search_depth='advanced' for complex queries (higher quality, higher cost) and topic='news' or 'finance' for headlines or market information.","inputSchema":{"properties":{"query":{"description":"Search query","maxLength":500,"title":"Query","type":"string"},"num_results":{"default":5,"description":"Number of web search results to return (1–20, default 5).","maximum":20,"minimum":1,"title":"Num Results","type":"integer"},"search_depth":{"default":"basic","description":"'basic' for fast results, 'advanced' for thorough research (higher cost)","enum":["basic","advanced"],"title":"Search Depth","type":"string"},"topic":{"default":"general","description":"Search topic: 'general' for web, 'news' for headlines, 'finance' for markets","enum":["general","news","finance"],"title":"Topic","type":"string"}},"required":["query"],"title":"WebSearchInput","type":"object"},"title":"Web Search","annotations":{"readOnlyHint":true},"use_when":"Choose when the task needs current, external, or factual information not available from on-chain or local data — e.g. news, prices, documentation, or fact-checking.","limitations":"Returns web snippets, not raw page bodies; results depend on Tavily coverage. Advanced depth costs more. Not a substitute for on-chain tools like get_token_price.","alternatives":["get_token_price","http_fetch"],"outputSchema":{"$defs":{"SearchResult":{"properties":{"title":{"title":"Title","type":"string"},"url":{"title":"Url","type":"string"},"snippet":{"title":"Snippet","type":"string"},"score":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Score"}},"required":["title","url","snippet"],"title":"SearchResult","type":"object"}},"properties":{"query":{"title":"Query","type":"string"},"num_results":{"title":"Num Results","type":"integer"},"results":{"items":{"$ref":"#/$defs/SearchResult"},"title":"Results","type":"array"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Note"}},"required":["query","num_results","results"],"title":"WebSearchOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":15000,"unit":"call"}}},{"name":"count_text_stats","description":"Return word, character, sentence, and paragraph counts plus average words per sentence for a given text, for length checks and content sizing decisions.","inputSchema":{"properties":{"text":{"description":"Text to summarize","maxLength":10000,"title":"Text","type":"string"}},"required":["text"],"title":"SummarizeTextInput","type":"object"},"title":"Count Text Stats","annotations":{"readOnlyHint":true},"use_when":"Use when output length must be validated or reported — e.g. verifying a summary meets a length contract or comparing document sizes. Do not use for semantic summarization; it counts only.","limitations":"Pure counting on the provided text — no language detection, no reading-level or sentiment analysis, and no retrieval of external content.","alternatives":["web_search","http_fetch"],"outputSchema":{"properties":{"character_count":{"title":"Character Count","type":"integer"},"word_count":{"title":"Word Count","type":"integer"},"sentence_count":{"title":"Sentence Count","type":"integer"},"paragraph_count":{"title":"Paragraph Count","type":"integer"},"average_words_per_sentence":{"title":"Average Words Per Sentence","type":"number"}},"required":["character_count","word_count","sentence_count","paragraph_count","average_words_per_sentence"],"title":"SummarizeTextOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":0,"unit":"call"}}},{"name":"http_fetch","description":"Fetch a web page and return its main text content, cleaned of markup. Use to read articles, documentation, and other resources referenced by URL. Blocks private and cloud-metadata addresses and re-validates every redirect hop.","inputSchema":{"properties":{"url":{"description":"URL to fetch (http or https only)","maxLength":2000,"minLength":10,"title":"Url","type":"string"},"max_chars":{"default":8000,"description":"Maximum characters of extracted content to return","maximum":50000,"minimum":100,"title":"Max Chars","type":"integer"}},"required":["url"],"title":"HttpFetchInput","type":"object"},"title":"Http Fetch","annotations":{"readOnlyHint":true},"use_when":"Use when a known URL's content is needed and structured tools cannot answer — e.g. reading a linked document or API docs. For general factual lookup prefer web_search; for token prices prefer get_token_price.","limitations":"Read-only GET-style extraction returning cleaned text, not raw HTML or binary content. JS-heavy pages may yield little content; private/internal network targets are deliberately unreachable.","alternatives":["web_search","get_token_price"],"outputSchema":{"properties":{"url":{"title":"Url","type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"content":{"title":"Content","type":"string"},"content_length":{"title":"Content Length","type":"integer"},"truncated":{"title":"Truncated","type":"boolean"}},"required":["url","title","content","content_length","truncated"],"title":"HttpFetchOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"get_eth_balance","description":"Get the exact on-chain native ETH balance of an address on Ethereum or Base, in wei and ether. get_wallet_portfolio already includes native ETH in its holdings — call this only for a standalone balance without a portfolio scan.","inputSchema":{"properties":{"address":{"description":"Ethereum address (0x…)","title":"Address","type":"string"},"chain_id":{"default":1,"description":"Chain ID (1=Ethereum, 8453=Base)","title":"Chain Id","type":"integer"}},"required":["address"],"title":"GetEthBalanceInput","type":"object"},"title":"Get Eth Balance","annotations":{"readOnlyHint":true},"use_when":"Use when a wallet's gas-availability or standalone ETH amount must be verified block-accurately. Do not call after or alongside get_wallet_portfolio — the holdings list already includes native ETH.","limitations":"Native ETH only; ERC-20 balances require get_erc20_balance. Requires an EIP-55 checksummed address. Ethereum mainnet and Base only.","alternatives":["get_wallet_portfolio","get_erc20_balance"],"outputSchema":{"properties":{"address":{"title":"Address","type":"string"},"balance_wei":{"title":"Balance Wei","type":"string"},"balance_eth":{"title":"Balance Eth","type":"string"},"chain_id":{"title":"Chain Id","type":"integer"}},"required":["address","balance_wei","balance_eth","chain_id"],"title":"GetEthBalanceOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"get_erc20_balance","description":"Get the exact on-chain ERC-20 balance of a wallet for one token contract, normalized by decimals and returned with the token's symbol. Use for a precise single-token check.","inputSchema":{"properties":{"wallet_address":{"description":"Wallet address (0x…)","title":"Wallet Address","type":"string"},"token_address":{"description":"ERC-20 token contract address (0x…)","title":"Token Address","type":"string"},"chain_id":{"default":1,"description":"Chain ID (1=Ethereum, 8453=Base)","title":"Chain Id","type":"integer"}},"required":["wallet_address","token_address"],"title":"GetErc20BalanceInput","type":"object"},"title":"Get Erc20 Balance","annotations":{"readOnlyHint":true},"use_when":"Use when a specific token contract's balance must be verified block-accurately — e.g. confirming funds before an approval or transfer. For a multi-asset portfolio view use get_wallet_portfolio instead.","limitations":"One token contract per call on Ethereum or Base; the contract address is required, so unknown tokens cannot be looked up by symbol. Returns raw balance data only — no USD valuation.","alternatives":["get_wallet_portfolio","get_eth_balance"],"outputSchema":{"properties":{"wallet_address":{"title":"Wallet Address","type":"string"},"token_address":{"title":"Token Address","type":"string"},"token_symbol":{"title":"Token Symbol","type":"string"},"token_decimals":{"title":"Token Decimals","type":"integer"},"balance_raw":{"title":"Balance Raw","type":"string"},"balance_formatted":{"title":"Balance Formatted","type":"string"},"chain_id":{"title":"Chain Id","type":"integer"}},"required":["wallet_address","token_address","token_symbol","token_decimals","balance_raw","balance_formatted","chain_id"],"title":"GetErc20BalanceOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"get_transaction","description":"Get details and receipt for one Ethereum or Base transaction by hash: bounded calldata, normalized event logs, transaction index, and receipt-derived effective gas price and fee when available. Use to verify a specific transaction's status and outcome.","inputSchema":{"properties":{"tx_hash":{"description":"Transaction hash (0x…)","title":"Tx Hash","type":"string"},"chain_id":{"default":1,"description":"Chain ID (1=Ethereum, 8453=Base)","title":"Chain Id","type":"integer"}},"required":["tx_hash"],"title":"GetTransactionInput","type":"object"},"title":"Get Transaction","annotations":{"readOnlyHint":true},"use_when":"Use when one known transaction must be verified — status, logs, gas paid, or execution outcome. To understand what the calldata means use decode_transaction; for wallet-wide activity use get_wallet_history.","limitations":"One transaction hash per call on Ethereum or Base; pending transactions may not resolve yet. Calldata is returned bounded, not decoded — use decode_transaction for semantic decoding.","alternatives":["decode_transaction","get_block","get_wallet_history"],"outputSchema":{"$defs":{"TransactionLog":{"properties":{"address":{"title":"Address","type":"string"},"topics":{"items":{"type":"string"},"title":"Topics","type":"array"},"topics_truncated":{"default":false,"title":"Topics Truncated","type":"boolean"},"data":{"title":"Data","type":"string"},"data_truncated":{"default":false,"title":"Data Truncated","type":"boolean"},"log_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Log Index"}},"required":["address","topics","data"],"title":"TransactionLog","type":"object"}},"properties":{"tx_hash":{"title":"Tx Hash","type":"string"},"from_address":{"title":"From Address","type":"string"},"to_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"To Address"},"value_eth":{"title":"Value Eth","type":"string"},"gas_used":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Gas Used"},"gas_price_gwei":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gas Price Gwei"},"status":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"1=success, 0=revert, None=pending","title":"Status"},"block_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Block Number"},"chain_id":{"title":"Chain Id","type":"integer"},"input_data":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Hex calldata, bounded to 8 KiB","title":"Input Data"},"input_data_truncated":{"default":false,"title":"Input Data Truncated","type":"boolean"},"transaction_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Transaction Index"},"effective_gas_price_gwei":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Effective Gas Price Gwei"},"fee_wei":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Fee Wei"},"fee_eth":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Fee Eth"},"logs":{"items":{"$ref":"#/$defs/TransactionLog"},"title":"Logs","type":"array"},"logs_truncated":{"default":false,"title":"Logs Truncated","type":"boolean"}},"required":["tx_hash","from_address","to_address","value_eth","gas_used","gas_price_gwei","block_number","chain_id"],"title":"GetTransactionOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"get_wallet_portfolio","description":"Get aggregated token holdings with USD values for a wallet address. Tracks 19 major assets on Ethereum and 12 on Base, including spot, lending, liquid-staking, restaking, and stablecoin assets. Sorted by USD value. Returns up to 20 holdings. Includes native ETH balance in the holdings list — calling get_eth_balance separately after this is redundant.","inputSchema":{"properties":{"wallet_address":{"description":"Wallet address (0x…)","title":"Wallet Address","type":"string"},"chain_id":{"default":1,"description":"Chain ID (1=Ethereum, 8453=Base)","title":"Chain Id","type":"integer"}},"required":["wallet_address"],"title":"GetWalletPortfolioInput","type":"object"},"title":"Get Wallet Portfolio","annotations":{"readOnlyHint":true},"use_when":"Choose when you need a wallet's overall token exposure and USD value on Ethereum or Base in one call. Call once per chain for a cross-chain comparison.","limitations":"Tracks a fixed set of major assets per chain, not arbitrary tokens. Returns up to 20 holdings. Native ETH is included, so calling get_eth_balance separately is redundant.","alternatives":["get_eth_balance","get_token_price","get_defi_positions"],"outputSchema":{"$defs":{"PortfolioEntry":{"properties":{"symbol":{"title":"Symbol","type":"string"},"token_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token Address"},"balance_formatted":{"title":"Balance Formatted","type":"string"},"price_usd":{"title":"Price Usd","type":"number"},"value_usd":{"title":"Value Usd","type":"number"}},"required":["symbol","token_address","balance_formatted","price_usd","value_usd"],"title":"PortfolioEntry","type":"object"}},"properties":{"wallet_address":{"title":"Wallet Address","type":"string"},"chain_id":{"title":"Chain Id","type":"integer"},"total_value_usd":{"title":"Total Value Usd","type":"number"},"holdings":{"items":{"$ref":"#/$defs/PortfolioEntry"},"title":"Holdings","type":"array"},"fetch_errors":{"items":{"type":"string"},"title":"Fetch Errors","type":"array"},"note":{"default":"Only tracked tokens shown. Untracked tokens not included.","title":"Note","type":"string"}},"required":["wallet_address","chain_id","total_value_usd","holdings"],"title":"GetWalletPortfolioOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"get_wallet_history","description":"Get one page of decoded transaction history for an EVM wallet across DeBank-supported chains. Returns send, receive, and approval categories with protocol, token, exchange, gas, and USD metadata. Use the returned next_cursor as start_time to page backward.","inputSchema":{"properties":{"wallet_address":{"description":"EVM wallet address (0x-prefixed)","title":"Wallet Address","type":"string"},"chain_ids":{"anyOf":[{"items":{"type":"string"},"maxItems":50,"type":"array"},{"type":"null"}],"default":null,"description":"Optional DeBank chain identifiers; omit to query all supported chains.","title":"Chain Ids"},"start_time":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Return entries earlier than this Unix timestamp for cursor pagination.","title":"Start Time"},"page_count":{"default":20,"description":"Number of history entries to request (maximum 20).","maximum":20,"minimum":1,"title":"Page Count","type":"integer"}},"required":["wallet_address"],"title":"GetWalletHistoryInput","type":"object"},"title":"Get Wallet History","annotations":{"readOnlyHint":true},"use_when":"Use for wallet activity discovery, protocol interaction history, exchange exposure, and gas analysis. Page backward with next_cursor for older activity. Use get_transaction or decode_transaction when one known transaction needs block-level details.","limitations":"DeBank returns at most 20 entries per call and the data may be stale. This tool is not a complete ledger, PnL engine, or cost-basis calculator because historical execution prices and all transfer semantics are not guaranteed.","alternatives":["get_transaction","decode_transaction"],"outputSchema":{"$defs":{"DataProvenance":{"description":"Machine-readable source and freshness metadata for a tool response.","properties":{"provider":{"title":"Provider","type":"string"},"source_urls":{"items":{"type":"string"},"title":"Source Urls","type":"array"},"retrieved_at":{"title":"Retrieved At","type":"string"},"source_fetched_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Fetched At"},"cache_hit":{"default":false,"title":"Cache Hit","type":"boolean"},"cache_age_seconds":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Cache Age Seconds"},"cache_ttl_seconds":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Cache Ttl Seconds"}},"required":["provider","retrieved_at"],"title":"DataProvenance","type":"object"},"WalletHistoryError":{"properties":{"operation":{"title":"Operation","type":"string"},"error_type":{"title":"Error Type","type":"string"},"message":{"title":"Message","type":"string"}},"required":["operation","error_type","message"],"title":"WalletHistoryError","type":"object"}},"properties":{"wallet_address":{"title":"Wallet Address","type":"string"},"chain_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Chain Ids"},"start_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Start Time"},"page_count":{"title":"Page Count","type":"integer"},"history_list":{"items":{"additionalProperties":true,"type":"object"},"title":"History List","type":"array"},"project_dict":{"additionalProperties":{"additionalProperties":true,"type":"object"},"title":"Project Dict","type":"object"},"token_dict":{"additionalProperties":{"additionalProperties":true,"type":"object"},"title":"Token Dict","type":"object"},"cex_dict":{"additionalProperties":{"additionalProperties":true,"type":"object"},"title":"Cex Dict","type":"object"},"next_cursor":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Next Cursor"},"has_more":{"default":false,"title":"Has More","type":"boolean"},"data_complete":{"title":"Data Complete","type":"boolean"},"errors":{"items":{"$ref":"#/$defs/WalletHistoryError"},"title":"Errors","type":"array"},"provenance":{"$ref":"#/$defs/DataProvenance"},"note":{"default":"This is one page of DeBank's decoded activity history. It supports activity and gas analysis, but does not provide complete PnL or cost basis without historical execution prices.","title":"Note","type":"string"}},"required":["wallet_address","chain_ids","start_time","page_count","data_complete","provenance"],"title":"GetWalletHistoryOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":6000,"unit":"call"}}},{"name":"get_wallet_positions","description":"Get a wallet's DeFi positions across all DeBank-supported chains and protocols. Returns protocol-level positions, asset/debt/net USD values, optional token lists, aggregate exposure, and optional all-chain net worth. Set include_token_balances=true to also return DeBank's complete cross-chain wallet token list. Set include_token_lists=false for a compact balance and debt summary without nested position tokens. This covers substantially more protocols and chains than the block-accurate get_defi_positions tool. Use raw-RPC tools for liquidation, swap quotes, or other transaction-critical questions.","inputSchema":{"properties":{"wallet_address":{"description":"EVM wallet address (0x…)","title":"Wallet Address","type":"string"},"include_net_worth":{"default":true,"description":"Include all-chain net worth and per-chain balances; disable to avoid that additional provider request.","title":"Include Net Worth","type":"boolean"},"include_token_balances":{"default":false,"description":"Include DeBank's complete cross-chain token balance list; adds a billable provider request.","title":"Include Token Balances","type":"boolean"},"include_token_lists":{"default":true,"description":"Include protocol position token lists; disable for a compact balance and debt summary.","title":"Include Token Lists","type":"boolean"}},"required":["wallet_address"],"title":"GetWalletPositionsInput","type":"object"},"title":"Get Wallet Positions","annotations":{"readOnlyHint":true},"use_when":"Use for broad wallet discovery, portfolio allocation, protocol exposure, or cross-chain position questions. Set include_token_balances=true when complete wallet token discovery is required; otherwise the response only includes tokens attached to protocol positions. Set include_token_lists=false when only protocol balances, debt, or aggregate exposure are needed. Use get_defi_positions when the user needs a block-accurate Aave, Compound, Uniswap, or Lido snapshot.","limitations":"DeBank portfolio data is third-party analytics and may be stale, including occasional long refresh delays. It is read-only, EVM wallet oriented, and does not prove current liquidation or execution state. include_token_balances adds a separate billable DeBank request; include_token_lists only changes response detail.","alternatives":["get_defi_positions","get_wallet_portfolio","get_token_approvals"],"outputSchema":{"$defs":{"DataProvenance":{"description":"Machine-readable source and freshness metadata for a tool response.","properties":{"provider":{"title":"Provider","type":"string"},"source_urls":{"items":{"type":"string"},"title":"Source Urls","type":"array"},"retrieved_at":{"title":"Retrieved At","type":"string"},"source_fetched_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Fetched At"},"cache_hit":{"default":false,"title":"Cache Hit","type":"boolean"},"cache_age_seconds":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Cache Age Seconds"},"cache_ttl_seconds":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Cache Ttl Seconds"}},"required":["provider","retrieved_at"],"title":"DataProvenance","type":"object"},"WalletChainBalance":{"properties":{"chain_id":{"title":"Chain Id","type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"community_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Community Id"},"usd_value":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Usd Value"}},"required":["chain_id"],"title":"WalletChainBalance","type":"object"},"WalletPositionItem":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Description"},"update_at":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Update At"},"asset_usd_value":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Asset Usd Value"},"debt_usd_value":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Debt Usd Value"},"net_usd_value":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Net Usd Value"},"detail_types":{"items":{"type":"string"},"title":"Detail Types","type":"array"},"token_lists":{"additionalProperties":{"items":{"$ref":"#/$defs/WalletToken"},"type":"array"},"description":"Protocol-specific token lists keyed by their DeBank detail field.","title":"Token Lists","type":"object"}},"title":"WalletPositionItem","type":"object"},"WalletPositionsError":{"properties":{"operation":{"title":"Operation","type":"string"},"error_type":{"title":"Error Type","type":"string"},"message":{"title":"Message","type":"string"}},"required":["operation","error_type","message"],"title":"WalletPositionsError","type":"object"},"WalletProtocolPosition":{"properties":{"protocol_id":{"title":"Protocol Id","type":"string"},"chain_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Chain Id"},"protocol_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Protocol Name"},"site_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Site Url"},"has_supported_portfolio":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Has Supported Portfolio"},"protocol_tvl_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Protocol Tvl Usd"},"items":{"items":{"$ref":"#/$defs/WalletPositionItem"},"title":"Items","type":"array"}},"required":["protocol_id"],"title":"WalletProtocolPosition","type":"object"},"WalletToken":{"properties":{"token_id":{"title":"Token Id","type":"string"},"chain_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Chain Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Symbol"},"display_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Display Symbol"},"decimals":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Decimals"},"amount":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Amount"},"raw_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Raw Amount"},"price_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Price Usd"},"usd_value":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Usd Value"},"protocol_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Protocol Id"},"is_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Is Verified"}},"required":["token_id"],"title":"WalletToken","type":"object"}},"properties":{"wallet_address":{"title":"Wallet Address","type":"string"},"include_net_worth":{"title":"Include Net Worth","type":"boolean"},"include_token_balances":{"title":"Include Token Balances","type":"boolean"},"include_token_lists":{"title":"Include Token Lists","type":"boolean"},"total_net_worth_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Total Net Worth Usd"},"total_asset_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Total Asset Usd"},"total_debt_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Total Debt Usd"},"total_net_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Total Net Usd"},"chain_balances":{"items":{"$ref":"#/$defs/WalletChainBalance"},"title":"Chain Balances","type":"array"},"positions":{"items":{"$ref":"#/$defs/WalletProtocolPosition"},"title":"Positions","type":"array"},"token_balances":{"items":{"$ref":"#/$defs/WalletToken"},"title":"Token Balances","type":"array"},"data_complete":{"title":"Data Complete","type":"boolean"},"errors":{"items":{"$ref":"#/$defs/WalletPositionsError"},"title":"Errors","type":"array"},"provenance":{"$ref":"#/$defs/DataProvenance"},"staleness_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Max age in seconds of the underlying DeBank position data (from per-item update_at), or None when unavailable.","title":"Staleness Seconds"},"note":{"default":"Positions are sourced from DeBank Cloud portfolio analytics and may be stale; they are not block-accurate. staleness_seconds reports the oldest underlying position update. Use get_defi_positions or other raw-RPC tools for liquidation, quote, and transaction-critical checks.","title":"Note","type":"string"}},"required":["wallet_address","include_net_worth","include_token_balances","include_token_lists","data_complete","provenance"],"title":"GetWalletPositionsOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":20000,"unit":"call"}}},{"name":"read_contract","description":"Call any view/pure function on a smart contract and return the decoded result, using a supplied ABI fragment. Supports historical reads via block_identifier and caller_address context for msg.sender-dependent views. Read-only: state-changing functions are rejected.","inputSchema":{"properties":{"contract_address":{"description":"Contract address (0x…)","title":"Contract Address","type":"string"},"abi_fragment":{"description":"JSON array containing the ABI for the function to call. Supports both modern (stateMutability: view/pure) and legacy (constant: true) formats. Only read-only functions are allowed.","maxLength":65536,"title":"Abi Fragment","type":"string"},"function_name":{"description":"Name of the function to call","maxLength":200,"title":"Function Name","type":"string"},"args_json":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"description":"Optional JSON array string of positional arguments for the function call. Use this instead of 'args' for complex types or when calling via Google/Gemini.","title":"Args Json"},"args":{"description":"DEPRECATED: Positional arguments for the function call. Use 'args_json' for complex objects or Gemini compatibility.","items":{"type":"string"},"maxItems":50,"title":"Args","type":"array"},"block_identifier":{"default":"latest","description":"Block number, block hash, or 'latest'/'earliest'/'pending'","maxLength":80,"title":"Block Identifier","type":"string"},"chain_id":{"default":1,"description":"Chain ID (1=Ethereum, 8453=Base)","title":"Chain Id","type":"integer"},"caller_address":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional EVM address to supply as msg.sender for caller-dependent view functions. This does not sign or submit a transaction.","title":"Caller Address"}},"required":["contract_address","abi_fragment","function_name"],"title":"ReadContractInput","type":"object"},"title":"Read Contract","annotations":{"readOnlyHint":true},"use_when":"Use when a protocol question needs a contract read that no higher-level tool covers — e.g. a niche view function or a protocol outside the standard tool set. Prefer purpose-built tools (get_defi_positions, get_lending_rates) for supported protocols.","limitations":"Requires a valid ABI fragment; payable/nonpayable functions are rejected. Ethereum mainnet and Base only, with bounded RPC timeout and retry.","alternatives":["get_defi_positions","get_lending_rates","get_token_approvals"],"outputSchema":{"properties":{"contract_address":{"title":"Contract Address","type":"string"},"function_name":{"title":"Function Name","type":"string"},"result":{"title":"Result"},"block_identifier":{"title":"Block Identifier","type":"string"},"chain_id":{"title":"Chain Id","type":"integer"},"caller_address":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Caller Address"}},"required":["contract_address","function_name","result","block_identifier","chain_id"],"title":"ReadContractOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"record_predictions","description":"Record a complete structured prediction document for downstream evaluation. Call once with the exact machine-readable prediction; the human-readable report is provided separately.","inputSchema":{"properties":{"predictions":{"additionalProperties":true,"description":"The complete structured prediction document for this run.","title":"Predictions","type":"object"}},"required":["predictions"],"title":"RecordPredictionsInput","type":"object"},"title":"Record Predictions","annotations":{"readOnlyHint":true},"use_when":"Use at the end of a scheduled analysis run to persist the machine-readable prediction for later scoring. Call exactly once with the complete prediction document — never partially or repeatedly.","limitations":"Internal sink for scheduled analysis, not a caller-facing marketplace tool. Stores the prediction as given; no validation of prediction quality or deduplication across calls.","alternatives":["get_datetime"],"outputSchema":{"properties":{"recorded":{"title":"Recorded","type":"boolean"}},"required":["recorded"],"title":"RecordPredictionsOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":0,"unit":"call"}}},{"name":"resolve_ens","description":"Resolve an ENS name (e.g. 'vitalik.eth') to an Ethereum address, or an address to its primary ENS name, with avatar text record when available. Mainnet only.","inputSchema":{"properties":{"name":{"description":"ENS name (e.g. 'vitalik.eth') to resolve to an address, or an Ethereum address (0x…) for reverse lookup to a primary ENS name.","maxLength":253,"title":"Name","type":"string"}},"required":["name"],"title":"ResolveEnsInput","type":"object"},"title":"Resolve Ens","annotations":{"readOnlyHint":true},"use_when":"Use only when no 0x address is available and a name must become an address (or vice versa for attribution). If a 0x address is already present in the task or session, use it directly — resolution is redundant and adds latency.","limitations":"Ethereum mainnet ENS only — no other chains or naming services. Reverse records are optional on ENS, so a valid address may legitimately have no primary name.","alternatives":["get_wallet_portfolio","get_wallet_history"],"outputSchema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"resolved":{"title":"Resolved","type":"boolean"},"avatar":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Avatar"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Error"}},"required":["name","address","resolved"],"title":"ResolveEnsOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":5000,"unit":"call"}}},{"name":"simulate_transaction","description":"Dry-run one transaction or an ordered bundle (e.g. approve then swap) from a wallet on Ethereum or Base without signing or broadcasting. Returns per-call success or decoded revert reason, gas used, the wallet's net ETH and ERC-20 balance changes, new token approvals (flagging unlimited ones), and a receipt hash committing to the inputs and results at the simulated block. Use the result to decide whether to proceed, adjust, or abort before acting on-chain.","inputSchema":{"$defs":{"SimulationCall":{"properties":{"to":{"description":"Target address.","title":"To","type":"string"},"data":{"anyOf":[{"maxLength":98306,"type":"string"},{"type":"null"}],"default":null,"description":"Hex calldata; or use abi_fragment + function_name.","title":"Data"},"abi_fragment":{"anyOf":[{"maxLength":65536,"type":"string"},{"type":"null"}],"default":null,"description":"JSON ABI array used to encode function_name.","title":"Abi Fragment"},"function_name":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"title":"Function Name"},"args_json":{"anyOf":[{"maxLength":4000,"type":"string"},{"type":"null"}],"default":null,"description":"JSON array of positional args; integers may be strings.","title":"Args Json"},"value_wei":{"default":"0","description":"ETH value in wei (decimal string).","maxLength":78,"title":"Value Wei","type":"string"}},"required":["to"],"title":"SimulationCall","type":"object"}},"properties":{"from_address":{"description":"Sender wallet (msg.sender).","title":"From Address","type":"string"},"calls":{"description":"Ordered bundle, e.g. [approve, swap]; later calls see earlier state.","items":{"$ref":"#/$defs/SimulationCall"},"maxItems":8,"minItems":1,"title":"Calls","type":"array"},"chain_id":{"default":1,"description":"1=Ethereum, 8453=Base.","title":"Chain Id","type":"integer"},"block_identifier":{"default":"latest","description":"'latest' or a decimal parent block number.","maxLength":20,"title":"Block Identifier","type":"string"}},"required":["from_address","calls"],"title":"SimulateTransactionInput","type":"object"},"title":"Simulate Transaction","annotations":{"readOnlyHint":true},"use_when":"Use before recommending or preparing any state-changing transaction to confirm it will not revert and to see actual token outflows, inflows, and approvals. Put dependent steps (approve then swap) in one call so later steps see earlier state. Use read_contract for view-only reads and decode_transaction for already-mined txs.","limitations":"Point-in-time result at the reported block; mempool ordering, MEV, and later state can change the real outcome. Gas affordability, nonce, and signatures are not checked. Max 8 calls; Ethereum and Base only. If bundle simulation is unavailable, calls run independently and balance/approval changes are omitted.","alternatives":["read_contract","decode_transaction","get_dex_quote","get_token_approvals"],"outputSchema":{"$defs":{"ApprovalChange":{"properties":{"token":{"title":"Token","type":"string"},"spender":{"title":"Spender","type":"string"},"amount_raw":{"title":"Amount Raw","type":"string"},"unlimited":{"title":"Unlimited","type":"boolean"}},"required":["token","spender","amount_raw","unlimited"],"title":"ApprovalChange","type":"object"},"BalanceChange":{"properties":{"token":{"title":"Token","type":"string"},"delta_raw":{"title":"Delta Raw","type":"string"}},"required":["token","delta_raw"],"title":"BalanceChange","type":"object"},"CallOutcome":{"properties":{"index":{"title":"Index","type":"integer"},"to":{"title":"To","type":"string"},"status":{"enum":["success","reverted","failed"],"title":"Status","type":"string"},"gas_used":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Gas Used"},"return_data":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Return Data"},"return_data_truncated":{"default":false,"title":"Return Data Truncated","type":"boolean"},"revert_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Revert Reason"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Error"}},"required":["index","to","status"],"title":"CallOutcome","type":"object"},"SimulationReceipt":{"properties":{"version":{"title":"Version","type":"integer"},"kind":{"const":"simulation","title":"Kind","type":"string"},"content_sha256":{"title":"Content Sha256","type":"string"}},"required":["version","kind","content_sha256"],"title":"SimulationReceipt","type":"object"}},"properties":{"chain_id":{"title":"Chain Id","type":"integer"},"from_address":{"title":"From Address","type":"string"},"mode":{"enum":["eth_simulateV1","eth_call_fallback"],"title":"Mode","type":"string"},"base_block_number":{"title":"Base Block Number","type":"integer"},"all_succeeded":{"title":"All Succeeded","type":"boolean"},"calls":{"items":{"$ref":"#/$defs/CallOutcome"},"title":"Calls","type":"array"},"balance_changes":{"items":{"$ref":"#/$defs/BalanceChange"},"title":"Balance Changes","type":"array"},"approvals":{"items":{"$ref":"#/$defs/ApprovalChange"},"title":"Approvals","type":"array"},"warnings":{"items":{"type":"string"},"title":"Warnings","type":"array"},"receipt":{"$ref":"#/$defs/SimulationReceipt"}},"required":["chain_id","from_address","mode","base_block_number","all_succeeded","calls","balance_changes","approvals","warnings","receipt"],"title":"SimulateTransactionOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":10000,"unit":"call"}}},{"name":"validate_opportunity","description":"Return a decision-ready yield-opportunity verdict before capital is deployed. The result branches to sustainable, caution, unsustainable, or insufficient_data and gives the calling agent the evidence needed to proceed, pause, or reject the opportunity.","inputSchema":{"properties":{"pool_id":{"description":"DeFiLlama yield pool UUID (e.g. '747c1d2a-c668-4682-b9f9-296708a3dd90').","title":"Pool Id","type":"string"}},"required":["pool_id"],"title":"ValidateOpportunityInput","type":"object"},"title":"Validate Opportunity","annotations":{"readOnlyHint":true},"use_when":"Delegate this check before deploying capital into a DeFi yield pool or staking opportunity when the caller needs an independent sustainability and liquidity decision.","limitations":"Heuristic economic assessment based on DeFiLlama analytics and CoinGecko pricing. Does not audit smart contract bytecode, protocol governance, or admin key security.","alternatives":["get_yield_rates","get_protocol_tvl","get_lending_rates","assess_counterparty_risk"],"outputSchema":{"$defs":{"DataProvenance":{"description":"Machine-readable source and freshness metadata for a tool response.","properties":{"provider":{"title":"Provider","type":"string"},"source_urls":{"items":{"type":"string"},"title":"Source Urls","type":"array"},"retrieved_at":{"title":"Retrieved At","type":"string"},"source_fetched_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Fetched At"},"cache_hit":{"default":false,"title":"Cache Hit","type":"boolean"},"cache_age_seconds":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Cache Age Seconds"},"cache_ttl_seconds":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Cache Ttl Seconds"}},"required":["provider","retrieved_at"],"title":"DataProvenance","type":"object"},"LiquiditySummary":{"properties":{"tvl_usd":{"default":0.0,"title":"Tvl Usd","type":"number"},"tvl_30d_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Tvl 30D Change Pct"},"chart_days":{"default":0,"title":"Chart Days","type":"integer"},"drain_detected":{"default":false,"title":"Drain Detected","type":"boolean"}},"title":"LiquiditySummary","type":"object"},"RiskFactor":{"properties":{"category":{"title":"Category","type":"string"},"severity":{"enum":["high","medium","low"],"title":"Severity","type":"string"},"detail":{"title":"Detail","type":"string"}},"required":["category","severity","detail"],"title":"RiskFactor","type":"object"},"YieldSummary":{"properties":{"apy":{"default":0.0,"title":"Apy","type":"number"},"apy_base":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Apy Base"},"apy_reward":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Apy Reward"},"apy_mean_30d":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Apy Mean 30D"},"reward_share_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Reward Share Pct"},"is_spiking":{"default":false,"title":"Is Spiking","type":"boolean"}},"title":"YieldSummary","type":"object"}},"properties":{"pool_id":{"title":"Pool Id","type":"string"},"project":{"default":"","title":"Project","type":"string"},"symbol":{"default":"","title":"Symbol","type":"string"},"chain":{"default":"","title":"Chain","type":"string"},"verdict":{"enum":["sustainable","caution","unsustainable","insufficient_data"],"title":"Verdict","type":"string"},"sustainability_reason":{"title":"Sustainability Reason","type":"string"},"risk_factors":{"items":{"$ref":"#/$defs/RiskFactor"},"title":"Risk Factors","type":"array"},"yield_summary":{"$ref":"#/$defs/YieldSummary"},"liquidity_summary":{"$ref":"#/$defs/LiquiditySummary"},"partial_errors":{"items":{"type":"string"},"title":"Partial Errors","type":"array"},"data_complete":{"default":true,"title":"Data Complete","type":"boolean"},"provenance":{"$ref":"#/$defs/DataProvenance"},"as_of":{"title":"As Of","type":"string"}},"required":["pool_id","verdict","sustainability_reason","provenance","as_of"],"title":"ValidateOpportunityOutput","type":"object"},"_meta":{"teardrop/price":{"cost_usdc":15000,"unit":"call"}}}],"resources":[],"prompts":[],"marketplace":{"mcp_url":"https://api.teardrop.dev/tools/mcp","authentication":{"required":true,"schemes":["bearer"]}},"x402":{"enabled":true,"network":"eip155:8453","scheme":"exact","discovery_url":"https://api.teardrop.dev/.well-known/x402","mcp_tools_url":"https://api.teardrop.dev/tools/mcp","bootstrap":{"grant_type":"x402","token_endpoint":"https://api.teardrop.dev/token"}},"iconUrl":"https://teardrop.dev/teardrop.png"}