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.

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.

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.

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.

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.

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

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.

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.

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

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

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.

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

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.

Execute a cross-chain bridge (write operation, requires wallet and confirmation). 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.

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

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.

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

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

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

Check the status of a pending Orbs Liquidity Hub swap

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 TWAP order for external wallet signing. Returns EIP-712 typed data, approval calldata, and metadata.

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

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

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.

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

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

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

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

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.

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.

Create an ERC-8183 job.

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

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

Submit job deliverable hash for an ERC-8183 job.

Complete an ERC-8183 job and release escrow.

Reject an ERC-8183 job.

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

Read ERC-8183 job details by ID.

Create a job on the Virtuals ACPRouter (Base). Specify provider, evaluator, description, and expiry.

Set a job budget on the Virtuals ACPRouter using setBudgetWithPaymentToken and optional token override.

Fund a Virtuals ACPRouter job. Automatically checks allowance, approves ERC-20 if needed, then creates payable memo escrow.

Submit a deliverable memo on the Virtuals ACPRouter and advance the job to evaluation phase.

Complete a job on the Virtuals ACPRouter by auto-resolving the pending memo and signing approval.

Reject a job on the Virtuals ACPRouter by auto-resolving the pending memo and signing rejection.

Claim remaining budget for a Virtuals ACPRouter job using claimBudget.

Get job details and full memo history from the Virtuals ACPRouter. Shows phase, participants, budget, and all memos with their status.

Search the aGDP marketplace for AI agent offerings. Returns agent profiles with capabilities, metrics, and available services.

Get detailed information about a specific agent offering by ID.

List your active or completed jobs from the aGDP marketplace. Requires an active wallet.

Hire an AI agent from the aGDP marketplace via API (write operation, requires wallet and confirmation). For on-chain job creation, use acp_create_job separately.

Create a new offering on the aGDP marketplace. NOTE: requires a LITE_AGENT_API_KEY from Virtuals — visit agdp.io/join to register.

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

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

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

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

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

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

Inspect a CCXT exchange or configured account and return supported methods, market types, timeframes, symbols, and invocation modes so callers can route requests safely.

List configured CCXT accounts from CCXT_CONFIG_PATH with redacted metadata only. Secrets are never returned.

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

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.

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.

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

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.

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 24-hour trading volume data for decentralized exchanges from DefiLlama. Returns a ranked list of DEXes with their daily and total volume figures.

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.

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.

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

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.

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.

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.

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

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.

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.

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.

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.

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.

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.

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.

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.

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.