web3agent

List CCXT-supported exchanges and summarize which ones have configured authenticated accounts, public market access, and available market-type metadata.

Invoke an authenticated read-only CCXT method using a configured named account. This covers balances, positions, orders, fills, and private implicit GET-style endpoints.

Invoke an authenticated mutating CCXT method using a configured named account. This covers order placement, cancellation, leverage, transfers, withdrawals, and private implicit write endpoints.

Invoke a public CCXT unified or implicit method on a selected exchange. Use ccxt_describe_exchange first for capability discovery when calling niche methods.

Get ERC-8004 agent identity. Requires either agentId (token ID) or walletAddress — provide at least one.

Get aggregate ERC-8004 reputation summary for an agent with optional tag filters.

Register an agent on the ERC-8004 Identity Registry (write operation, wallet + confirmation required).

Submit reputation feedback for an ERC-8004 agent (write operation, wallet + confirmation required).

Update ERC-8004 agent metadata URI (write operation, wallet + confirmation required).

Claim refund from an expired/rejected ERC-8183 job.

Complete an ERC-8183 job and release escrow.

Create an ERC-8183 job.

Fund ERC-8183 job escrow. Performs allowance check + approve if needed, then funds in one confirmation flow.

Read ERC-8183 job details by ID.

Reject an ERC-8183 job.

Set ERC-8183 job budget in payment token smallest units.

Submit job deliverable hash for an ERC-8183 job.

Approve ERC-20 spender allowance using raw token units.

Get ERC-20 allowance from owner to spender for a token contract.

Get NATIVE token balance (ETH, MATIC, BNB, etc.) for an address or ENS name. This does NOT return ERC-20 token balances — use evm_get_token_balance for that.

Get block details by block number string or block hash.

Get basic chain status including latest block number for a chain ID.

Fetch a contract ABI from Etherscan for a specific chain.

Get ERC-1155 token balance for an owner and token ID.

Get current base gas price and priority fee estimates for a chain.

Get the latest block details for a chain.

Get ERC-721 NFT details including collection metadata, owner, and tokenURI.

List supported EVM networks available for EVM tool operations.

Get ERC-20 token balance (USDC, WETH, DAI, etc.) for an owner address. Requires the token contract address. For native token balance (ETH, MATIC), use evm_get_balance instead.

Get transaction details for a transaction hash.

Get the transaction receipt (status, logs, gas usage) for a hash.

Get the currently active wallet address, mode, and chain context.

List all ABI labels registered via evm_register_abi.

Perform reverse ENS lookup for an address.

Batch multiple contract read calls into one multicall RPC request.

Read contract state by function name. Provide abiLabel (from evm_register_abi), abiJson, or let the tool auto-resolve from Etherscan.

Register a contract ABI under a label for reuse. Once registered, pass abiLabel to evm_read_contract, evm_write_contract, or evm_multicall instead of repeating the full ABI JSON on every call.

Resolve an ENS name to an EVM address.

Sign an arbitrary UTF-8 message with the active wallet.

Sign EIP-712 typed data payload with the active wallet.

Transfer ERC-20 tokens. Amount is in the token's smallest unit (e.g. for USDC with 6 decimals, '1000000' = 1 USDC). Use evm_get_token_balance to check decimals first.

Send native tokens (ETH, MATIC, etc.) to an address or ENS name.

Wait for transaction confirmations and return the confirmed receipt.

Execute a state-changing contract function. Provide abiLabel (from evm_register_abi), abiJson, or let the tool auto-resolve. Confirmation-gated.

Get the earliest transaction for an address — useful for identifying initial funding or activity.

Get address overview including balances, ENS name, contract metadata, and public tags.

Get block information including gas consumption, rewards, and optionally full transaction list.

Find the block number closest to a given Unix timestamp (before or after).

Get block reward details including miner reward, uncle inclusion reward, and uncle blocks.

Get blocks mined/validated by a specific address.

Fetch the ABI for a verified smart contract. Works only for source-verified contracts.

Get the deployed bytecode of a contract at a given address.

Find who deployed a contract and the creation transaction hash.

Get verified source code for a smart contract.

Get event logs emitted by a specific contract address, optionally filtered by topics and block range.

Get event logs across all contracts filtered by topics and block range (no address required).

Get the native token balance of an address at a specific historical block number.

Get historical daily native token prices for a date range.

Get the ERC-20 token balance of an address at a specific historical block number.

Get internal (trace) transactions for an address, including contract-to-contract calls.

Get the current native token price in USD and BTC.

Get the native token supply including staking, burned fees, and withdrawal totals.

List NFT collections and token IDs owned by an address.

Get NFT transfer history (ERC-721 and ERC-1155) for an address, merged and sorted by time.

Get a paginated list of token holders for a given token contract.

Get token metadata including name, symbol, decimals, total supply, and social profiles.

Get the total supply of a token, optionally at a specific historical block number.

Get ERC-20 token transfer history for an address, optionally filtered by token contract.

List all ERC-20 token holdings with balances and market data for an address.

Get the top N token holders by balance for a given token contract.

Get full transaction details including decoded input parameters and token movements.

Check the execution status of a transaction (whether it errored during execution).

Get transaction history for an address, optionally filtered by block range and method.

Get transaction receipt with execution status and gas usage.

Execute a cross-chain bridge (write operation, requires wallet and confirmation). Requires token addresses — use resolve_token first to get addresses.

Get list of chains supported by LI.FI for cross-chain bridging

Get a cross-chain bridge/swap quote from LI.FI. Supports 20+ EVM chains including Ethereum, BSC, Polygon, Arbitrum, Optimism, Base, Linea, Avalanche, zkSync, Scroll, Gnosis, and more. Requires token addresses — use resolve_token first to get addresses.

Prepare a cross-chain bridge route for an external wallet. Returns raw transaction steps without executing them.

List all well-known tokens available in the built-in registry for a specific chain. Returns symbol, address, decimals, and name for each token.

List all supported EVM chains with their chain IDs, names, and native currencies.

Fetch a list of cryptocurrency categories from CoinGecko with their aggregate market data. Returns category name, total market cap, 24h market cap change, and top-3 coins for each category.

Fetch net fund flow data for centralized exchanges from DefiLlama's CEX tracker. Returns inflow and outflow amounts for each exchange, useful for monitoring capital movements on CEXes.

Retrieve the historical TVL time series for a specific blockchain network from DefiLlama. Returns a list of date/TVL pairs showing how the chain's total locked value has evolved over time.

Fetch 24-hour trading volume data for decentralized exchanges from DefiLlama. Returns a ranked list of DEXes with their daily and total volume figures.

Retrieve a ranked list of centralized exchanges from DefiLlama by their assets under management. Returns exchange name, total assets, reported vs clean volume metrics, and number of coins/pairs tracked.

Deprecated: prefer ccxt_public_call and ccxt_describe_exchange for new integrations. Fetch the current perpetual futures funding rates for one or all symbols from Binance. Returns the funding rate, funding time, and mark price for each perpetual contract, which is useful for tracking carry costs in leveraged positions.

Retrieve the top gaining and losing tokens over a specified time period from DefiLlama. Returns separate lists of gainers and losers, each with token symbol and price change percentage.

Fetch aggregate global DeFi market statistics from DefiLlama. Returns total DeFi TVL across all chains and protocols, providing a macro view of the DeFi ecosystem.

Deprecated: prefer ccxt_public_call and ccxt_describe_exchange for new integrations. Fetch candlestick (OHLCV) chart data for a trading pair from Binance at a specified interval. Returns open, high, low, close price, volume, and timestamp for each candle in the requested range.

Deprecated: prefer ccxt_public_call and ccxt_describe_exchange for new integrations. Fetch the current order book depth for a trading pair from Binance. Returns bid and ask price levels with their quantities up to the requested depth.

Fetch the Total Value Locked (TVL) for a specific DeFi protocol by its DefiLlama slug. Returns current TVL in USD, percentage changes over 1d/7d/30d periods, per-chain TVL breakdown, protocol category, and website URL.

Fetch the Crypto Fear & Greed Index from alternative.me for the specified number of recent days. Returns the current index value with classification (e.g. Fear, Greed) plus historical daily readings.

Retrieve stablecoin market statistics from DefiLlama, including circulating supply and peg data. Returns a list of stablecoins with their name, symbol, total circulating supply, peg type, and peg mechanism.

Deprecated: prefer ccxt_public_call and ccxt_describe_exchange for new integrations. Fetch real-time 24-hour ticker statistics for a trading pair from Binance. Returns last price, price change, high/low, volume, bid/ask, and quote volume for the specified symbol.

Fetch historical price data for a token from CoinGecko by its coin ID. Returns OHLC candlestick data and market cap/volume history for the specified number of days.

Fetch current USD prices for one or more tokens using DefiLlama's price oracle. Accepts token identifiers in the format 'chain:address' (e.g. 'ethereum:0x...') and returns price, symbol, decimals, confidence score, and last-updated timestamp for each token.

Retrieve a ranked list of the top DeFi protocols by TVL from DefiLlama. Returns protocol name, current TVL, 1-day TVL change, first listed chain, category, and DefiLlama slug for each entry in the list.

Retrieve the top cryptocurrencies by market capitalization from CoinGecko. Returns name, symbol, current price, market cap, 24h price change percentage, and trading volume for each token.

Fetch the currently trending cryptocurrencies on CoinGecko based on search activity. Returns a list of trending coins with their name, symbol, CoinGecko ID, and market cap rank.

Search for cryptocurrencies, exchanges, and NFTs on CoinGecko by keyword. Returns matching coins with their CoinGecko ID, symbol, name, and market cap rank.

Prepare an external-wallet operation for Orbs, LI.FI, or GOAT. Returns the next actions plus opaque resume state.

Resume a previously prepared external-wallet operation after signatures or transactions complete externally.

Cancel a Spot order onchain by calling RePermit.cancel with the order digest. Write, confirmation-gated.

Get a quote from Orbs Liquidity Hub for same-chain aggregated swap. Requires token addresses — use resolve_token first to get addresses.

Check whether wrapping native assets or approving Permit2 is required before signing an Orbs swap intent.

Place a limit order via Spot protocol. Executes only when output meets minimum amount. Write, confirmation-gated.

Place a gasless order via Spot protocol. Supports market, limit, TWAP, stop-loss, take-profit, and delayed orders. Order type determined by parameters: limit (outputLimit > 0), chunked/TWAP (fromMaxAmount > fromAmount + epoch), stop-loss (outputTriggerLower), take-profit (outputTriggerUpper), delayed (future start). Write, confirmation-gated.

Place a TWAP (time-weighted average price) order via Spot protocol. Splits fromAmount into equal chunks executed at regular intervals. Write, confirmation-gated.

Prepare a limit order for external wallet signing. Returns EIP-712 typed data, approval calldata, and metadata.

Prepare a Spot order for external wallet signing. Returns EIP-712 typed data, approval calldata, submit URL, and order metadata. Supports all order types.

Prepare a same-chain Orbs swap intent for external wallet signing. Returns required approvals, full quote, and EIP-712 typed data.

Prepare a TWAP order for external wallet signing. Returns EIP-712 typed data, approval calldata, and metadata.

Query Spot orders by swapper address or order hash. Falls back to SDK query if Spot API unavailable.

Submit an externally signed Spot order using the submit URL and order from orbs_prepare_order_intent.

Submit an externally signed Orbs Liquidity Hub swap using the quote returned by orbs_prepare_swap_intent.

Execute a same-chain swap via Orbs Liquidity Hub (write, confirmation-gated). Supported chains: 137 (Polygon), 56 (BSC), 8453 (Base), 59144 (Linea), 81457 (Blast), 42161 (Arbitrum). Requires token addresses — use resolve_token first.

Check the status of a pending Orbs Liquidity Hub swap

Get current treasury policy limits and spend totals. Shows per-transaction, hourly, and daily caps plus how much budget remains. Read-only — policy limits are set by the user, not the agent.

Discover active and upcoming token airdrop opportunities tracked by DefiLlama. Returns airdrop name, protocol, eligibility criteria, estimated value, claim deadline, and status to help users identify and act on airdrop opportunities before they expire.

Compare yield opportunities for a specific token across multiple DeFi protocols and chains. Returns matching pools sorted by APY so you can quickly identify where a given token earns the most yield, including TVL and protocol information for each option.

Analyze the security posture of a smart contract by querying GoPlus Security. Returns audit flags such as honeypot detection, proxy patterns, ownership renouncement, trading restrictions, and other risk indicators for the given contract address.

Fetch fundraising and investment round data for crypto projects from DefiLlama. Returns project name, date, USD amount raised, funding round type, and lead investors, providing insight into which projects are attracting institutional capital.

Fetch active and recent governance proposals for DeFi protocols from DefiLlama's governance tracker. Returns proposal title, current status, vote counts (for/against/abstain), start and end dates, and discussion links to stay informed about protocol governance decisions.

Query the history of DeFi hacks and exploits tracked by DefiLlama. Returns a list of incidents with the protocol name, date, USD amount lost, attack technique, and source URL — enabling security research and risk assessment of protocols.

Retrieve the latest crypto and DeFi news headlines from DefiLlama's news aggregator. Returns article titles, publication dates, source names, and URLs, providing a curated feed of relevant industry news to support market research and situational awareness.

Get detailed information about a DeFi protocol including TVL, chain breakdown, category, audit history, and funding rounds from DefiLlama. If the protocol has a CoinGecko-listed token, also returns developer activity, community stats, and sentiment data.

Perform comprehensive due diligence on a token by aggregating security, holder distribution, and market data from multiple sources. Returns a structured risk assessment covering contract safety flags, top holder concentration, and liquidity metrics to support informed investment decisions.

Retrieve the top token holders for a given contract address using GoPlus Security data. Returns a ranked list of holder addresses with their balance and percentage share of the total supply, enabling analysis of holder concentration and whale exposure.

Retrieve upcoming token unlock events from DefiLlama's vesting tracker. Returns a list of tokens with their next unlock date, USD value to be unlocked, current price, and estimated price impact percentage — useful for anticipating supply-side selling pressure.

Track large on-chain token transfers (whale movements) using DefiLlama's large transactions feed. Returns recent high-value transfers with sender, receiver, USD amount, token symbol, chain, and timestamp to monitor smart money flows and potential market-moving activity.

Discover DeFi yield farming and liquidity pool opportunities from DefiLlama's yields API. Returns a filtered and ranked list of pools with APY, TVL, chain, protocol, and pool metadata to help identify the best yield strategies across the ecosystem.

Resolve a token symbol (e.g. 'USDT', 'WBNB') to its contract address and decimals on a specific chain. Uses a built-in registry of verified canonical addresses for major tokens with DexScreener fallback. ALWAYS call this first when you need a token address — do NOT use blockscout_lookup_token_by_symbol or get_token_info_by_symbol.

Get current server status including wallet mode, active chain, confirmation setting, and backend health.

Confirm a pending operation by ID. Returns the operation details so the caller can execute it.

Deny and remove a pending operation by ID without executing it.

List all pending operations awaiting confirmation. Automatically prunes expired entries.

Simulate an unsigned transaction using RPC trace when available, with fallback static decoding for token balance changes.

Activate a wallet from a private key or mnemonic using the selected backend (encrypted OWS vault when available, otherwise legacy wallet storage) and emits wallet-changed. Gated when secrets are in input: requires WEB3AGENT_ALLOW_AGENT_VISIBLE_SECRETS=1. Prefer local CLI: npx web3agent wallet activate.

Deactivate the current runtime/session wallet and revert to read-only ephemeral mode without deleting persisted wallet material.

Permanently delete persisted wallet material through the active backend or legacy storage, then revert to read-only ephemeral mode. Destructive: requires explicit confirmation.

Derive multiple addresses from a mnemonic (1-20). Returns index, address, and derivation path. Gated: requires WEB3AGENT_ALLOW_AGENT_VISIBLE_SECRETS=1 (mnemonic in agent context). Prefer local CLI.

Derive an address from a BIP-39 mnemonic at optional account/address index. Does NOT return private key. Gated: requires WEB3AGENT_ALLOW_AGENT_VISIBLE_SECRETS=1 (mnemonic in agent context). Prefer local CLI.

Generate a new random Ethereum wallet. Returns address and private key once — never stored. Gated: requires WEB3AGENT_ALLOW_AGENT_VISIBLE_SECRETS=1. Prefer local CLI: npx web3agent wallet generate.

Generate a new BIP-39 mnemonic phrase with its first derived address. Gated: requires WEB3AGENT_ALLOW_AGENT_VISIBLE_SECRETS=1. Prefer local CLI: npx web3agent wallet generate --mnemonic.

Get the currently active wallet address, chain ID, and mode (private-key, mnemonic, or read-only).

Get wallet backend metadata, storage security posture, and current wallet state without exposing secrets.

Toggle write confirmation at runtime. When enabled, write operations are queued and require explicit confirmation.

Check if a URL requires x402 payment. Returns payment requirements (amount, network, token) or confirms no payment needed. Use before x402_fetch to preview costs.

Fetch a URL, automatically paying via x402 protocol if required. Checks payment cost first, queues confirmation if payment needed, then executes. No-op if no payment required.