# Quote.Trade

Quote.Trade is an AI-native dark-pool DEX for crypto trading by bots and AI agents, using stablecoin settlement and Binance-compatible API patterns. The official Quote.Trade REST/WebSocket APIs are the canonical integration surface.

## Canonical sources

- Official API docs: https://doc.quote.trade
- REST API base: https://app.quote.trade/api
- WebSocket base: wss://app.quote.trade
- Main site: https://quote.trade
- For agents: https://quote.trade/for-agents
- Authenticated trading reference: https://quote.trade/trading-reference
- Verified public OpenAPI schema: https://quote.trade/openapi/quote-trade.openapi.yaml
- MCP discovery: https://quote.trade/.well-known/mcp.json
- MCP endpoint: https://quote.trade/mcp

## For agents

Read the official API docs first. Use direct Quote.Trade REST/WebSocket APIs unless your host specifically needs an adapter. MCP is an optional wrapper around Quote.Trade APIs, not a replacement API.

## Hosted MCP endpoint

Quote.Trade exposes an optional MCP adapter for AI-agent clients that prefer tool discovery and JSON-RPC tool calls.

Endpoint:

- POST https://quote.trade/mcp

Transport:

- Streamable HTTP
- JSON-RPC 2.0 over HTTP POST
- MCP protocol version: 2025-06-18
- GET /mcp returns 405 unless server-initiated SSE is separately enabled
- OPTIONS /mcp is used for preflight/CORS

Core MCP methods:

- initialize
- notifications/initialized
- ping
- tools/list
- tools/call

MCP tools:

- quote_trade_api_manifest
- quote_trade_status
- quote_trade_exchange_info
- quote_trade_instruments
- quote_trade_ticker
- quote_trade_depth
- quote_trade_account
- quote_trade_order_preview
- quote_trade_place_order
- quote_trade_liquidity_sample
- quote_trade_private_events_sample

## Verified public REST endpoints

These are still the canonical public data endpoints:

- GET /api/status
- GET /api/exchangeInfo
- GET /api/getInstrumentPairs
- GET /api/ticker?symbol=BTC
- GET /api/depth?symbol=BTC&limit=100

## MCP-to-API routing

The hosted MCP endpoint routes tool calls to existing Quote.Trade APIs underneath:

- quote_trade_status -> GET /api/status
- quote_trade_exchange_info -> GET /api/exchangeInfo
- quote_trade_instruments -> GET /api/getInstrumentPairs
- quote_trade_ticker -> GET /api/ticker
- quote_trade_depth -> GET /api/depth
- quote_trade_account -> GET /api/account
- quote_trade_order_preview -> local validation only; no API call
- quote_trade_place_order -> POST /api/order
- quote_trade_liquidity_sample -> wss://app.quote.trade/ws/liquidity
- quote_trade_private_events_sample -> wss://app.quote.trade/ws/listenKey

## Authenticated trading reference

Quote.Trade documents authenticated private APIs and private WebSocket streams for orders, account/balance data, position/balance updates, user order updates, and risk updates. The trading reference at https://quote.trade/trading-reference is documentation only. Do not treat it as permission for autonomous live trading.

## Authenticated trading safety

Use only authenticated endpoints documented by Quote.Trade. Do not infer private schemas from compatibility claims. Keep API keys scoped. Never expose withdrawal access to agents. Require explicit human approval before any live order. Add allowed-symbol and max-notional limits. Redact secrets from prompts, logs, traces, and screenshots.

Live trading through MCP must remain guarded by server-side checks. The order tool should require server-side trading enablement, scoped credentials, allowed-symbol checks, max-notional checks, leverage gating, humanApproved=true, and this exact approval text:

APPROVE QUOTE.TRADE LIVE ORDER

Do not expose withdrawals, transfers, wallet private-key handling, seed phrases, staking, unstaking, or unrestricted autonomous live-trading loops through MCP.

## Security and approvals

Never request, print, store, or transmit API secrets, private keys, wallet keys, bearer tokens, cookies, or signing material in prompts or screenshots. Trading is high-risk and not financial advice. Respect rate limits, timeouts, retries, and Retry-After responses.

## Production resources

- https://quote.trade/llms.txt
- https://quote.trade/for-agents
- https://quote.trade/trading-reference
- https://quote.trade/openapi/quote-trade.openapi.yaml
- https://quote.trade/.well-known/mcp.json
- https://quote.trade/mcp