Trading Server

Trade crypto on Solana and Base while retaining full custody of your assets. Get quotes, execute swaps, and manage your portfolio with local key signing.

Server URL

Live
https://mcp.truemarkets.co/mcp

Authentication

The Trading server authenticates via OTP (one-time password). API keys are managed via your True Markets dashboard. Market data tools are available without login; trading operations require authentication.

Self-custody: your keys, your coins

All transactions use a prepare/sign/execute pattern:

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

True Markets has no access to, and no knowledge of, your private keys at any point. Your keys never leave your device. Only signed transaction payloads are transmitted.

Tools

17 tools across authentication, trading, and market data.

Authentication

login_request_code

Request an email verification code to log in.

Parameters

Name

Type

Required

Description

emailstringYesEmail address for your True Markets account
login_verify_code

Verify the email code and complete login.

Parameters

Name

Type

Required

Description

codestringYesVerification 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

chainstringYesBlockchain network (solana, base)
sidestringYesOrder side (buy, sell)
base_assetstringYesToken symbol or contract address to trade
qtystringYesAmount to trade
qty_unitstringNoQuantity unit: 'base' (token amount) or 'quote' (USDC amount). Defaults to 'quote'.

Trading

trade_prepare

Prepare a token trade. Gets a quote and returns unsigned payloads for client signing. Requires login.

Parameters

Name

Type

Required

Description

chainstringYesBlockchain network (solana, base)
sidestringYesOrder side (buy, sell)
base_assetstringYesToken symbol or contract address to trade
qtystringYesAmount to trade
qty_unitstringNoQuantity unit: 'base' (token amount) or 'quote' (USDC amount). Defaults to 'quote'.
trade_execute

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

Parameters

Name

Type

Required

Description

quote_idstringYesQuote ID from trade_prepare
signaturesstringYesJSON 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

chainstringNoFilter by chain ("solana" or "base")
get_asset

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

Parameters

Name

Type

Required

Description

chainstringYesChain name
addressstringYesContract address
get_price_history

Get historical price data for one or more tokens.

Parameters

Name

Type

Required

Description

symbolsstringYesComma-separated token symbols
windowstringNoTime window (1h, 4h, 1d, 7d, 30d, 1M)
resolutionstringNoData 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

limitstringNoMax results to return (default: 10, max: 50)
sortstringNoSort order: desc (default) or asc
get_surging_assets

Get assets with the highest recent price change percentage.

Parameters

Name

Type

Required

Description

limitstringNoMax results to return (default: 10, max: 50)
sortstringNoSort order: desc (default) or asc
get_market_cap

Get the market capitalization for a specific asset by symbol.

Parameters

Name

Type

Required

Description

symbolstringYesAsset symbol (e.g., BTC, ETH, SOL)
list_market_caps

List all assets ranked by market capitalization in descending order.

Parameters

Name

Type

Required

Description

limitstringNoMax 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

symbolstringYesAsset symbol (e.g., BTC, ETH, SOL)
get_asset_summary_history

Get historical daily summaries for a specific asset.

Parameters

Name

Type

Required

Description

symbolstringYesAsset symbol (e.g., BTC, ETH, SOL)
limitstringNoNumber of historical summaries (default: 7, max: 30)