---
name: thirdfy-trading
description: "Use Trading through Thirdfy (4 reads, 1 write): one MCP, CLI and API for every agent, with each write checked against the owner's policy before it signs."
---

# Trading through Thirdfy

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

- Status: Live
- 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.
- Directory: https://v2.thirdfy.com/protocols/trading

## Connect

- MCP: `claude mcp add --transport http thirdfy https://mcp.thirdfy.com/mcp` (docs: https://docs.thirdfy.com/documentation/mcp)
- CLI: `npx @thirdfy/agent-cli@latest login` (add `--trade` to allow writes), then `npx @thirdfy/agent-cli@latest whoami`
- The owner allows Trading for the agent: https://v2.thirdfy.com/integrations/trading

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

## Rules

- Call these actions through Thirdfy, not with your own keys: Thirdfy builds each transaction and the owner's policy checks it before it signs.
- A write that the owner has not allowed, or that breaks a limit, is refused before signing and costs nothing.