Trading Server Live

Get quotes, place trades and manage your portfolio, with your keys kept on your device. You sign every transaction locally.

Server URLLive

https://mcp.truemarkets.co/mcp

Authentication

You log in with a code we email to your True Markets account: call login_request_code with your email, then login_verify_code with the code. Market data tools work without login; trading tools require it.

Your keys stay on your device

Every transaction follows a prepare, sign, execute pattern. We never hold or see your signing key. Only signed transaction payloads reach us.

1. Prepare: the server builds the unsigned transaction payloads.
2. Sign: you sign the payloads locally with your signing key on your own device.
3. Execute: the signed payloads go back for on-chain execution.

Tools

The tools, grouped by what they do.

Authentication

login_request_code

Request an email verification code to log in.

Parameters

Name	Type	Required	Description
email	string	Yes	Email address for your True Markets account

login_verify_code

Verify the email code and complete login.

Parameters

Name	Type	Required	Description
code	string	Yes	Verification code from email

Account & Balances

get_profile

Show account details including email and wallet addresses. Requires login.

get_balances

Show token balances across wallets. Requires login.

Quotes & Pricing

get_quote

Get a price quote for a token swap. Shows the amount you'll receive and any fees.

Parameters

Name	Type	Required	Description
chain	string	No	Blockchain network for an on-chain swap. Omit it for an exchange (CeFi) order.
side	string	Yes	Order side (buy, sell)
base_asset	string	Yes	Token symbol or contract address to trade
qty	string	Yes	Amount to trade
qty_unit	string	No	Quantity unit: 'base' (token amount) or 'quote' (USDC amount). Defaults to 'quote' for buys and 'base' for sells.

Trading

trade_prepare

Create a market order. Returns an order_id and, when signing is needed, unsigned payloads for client signing. Requires login.

Parameters

Name	Type	Required	Description
chain	string	No	Blockchain network for an on-chain swap. Omit it for an exchange (CeFi) order.
side	string	Yes	Order side (buy, sell)
base_asset	string	Yes	Token symbol or contract address to trade
qty	string	Yes	Amount to trade
qty_unit	string	No	Quantity unit: 'base' (token amount) or 'quote' (USDC amount). Defaults to 'quote' for buys and 'base' for sells.

trade_execute

Execute a prepared trade with client-provided signatures. Call trade_prepare first.

Parameters

Name	Type	Required	Description
order_id	string	Yes	Order ID from trade_prepare
signatures	string	Yes	JSON array of Turnkey stamps, one per payload from trade_prepare

Market Data

list_assets

List all tradeable tokens with symbol, name, chain, address, and decimals.

Parameters

Name	Type	Required	Description
chain	string	No	Filter by chain ("solana" or "base")

get_asset

Get details for a specific token by chain and contract address.

Parameters

Name	Type	Required	Description
chain	string	Yes	Chain name
address	string	Yes	Contract address

get_price_history

Get historical price data for one or more tokens.

Parameters

Name	Type	Required	Description
symbols	string	Yes	Comma-separated token symbols
window	string	No	Time window (1h, 4h, 1d, 7d, 30d, 1M)
resolution	string	No	Data resolution (5s, 1m, 5m, 15m, 1h, 4h, 1d)

get_market_summary

Get an AI-generated market digest with trending assets and sentiment analysis.

get_trending_assets

Get assets trending by trading volume.

Parameters

Name	Type	Required	Description
limit	string	No	Max results to return (default: 10, max: 50)
sort	string	No	Sort order: desc (default) or asc

get_surging_assets

Get assets with the highest recent price change percentage.

Parameters

Name	Type	Required	Description
limit	string	No	Max results to return (default: 10, max: 50)
sort	string	No	Sort order: desc (default) or asc

get_market_cap

Get the market capitalization for a specific asset by symbol.

Parameters

Name	Type	Required	Description
symbol	string	Yes	Asset symbol (e.g., BTC, ETH, SOL)

list_market_caps

List all assets ranked by market capitalization in descending order.

Parameters

Name	Type	Required	Description
limit	string	No	Max results to return (default: 10, max: 50)

get_asset_summary

Get a daily AI-generated summary for a specific asset including news analysis and sentiment.

Parameters

Name	Type	Required	Description
symbol	string	Yes	Asset symbol (e.g., BTC, ETH, SOL)

get_asset_summary_history

Get historical daily summaries for a specific asset.

Parameters

Name	Type	Required	Description
symbol	string	Yes	Asset symbol (e.g., BTC, ETH, SOL)
limit	string	No	Number of historical summaries (default: 7, max: 30)

Next steps

• Examples: a full buy walked through tool by tool.
• Setup for Claude: connect this server to your client.