# Trading

Quote and swap tokens on EVM chains through the best available route.

- Status: Live (reads and writes)
- Category: Spot
- Chains: Ethereum, Optimism, Unichain, Polygon, Base, Base Sepolia, Arbitrum, Robinhood Chain
- Can touch: 1 write action from the agent's wallet, each checked against the owner's mandate before it signs.

## Actions

- `swap` (write): Execute token swaps on Thirdfy, Kyber, or Li.Fi using direct AgentKit wallet transactions.
- `get-best-trading-quote` (read): Get trading quotes with Thirdfy DEX priority (may route via Thirdfy, Kyber, Li.Fi, or 0x depending on best execution).
- `get-token-metadata` (read): Read-only: check one token by contract address (0x... or Solana mint) or exact symbol on a chain: name, symbol, decimals, price, liquidity, listings, and risk with warnings and riskSources from providers (GMGN, GeckoTerminal, Jupiter; Laika on DogeOS testnet). Use it before swapping an address the user gave; risk unknown means no provider gave a honeypot or sell verdict, so confirm with the user.
- `get-trading-opportunities` (read): Discover profitable trading opportunities and high APR pools using real pool data.
- `search-tokens` (read): Read-only: find token candidates by symbol or name from market-data providers (GeckoTerminal, Jupiter, CoinMarketCap; safety from GMGN, GeckoTerminal, Jupiter; Laika on DogeOS testnet) on Base, Ethereum, Arbitrum, Optimism, Polygon, Unichain, Gnosis, World Chain, Robinhood Chain, Solana or DogeOS; omit chainId to search all. Returns up to 10 tokens with name, symbol, chain, address, liquidity, market cap, risk (high / medium / low / unknown, from provider fields only; low only with a provider honeypot / sell verdict), warnings and riskSources. Show the candidates, let the user pick, swap with the chosen address; tell the user the warnings of any token whose risk is not low.