spot-trading

Quotes and broadcasts on-chain token swaps and cross-chain bridges via tribes-cli.

1|Updated Jun 17, 2026
One-click install
npx skills add https://github.com/tribes-protocol/trading-harness --skill spot-trading-tribes-protocol
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spot-trading
Source: https://github.com/tribes-protocol/trading-harness/tree/main/skills/spot-trading
Command: npx skills add https://github.com/tribes-protocol/trading-harness --skill spot-trading-tribes-protocol

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Swapping or bridging tokens across EVM chains and Solana requires resolving token contract addresses, converting amounts to base units, obtaining quotes, and broadcasting multi-step transaction sequences in the correct order. This Skill automates that entire flow through the tribes-cli spot-trading command group while enforcing strict safety rules. ## Core Features & Use Cases - Swap and Bridge Quoting: Quotes same-chain swaps and cross-chain bridges (EVM ↔ EVM, EVM ↔ Solana) with tribes-cli spot-trading quote, returning ordered transaction requests. - Token Resolution: Resolves token symbols or names to contract addresses and mints with tribes-cli token search, never guessing identity from a symbol. - Ordered Broadcast: Splits EVM transaction requests into same-chain runs, sends them via sendCalls or sendEthTransaction, handles Solana legs, and polls status after every send. - Use Case: A user wants to swap 0.12 USDC on Base for USDT on Arbitrum. The Skill resolves both token addresses, converts the amount to base units, quotes the bridge, confirms a plain-language summary, then broadcasts the approval and swap transactions in order. ## Quick Start Ask the agent to swap a specific amount of one token for another on named chains, for example swap 0.12 USDC on Base for USDT on Arbitrum, and confirm the quoted summary before broadcast.

Frequently Asked Questions about spot-trading

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I swap tokens across chains with tribes-cli?▼

Run tribes-cli spot-trading quote with from-chain, to-chain, from-token, to-token, from-amount in base units, and from-address. The quote returns ordered transactionRequests that are broadcast via sendCalls or sendEthTransaction after user confirmation.

How do I resolve a token symbol to a contract address?▼

Use tribes-cli token search with the --query flag, then filter results to the destination chainId and take the exact symbol or name match. If multiple candidates remain, ask the user to pick one by name before quoting.

Which chains does spot-trading support for swaps and bridges?▼

Supported chains are Ethereum (1), Base (8453), Arbitrum (42161), BSC (56), Polygon (137), Optimism (10), and Solana. Bridges work EVM to EVM and EVM to Solana, with Solana legs sent as serialized transactions.

Why was my swap amount rejected by the quote command?▼

The --from-amount flag requires base units, not decimal values. For example, 0.12 USDC with 6 decimals must be passed as 120000. Convert using decimal-string arithmetic, never floating-point math.

When should I not use spot-trading for a trade?▼

Do not use it for Hyperliquid perp or spot orders or stock trades, which belong to the hyperliquid skill, or for plain transfers of tokens the user already holds, which belong to zipbox-wallet. It only handles on-chain swaps and bridges.