Kyber (on-chain spot)

Kyber-powered spot swaps via the trading provider family. Quote, build, and execute on Base and multi-chain EVM.

Category: Trading

Catalog provider: trading (Kyber is the primary on-chain swap router behind spot actions, not a separate provider filter).

Thirdfy exposes Kyber quote and swap execution through governed catalog actions such as swap, get_best_trading_quote, and execute_optimal_swap. Sponsored Kyber execution is validated on Base mainnet; other chains may be quote-only or deployment-specific.

Credential model

PathAuthority
Delegated userGator/ERC-7710 delegation or active Thirdfy binding
agent_walletAgent-owned wallet for solo automation
selfLocal signer returns unsigned or signed txs per action

No Kyber API keys in Thirdfy. Execution is on-chain through validated router calldata.

Discovery

SurfaceExample
MCPgetProviderActions { provider: "trading" }
CLIthirdfy-agent actions --provider trading --json
RESTGET https://api.thirdfy.com/api/v1/agent/actions/catalog

Use it

Ask your agent:

Using Thirdfy, quote a swap of 10 USDC to WETH on Base and show the route. Do not swap anything.

Kyber has no venue readiness check. The quote is the setup step: it shows the route and output before any swap.

One read. get_best_trading_quote compares routes and may pick Thirdfy, Kyber, Li.Fi or 0x:

MCP
CLI
REST
agentRun { action: "get_best_trading_quote", params: { tokenIn: "USDC", tokenOut: "WETH", amountIn: "10", chainId: 8453 } }

The agent's policy must allow the action. If it does not, the run fails with Action "get-best-trading-quote" is not allowed and lists the allowed actions.

What to check: confirm the chain and token addresses the quote resolved, the route provider and the output amount. slippageTolerance defaults to 1%. Quote again right before a swap.

One write. The swap itself:

MCP
CLI
agentRun { action: "swap", params: { tokenIn: "USDC", tokenOut: "WETH", amountIn: "10", chainId: 8453, maxSlippage: 1 } }

execute_optimal_swap is an alias of swap. amountIn is in token units; pass one amount field only. A high price impact is refused unless you set allowHighImpact: true. Run thirdfy-agent preflight with the same flags to check the params before you send it.

Readiness checklist

  • Correct chainId (Ethereum, Optimism, Unichain, Polygon, Base, Arbitrum per catalog).
  • Slippage and token addresses match catalog param schema.
  • Delegation active before delegated-user swaps.
  • Preflight swap or execute_optimal_swap before live runs.

Execution lanes

runModeUse
thirdfy / hybridFan-out swaps to delegated wallets
agent_walletSolo agent spot execution
selfOperator-signed swap path