---
title: "Trading Server"
url: https://docs.truemarkets.co/mcp/servers/trading
description: "Reference for the True Markets Trading MCP server, its email-code login, local signing and every tool."
---

Docs index: https://docs.truemarkets.co/llms.txt

# 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](https://docs.truemarkets.co/mcp/examples)**: a full buy walked through tool by tool.
-   **[Setup for Claude](https://docs.truemarkets.co/mcp/setup/claude)**: connect this server to your client.