Quote.Trade MCP Adapter

Quote.Trade é uma DEX de dark pool cripto nativa de IA para traders humanos, bots de trading e agentes de IA. Ela combina cotações em streaming, execução privada, liquidação em stablecoin, exposição de mercado longa e curta, e infraestrutura verificável de posições e ativos on-chain. As APIs REST/WebSocket oficiais do Quote.Trade permanecem como a superfície de integração canônica para acesso programático.

Para quem é o Quote.Trade

• Traders humanos que desejam negociar exposição de mercado cripto suportada sem adquirir e fazer bridge de cada token subjacente.
• Traders conscientes de estratégia e de maior porte que não desejam que suas ordens sejam publicadas em um livro de ordens público antes da execução.
• Equipes de API e bots que precisam de dados de mercado em atualização contínua, cotações de liquidez em streaming e padrões REST/WebSocket compatíveis com Binance.
• Construtores de agentes de IA que precisam de OpenAPI, descoberta MCP, pré-visualizações de ordens protegidas, controles de ordens ao vivo com escopo e aprovação humana explícita.
• Usuários profissionais e institucionais aprovados que exigem o modelo permissionado de custódia e relatórios do Quote.Trade Pro.

Principais diferenciais

• Cotações em streaming, não apenas RFQ de uma única chamada: O Quote.Trade expõe cotações de liquidez em atualização contínua por meio de suas interfaces ao vivo de dados de mercado e WebSocket, apoiando a descoberta contínua de preços antes da execução.
• Execução privada de ordens: As ordens não são publicadas em um livro de ordens público. O Quote.Trade recebe os parâmetros necessários para executar, não a lógica de portfólio ou a estratégia mais ampla do trader.
• Acesso de mercado financiado por stablecoin: Os usuários financiam com uma stablecoin suportada e negociam exposição de mercado longa ou curta suportada sem fazer bridge de cada token subjacente.
• Ampla cobertura de mercado: O Quote.Trade suporta mais de 1.500 mercados cripto, com informações de exchange ao vivo como fonte da verdade para símbolos e especificações ativos.
• Custo total transparente: As cotações apresentam o preço de execução sem uma taxa de negociação separada adicionada posteriormente, inclusive para tamanhos maiores que podem sofrer slippage em outros ambientes.
• Roteamento automatizado de liquidez: A liquidez disponível é avaliada automaticamente para retornar a melhor cotação disponível por meio do fluxo de roteamento suportado.
• Infraestrutura verificável sem permissão: Ativos, atividade de financiamento, saques e estado de posições podem ser revisados por meio de contratos inteligentes públicos sem permissão e não atualizáveis, e links de explorador.
• Construído para humanos, bots e agentes: O aplicativo, a API REST, os streams WebSocket, o esquema OpenAPI, o bot Telegram, o endpoint MCP, a skill Hermes, a skill OpenClaw e os clientes de código aberto compartilham a mesma infraestrutura de trading de produção.

Como privacidade e verificação funcionam juntas

O Quote.Trade usa uma arquitetura híbrida. Entrada de ordens, matching, formação de cotações em streaming, precificação e controles de risco operam por meio da camada de execução de dark pool off-chain. O financiamento e os saques com stablecoin suportada usam caminhos de financiamento por contratos inteligentes, enquanto o estado de posições é mantido por meio de contratos públicos de posições on-chain.

Execução privada não significa que toda a plataforma seja invisível ou totalmente on-chain. Ordens e estratégias de trading mais amplas não são publicadas em um livro de ordens público, enquanto ativos, saldos de contratos, atividade de financiamento e estado de posições permanecem publicamente verificáveis onde o produto sem permissão os expõe.

Os snapshots de posição da Polygon e da XDC são reconciliados com os saldos publicados na V6, enquanto esses saldos são comparados com os USDC/USDT reais mantidos nos contratos de financiamento da Ethereum e da XDC. Isso fornece uma verificação matemática dos saldos publicados e sua cobertura de garantia, mantendo negociações individuais, contrapartes, roteamento e volume privados.

A V6 é nova porque é a nova versão do contrato. A V6 é não atualizável, portanto, nova lógica de contrato exige uma nova implantação e migração em vez de modificar o contrato existente no local.

Não re-hipoteca e cobertura de garantia

Os controles de não re-hipoteca da V6 são aplicados em seu código não atualizável. A garantia ERC-20 suportada não tem caminho de empréstimo de uso geral, aprovação de gastos por terceiros ou transferência arbitrária; os pagamentos devem passar pelos controles de saque da carteira registrada. Para verificar a garantia, reconcilie as posições publicadas com os saldos de financiamento publicados e compare os ativos reais do contrato de financiamento com a soma dos saldos positivos dos usuários no mesmo snapshot concluído. Ativos maiores que esses passivos publicados estabelecem um superávit naquele snapshot.

Consulte a referência de verificação para um exemplo prático e as evidências necessárias para um resultado de cobertura datado.

Versões do produto

• Quote.Trade sem permissão usa financiamento por contrato inteligente com stablecoin suportada, infraestrutura pública de estado de posições e execução de dark pool off-chain.
• Quote.Trade Pro é a versão permissionada para usuários profissionais e institucionais aprovados, usando um custodiante qualificado ou acordo de custódia aprovado com onboarding e relatórios institucionais.

Principais resultados para o cliente

• Monitore cotações em streaming e liquidez disponível antes de negociar.
• Negocie longo ou curto em mercados cripto suportados a partir de uma conta financiada por stablecoin.
• Mantenha ordens fora de um livro de ordens público e reduza a exposição da estratégia por trás da negociação.
• Veja um preço de execução transparente e total, sem taxa de negociação separada.
• Verifique contratos públicos, ativos financiados, saques e estado de posições.
• Integre por meio do aplicativo web, Telegram, REST, WebSocket, OpenAPI, MCP ou clientes de bot de código aberto.

Superfícies de integração para agentes

O Quote.Trade fornece interfaces REST, WebSocket, OpenAPI, MCP, Hermes, OpenClaw, Telegram e clientes de código aberto para dados de mercado, acesso à conta, depósitos, trading privado e saques. REST e WebSocket permanecem como as interfaces de aplicação canônicas. O MCP fornece uma camada de ferramentas hospedadas para clientes de agentes.

Proteções verificáveis de contratos inteligentes

A arquitetura V6 sem permissão é projetada para resiliência de chaves operacionais. A V6 é um núcleo de financiamento direto e não atualizável, com funções separadas de admin, guardião, gestor de ativos, publicador de saldos e executor de saques. Cada ação autorizada permanece sujeita às regras de liberação do contrato e ao estado público.

A V6 aplica:

• liquidação em carteira registrada em vez de um destino de saque arbitrário;
• autoridade separada para publicação de saldos e execução de saques;
• três observações de saldo qualificadas com pelo menos 22 horas de intervalo;
• um teto compartilhado com base na observação mais baixa, com saques limitados a 1,5× a base do teto consolidado;
• estado completo de publicação em várias partes antes da elegibilidade para saque;
• um período de espera de dez minutos após a publicação;
• identificadores de saque de uso único e proteção contra replay;
• verificações físicas de liquidez em stablecoin antes do pagamento;
• invariantes exatos de conversão decimal, débito de contrato e crédito ao destinatário;
• execução de saque sem reentrância;
• controles condicionais de velocidade de 3% por hora e 18% por dia por token quando o saldo físico do token está no limite de produção de US$ 1 milhão ou acima;
• um período de proposta de sete dias para mudanças na composição do colateral; e
• um congelamento de emergência de três dias, rotação de época de signatários, concessões de função renovadas, um piso elevado de histórico de saldos e observações válidas com cadência atualizada antes da retomada do processamento normal de pagamentos.

Se uma chave operacional for comprometida, os outros controles no nível do contrato continuam a se aplicar. Uma chave de publicador de saldos não pode, por si só, executar um saque ou tornar um saldo recém-publicado imediatamente elegível. Uma chave de executor de saques não pode selecionar um destinatário arbitrário ou contornar o saldo publicado, o teto consolidado, o período de espera, o snapshot concluído, a liquidez física, o replay, a época de signatários e as verificações exatas de transferência. Uma ação de admin não pode substituir a lógica central da V6 no local porque a V6 não tem caminho de atualização por proxy. Atividades de função, configuração, associação, publicação, emergência e saque permanecem publicamente observáveis on-chain.

Reconciliação de saldos e posições entre Ethereum, Polygon e XDC

A contabilidade pública sem permissão do Quote.Trade é verificada unindo as camadas de financiamento, saldo publicado e estado de posições no mesmo snapshot concluído:

• Camada de financiamento Ethereum: A V6 na Ethereum mantém USDC e USDT suportados e publica os saldos de saque correspondentes de usuário/composição.
• Camada de posições Polygon: O PositionManager na Polygon publica as posições de usuário correspondentes, mapeamentos de ativos, escalas de quantidade, identificadores de snapshot, tempo de sincronização e estado de conclusão de lote usados para reconciliar contas financiadas pela Ethereum.
• Camada de financiamento XDC: A V6 na XDC mantém USDC suportado e publica os saldos de saque correspondentes de usuário/composição.
• Camada de posições XDC: O PositionManager na XDC publica as posições de usuário XDC correspondentes e o estado de snapshot concluído.

O PositionManager é um contrato de estado de posições, não uma carteira de financiamento em stablecoin. Seu saldo de token não é a medida da garantia do cliente. A garantia física é medida nos contratos de financiamento da V6; posições e integridade de snapshot são medidas no PositionManager.

Para cada snapshot de reconciliação:

1. Confirme os endereços oficiais da V6 e do PositionManager e a rede aplicável. 2. Exija que a publicação de saldo da V6 e a publicação de posições do PositionManager estejam completas. 3. Exija processedBatches == totalBatches e confirme que lastSyncedTime está atualizado em relação a syncFrequency. 4. Alinhe carteira registrada, ID de usuário, ID de ativo, símbolo, escala de quantidade, composição de garantia, ID de snapshot e timestamp. 5. Normalize valores de stablecoin e quantidades de posições para suas escalas decimais publicadas. 6. Reconcilie o saldo publicado de cada conta com seu financiamento reconhecido, saques concluídos, posições publicadas, marcas sincronizadas, P&L realizado e não realizado, financiamento e ajustes documentados de conta. 7. Some os saldos de saque positivos publicados e compare-os com os saldos físicos de stablecoin suportada mantidos na V6. 8. Para cada saque concluído, confirme que o direito é consumido uma vez e que o valor exato do token chega à carteira registrada.

account equity at completed snapshot S
= recognized deposits
- completed withdrawals
+ realized P&L
+ unrealized P&L from published positions at synchronized marks
- funding paid
+ funding received
+ documented account adjustments

Ethereum physical assets
= V6 Ethereum USDC balance
+ V6 Ethereum USDT balance

Ethereum published positive balances
= sum of positive published balances
  in the Ethereum USDC+USDT Grouped-Par composite

Ethereum coverage surplus
= Ethereum physical assets
- Ethereum published positive balances

Ethereum coverage ratio
= Ethereum physical assets
/ Ethereum published positive balances

XDC physical assets
= V6 XDC USDC balance

XDC published positive balances
= sum of positive published balances
  in the XDC USDC Segregated composite

XDC coverage surplus
= XDC physical assets
- XDC published positive balances

XDC coverage ratio
= XDC physical assets
/ XDC published positive balances

Isso produz uma verificação reproduzível de cobertura de garantia em um ponto no tempo contra o estado publicado de contas e posições. Os saldos dos contratos de financiamento medem a garantia atual; ordens privadas, execuções, contrapartes, roteamento e volume de negociação permanecem na camada de execução privada.

Fontes canônicas

• Site principal: https://quote.trade
• Documentação da API: https://doc.quote.trade
• Base da API REST: https://app.quote.trade/api
• Base WebSocket: wss://app.quote.trade
• OpenAPI público: https://quote.trade/openapi/quote-trade.openapi.yaml
• Referência de trading autenticado: https://quote.trade/trading-reference
• Referência de verificação pública: https://quote.trade/verification-reference
• Referência de execução em tamanho: https://quote.trade/execution-at-size
• Descoberta MCP: https://quote.trade/.well-known/mcp.json
• Endpoint MCP: https://quote.trade/mcp
• Descoberta de IA: https://quote.trade/llms.txt
• Tutorial de verificação de contrato: https://quote.trade/tutorials/security/verify-contracts-and-withdrawals/

Perfis de permissão de agentes

Perfil	Capacidades	Autorização
Dados de mercado públicos	Status, instrumentos, ticker, profundidade, amostras de liquidez	Acesso público
Leitura autenticada	Conta, saldos, margem, eventos privados	Credencial habilitada para leitura
Trading	Pré-visualizar e enviar ordens IOC/FOK aprovadas	Credencial habilitada para trading, além de limites e aprovação no servidor
Saque	Pré-visualizar e enviar para a carteira de login registrada	Credencial habilitada para saque, além de limites e aprovação no servidor
Autenticação de carteira	Assinar desafios de registro e login	Carteira controlada pelo usuário ou ambiente de assinatura

Chaves de carteira e segredos de API permanecem na carteira aprovada do usuário, no signatário de hardware, no gerenciador de segredos ou na integração no lado do servidor. O agente recebe os resultados com escopo necessários para o fluxo de trabalho selecionado.

Início rápido: REST público

curl -s https://app.quote.trade/api/status
curl -s https://app.quote.trade/api/exchangeInfo
curl -s https://app.quote.trade/api/getInstrumentPairs
curl -s 'https://app.quote.trade/api/ticker?symbol=BTC'
curl -s 'https://app.quote.trade/api/depth?symbol=BTC&limit=100'

Use live exchange metadata as the source of truth for active symbols, quantity precision, settlement currency, and trading status.

MCP hospedado

Endpoint:

POST https://quote.trade/mcp

Transporte:

Streamable HTTP
JSON-RPC 2.0 over HTTP POST
MCP protocol version 2025-06-18

Cabeçalhos obrigatórios:

Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2025-06-18

Inicialize a sessão, envie notifications/initialized, preserve qualquer MCP-Session-Id retornado e chame tools/list antes de fluxos de trabalho privados.

Ferramentas MCP documentadas

quote_trade_api_manifest
quote_trade_get_challenge
quote_trade_logon
quote_trade_get_deposit_address
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_withdraw_preview
quote_trade_withdraw
quote_trade_liquidity_sample
quote_trade_private_events_sample

A resposta ao vivo de tools/list fornece os esquemas de entrada atuais, esquemas de saída, anotações de segurança e capacidades habilitadas.

Registro e login

Chaves de API Quote.Trade existentes podem se conectar sem login por wallet. Envie X-MBX-APIKEY e X-MBX-APISECRET como cabeçalhos para o endpoint MCP oficial e forneça o ID da conta para ações ao vivo. O servidor MCP hospedado recebe o segredo e assina as solicitações downstream. Chamadas REST diretas continuam usando o cabeçalho HMAC signature documentado.

1. Chame quote_trade_get_challenge com a wallet de login. 2. Apresente o desafio à wallet aprovada do usuário ou ao signatário. 3. Assine o desafio exato nesse ambiente. 4. Chame quote_trade_logon com o challenge original, seu signature e a configuração atual de isNewUser. 5. Armazene o requestToken, o requestSecret e o ID da conta retornados no gerenciador de segredos do usuário. 6. Use essas credenciais com escopo para a sessão de conta atual.

A assinatura por wallet pode ser orquestrada por agente enquanto o material de assinatura permanece sob controle do usuário.

Fluxo de depósito

1. Chame quote_trade_get_deposit_address para o ativo e a rede suportados. 2. Exiba a chain, o token, o endereço do contrato, o endereço de depósito e as casas decimais do token. 3. Faça a wallet do usuário transferir a stablecoin selecionada. 4. Registre o hash da transação e o bloco de confirmação. 5. Confirme o reconhecimento do depósito por meio do endpoint da conta ou do fluxo de eventos privados.

O saldo de token do contrato de funding é uma medição de garantia em um ponto no tempo. Ordens e execuções ocorrem na camada de execução privada.

Fluxo de cotação e ordem

1. Leia quote_trade_exchange_info ou quote_trade_instruments. 2. Leia dados atualizados de ticker, profundidade ou liquidez. 3. Construa a solicitação imediata IOC/FOK com símbolo, lado, quantidade, preço limite executável ou tolerância, moeda de liquidação, conta e configuração de alavancagem. 4. Chame quote_trade_order_preview. 5. Exiba a ordem normalizada, o valor nocional, o preço, a quantidade, o lado, a conta, a alavancagem e os limites ativos no lado do servidor. 6. Obtenha aprovação específica da solicitação. 7. Chame quote_trade_place_order. 8. Verifique o status final por meio da resposta, do estado da conta e dos eventos privados.

Valores de aprovação MCP atuais:

humanApproved=true
approvalText="APPROVE QUOTE.TRADE LIVE ORDER"

Use os controles do lado do servidor de símbolos permitidos, nocional máximo, alavancagem, idade da cotação, tolerância de preço e idempotência.

Fluxo de saque para agentes

Saques por agentes são um fluxo de trabalho aprovado do Quote.Trade.

1. Leia quote_trade_account e confirme canWithdraw, o valor disponível, o estado da margem e a elegibilidade atual. 2. Chame quote_trade_withdraw_preview com o ativo, a quantidade escalada e a escala de quantidade do esquema ao vivo. 3. Exiba a chain, o ativo, o valor legível, o valor escalado, a conta, a wallet de login registrada, o valor elegível atual e o identificador da solicitação. 4. Obtenha aprovação específica para o saque. 5. Chame quote_trade_withdraw usando exatamente o esquema ao vivo. 6. Preserve o ID da solicitação ou do saque. 7. Verifique a atualização da conta e o pagamento exato on-chain para a wallet de login registrada.

Valores de aprovação MCP atuais:

humanApproved=true
approvalText="APPROVE QUOTE.TRADE LIVE WITHDRAW"

O caminho de saque via MCP fixa a wallet de login registrada como destino. O agente fornece o ativo e o valor aprovados.

Conta e fluxos privados

Fluxos de trabalho autenticados podem usar:

GET https://app.quote.trade/api/account
wss://app.quote.trade/ws/listenKey

Eventos privados fornecem atualizações de saldo e posição, atualizações de ordens e atualizações de risco. Mantenha os tokens de solicitação dentro da sessão de cliente autorizada e use verificações limitadas de reconexão, sequência e atualização.

Preço all-in e execução em volume

O preço exibido do Quote.Trade inclui o spread de execução e o ajuste de tamanho/liquidez. O funding é separado e acumula durante o período de manutenção da posição.

A meta de preço padrão programada para a semana de 2026-08-31 é de aproximadamente 13 pontos-base do ponto médio por lado. A cotação ao vivo específica por tamanho é a autoritativa.

Para um benchmark de execução de US$ 1 milhão:

1. Capture a cotação FOK ao vivo de US$ 1 milhão do Quote.Trade. 2. Obtenha uma execução imediata de taker de US$ 1 milhão concluída na plataforma de comparação sob condições sincronizadas. 3. Registre a quantidade efetivamente executada, o valor total pago ou recebido, o preço de execução all-in efetivo, a taxa de taker, o impacto de mercado realizado, a quantidade residual e o custo aplicável de transferência ou prioridade. 4. Compare o funding no mesmo período de manutenção.

Este método compara execução concluída em volume com execução concluída em volume.

Funding público e reconciliação de posições

O caminho de verificação pública combina:

• Saldos físicos de stablecoins V6 em Ethereum e XDC;
• Saldos de usuários publicados e estado de limite do V6;
• Estado de posição e snapshot concluído do PositionManager em Polygon e XDC;
• Transferências de depósito e saque concluído ERC-20;
• marcas sincronizadas e entradas de reconciliação de conta.

Em um snapshot concluído:

coverage surplus
= physical stablecoin assets
- aggregate positive published withdrawal balances

coverage ratio
= physical stablecoin assets
/ aggregate positive published withdrawal balances

Para Ethereum, combine os ativos V6 USDC e USDT com a obrigação de saldo compartilhada Grouped-Par USDC+USDT. Para XDC, compare os ativos V6 USDC com a obrigação de saldo segregado USDC da XDC. O PositionManager fornece evidências correspondentes de posição do usuário e snapshot concluído.

Proteções de pagamento V6 e chave operacional

O V6 combina:

• implantação direta do núcleo não atualizável;
• funções separadas de admin, guardian, asset-manager, balance-publisher e withdrawal;
• liquidação por wallet registrada;
• três observações qualificadas com pelo menos 22 horas de intervalo;
• um limite compartilhado de 1,5x no slot mais baixo;
• um cooldown de 10 minutos após a publicação;
• conclusão estrita de publicação em várias partes;
• IDs de saque de uso único;
• verificações físicas de liquidez de token;
• controles condicionais de 3% por hora e 18% por dia por token no limite de produção de US$ 1 milhão ou acima;
• um período de proposta de sete dias para mudanças na composição do grupo;
• conversão exata de unidades e verificações exatas de débito/crédito de token;
• execução de saque sem reentrância;
• um congelamento de emergência de três dias e rotação de época do signatário.

Essas proteções permanecem aplicadas pelo núcleo V6 em torno das operações de publisher, saque e gerenciamento de ativos. O destinatário registrado, o limite histórico, a cadência de publicação, o estado de replay, a liquidez física, os invariantes de transferência e a época de emergência continuam a governar a elegibilidade de pagamento.

Tratamento determinístico de resultados

Para cada solicitação que altera o estado:

1. Use um identificador estável de cliente ou solicitação quando suportado pelo esquema ao vivo. 2. Armazene o corpo da solicitação enviada e o timestamp. 3. Classifique um timeout ou resposta HTTP 5xx como UNKNOWN. 4. Consulte o estado autoritativo de ordem, conta, solicitação, evento privado e chain. 5. Preserve o identificador original ao resolver o status. 6. Registre o resultado autoritativo final.

Skills

Hermes e Agent Skills:

https://quote.trade/.well-known/skills/quote-trade-operator/SKILL.md

OpenClaw:

openclaw skills install @quotetrade/quote-trade-operator

As skills ensinam a mesma arquitetura, dados de mercado, login, depósitos, ordens IOC/FOK, saques por agentes, reconciliação pública e metodologia de execução em volume documentadas aqui.