truemarkets-mcp-server

Get the current price of a token in USDC by running a zero-cost quote.

Resolves token symbols (SOL, ETH) to addresses automatically. Does NOT require an API key — only auth token.

Args:

• token (string): Token symbol (e.g. "SOL") or contract address

• chain (string): "solana" or "base" (default: "solana")

Returns: { token, chain, price_usdc, qty_in, qty_out }

Get token balances for the authenticated user across all chains.

Args:

• chain (string, optional): Filter by "solana" or "base"

Returns: Array of { symbol, chain, balance, name }

List all tokens available for trading on True Markets.

Args:

• chain (string, optional): Filter by "solana" or "base"

Returns: Array of { symbol, name, chain, address }

Get the authenticated user's profile including email and wallet addresses.

Returns: { email, wallets: [{ chain, address }] }

Request a quote for buying or selling a token. Returns pricing info and a quote_id that can be passed to tm_execute_trade within 60 seconds.

IMPORTANT: Always call this BEFORE tm_execute_trade. Inspect the quote (price, fee, issues) and only execute if acceptable. This solves the price uncertainty problem — you see the exact price you'll get.

Args:

• side ("buy" | "sell"): Trade direction

• token (string): Token symbol (SOL, ETH) or contract address

• amount (string): Quantity as a decimal string

• chain ("solana" | "base"): Blockchain network (default: solana)

• qty_unit ("base" | "quote"): What the amount represents (default: "quote" for buy, "base" for sell)

Returns: { quote_id: string, // Pass this to tm_execute_trade side, token, chain, you_pay: string, // Amount + asset you send you_receive: string, // Amount + asset you get fee: string, effective_price: string, // USDC per token issues: [], // Any problems (e.g. insufficient balance) expires_in_seconds: 60 }

Execute a trade using a quote_id from tm_get_quote.

IMPORTANT: Only call this after inspecting the quote from tm_get_quote. The quote must be less than 60 seconds old and have no issues.

This tool signs the quote payloads with the user's Turnkey API key and submits the trade. It is irreversible.

Args:

• quote_id (string): The quote_id from tm_get_quote

Returns: { success, order_id, tx_hash, explorer_url }

Prepare a transfer to an external wallet address. Returns transfer details and a transfer_id for execution with tm_execute_transfer.

Args:

• to (string): Destination wallet address

• token (string): Token symbol or contract address

• amount (string): Quantity as decimal string

• chain ("solana" | "base"): Chain (default: solana)

• qty_unit ("base" | "quote"): Amount unit (default: base)

Returns: { transfer_id, to, token, amount, chain }

Execute a transfer prepared with tm_prepare_transfer. Irreversible.

Args:

• transfer_id (string): From tm_prepare_transfer

Returns: { success, tx_hash, chain, sent, fee, explorer_url }