xRocket Exchange
Usa herramientas semánticas de xRocket MCP. Mantén el análisis público rápido y cada acción privada o financiera con fallo cerrado.
Comenzar de forma segura
- Identifica el entorno y la operación solicitados. El entorno se fija cuando el servidor MCP se inicia: cuando el usuario no especifica uno, exige un servidor configurado en testnet y verifica el
environmentdevuelto por las herramientas antes de cualquier escritura. - Usa
publicpara datos de mercado. Usaprivate-readsolo cuando se necesite el estado de la cuenta. Usafullsolo cuando el usuario solicite explícitamente una acción financiera compatible. - Nunca pidas el token API en el chat ni lo pases como argumento de herramienta. Si una herramienta privada no está disponible, explica la configuración de entorno requerida sin solicitar el secreto.
- Lee references/api-map.md para la selección de herramientas. Lee references/safety.md antes de cualquier escritura, references/errors.md para fallos, y references/advanced-workflows.md para trabajo de varios pasos.
Flujo de trabajo de mercado público
- Resuelve el activo/símbolo con
xrocket_market_symbolsoxrocket_asset_infoantes del análisis. - Obtén solo la evidencia necesaria: cotización, instantánea del libro de órdenes, operaciones, velas, tasas o comisiones de trading.
- Preserva marcas de tiempo y cadenas decimales. Etiqueta campos obsoletos o faltantes; no sintetices tasa de financiación, interés abierto, posiciones, apalancamiento o datos de derivados porque la API auditada no los expone.
- Describe el resultado como una instantánea REST de xRocket, no como un flujo WebSocket en vivo.
Flujo de trabajo de lectura privada
- Confirma que el usuario quiere sus datos de cuenta y que
private-readofullestá configurado localmente. - Usa
xrocket_account_balances,xrocket_orders,xrocket_transfers,xrocket_withdrawals, oxrocket_withdrawal_quotas. - Minimiza la divulgación en la respuesta. No repitas el token bearer, direcciones completas de retiro o datos de cuenta no relacionados.
- Distingue saldos de trading y financiación. Describe las transferencias en Exchange solo como movimientos internos de
funding↔trading.
Flujo de trabajo de escritura financiera
Nunca saltes directamente a una herramienta de ejecución.
- Lee las reglas actuales del símbolo/activo, los saldos relevantes y, cuando corresponda, la cuota de retiro.
- Exige un identificador de cliente único para cada nueva orden, transferencia interna o retiro. La cancelación puede identificar la orden existente por
orderId. - Llama a la herramienta
*_preparecorrespondiente e inspecciona su vista previa exacta. - Presenta entorno, operación, activo/símbolo/red, dirección/lado, cantidad/tamaño/fondos decimal, precio/precio límite, comisión/estimación, destino/cuenta e identificador de cliente. Solicita la aprobación explícita de esa vista previa.
- Ejecuta solo después de la aprobación actual del usuario, pasando únicamente el
approvalReceiptde corta duración devuelto. El servidor recupera la intención exacta almacenada; no reenvíes ni reconstruyas la carga útil. - Lee el estado devuelto por identificador de cliente. En caso de tiempo de espera/desconexión/respuesta ambigua del upstream, reporta resultado desconocido y concilia antes de proponer otro intento. Nunca reintentes automáticamente una escritura.
Mainnet requiere una decisión explícita separada del usuario y XROCKET_ALLOW_MAINNET_WRITES=true. Una aprobación previa en testnet no autoriza mainnet.
Depósitos e incorporación
La API de Exchange auditada no tiene un endpoint de dirección de depósito. No inventes ni aceptes una dirección no verificada. Usa xrocket_onboarding_links para instrucciones de interfaz, divulga que sus CTAs contienen el código de referido kaban y pueden beneficiar al mantenedor, luego actualiza los saldos de financiación después de que el usuario complete el depósito.
Nunca añadas el código de referido a las URLs de API, WebSocket, documentación, repositorio, soporte o MCP. Los CTAs de bots de producción y testnet gestionados por el proyecto devueltos por la herramienta usan la carga útil start=kaban; no inventes otras formas de URL de referido.
Límites estrictos
- No trates las transferencias internas de Exchange como pagos de usuario a usuario. xRocket Pay es un producto separado y no está disponible a través de estas herramientas.
- No conviertas cadenas decimales financieras a través de punto flotante binario.
- No afirmes reconstrucción del libro de órdenes delta, reproducción o integridad de eventos privados; 0.1.0 expone instantáneas REST.
- No copies comportamiento de ofertas/acuerdos no compatible de tutoriales en llamadas API.
- No uses
TONcomo identificador de activo donde los metadatos actuales de Exchange requierenTONCOIN; la redTONy el activoTONCOINson campos diferentes. - No despliegues perfiles privados/de escritura detrás de un endpoint MCP público no autenticado.