xRocket Exchange
시맨틱 xRocket MCP 도구를 사용하세요. 공개 분석은 빠르게 유지하고 모든 개인 또는 금융 작업은 실패 시 폐쇄(fail-closed)되도록 하세요.
안전하게 시작하기
- 요청된 환경과 작업을 식별합니다. 환경은 MCP 서버가 시작될 때 고정됩니다. 사용자가 환경을 지정하지 않은 경우, testnet으로 구성된 서버를 요구하고 쓰기 전에 도구가 반환하는
environment를 확인하세요. - 시장 데이터에는
public을 사용하세요. 계정 상태가 필요할 때만private-read을 사용하세요. 사용자가 지원되는 금융 작업을 명시적으로 요청할 때만full을 사용하세요. - 채팅에서 API 토큰을 묻거나 도구 인수로 전달하지 마세요. 비공개 도구를 사용할 수 없는 경우, 비밀을 요청하지 않고 필요한 환경 구성을 설명하세요.
- 도구 선택은 references/api-map.md를 참조하세요. 쓰기 전에 references/safety.md를, 오류 발생 시 references/errors.md를, 다단계 작업 시 references/advanced-workflows.md를 읽으세요.
공개 시장 워크플로우
- 분석 전에
xrocket_market_symbols또는xrocket_asset_info를 사용하여 자산/심볼을 확인합니다. - 필요한 증거만 가져옵니다: 티커, 오더북 스냅샷, 거래 내역, 캔들, 환율 또는 거래 수수료.
- 타임스탬프와 소수 문자열을 보존합니다. 오래되었거나 누락된 필드는 표시하고, 감사된 API가 노출하지 않으므로 펀딩 비율, 미체결 약정, 포지션, 레버리지 또는 파생상품 데이터를 합성하지 마세요.
- 결과를 실시간 WebSocket 스트림이 아닌 xRocket REST 스냅샷으로 설명합니다.
비공개 읽기 워크플로우
- 사용자가 계정 데이터를 원하는지, 그리고 로컬에서
private-read또는full이 구성되었는지 확인합니다. xrocket_account_balances,xrocket_orders,xrocket_transfers,xrocket_withdrawals또는xrocket_withdrawal_quotas를 사용하세요.- 답변에서 공개를 최소화합니다. Bearer 토큰, 전체 출금 주소 또는 관련 없는 계정 데이터를 표시하지 마세요.
- 거래 잔액과 펀딩 잔액을 구분합니다. Exchange 전송은 내부
funding↔trading이동으로만 설명합니다.
금융 쓰기 워크플로우
실행 도구로 바로 건너뛰지 마세요.
- 현재 심볼/자산 규칙, 관련 잔액 및 해당되는 경우 출금 할당량을 읽습니다.
- 모든 새 주문, 내부 전송 또는 출금에 고유한 클라이언트 식별자를 요구합니다. 취소는 대신
orderId로 기존 주문을 식별할 수 있습니다. - 해당
*_prepare도구를 호출하고 정확한 프리뷰를 검사합니다. - 환경, 작업, 자산/심볼/네트워크, 방향/측, 소수 금액/크기/자금, 가격/중단 가격, 수수료/견적, 대상/계정 및 클라이언트 식별자를 제시합니다. 해당 프리뷰에 대한 명시적 승인을 요청합니다.
- 사용자의 현재 승인을 받은 후에만 실행하고, 반환된 단기
approvalReceipt만 전달합니다. 서버는 저장된 정확한 의도를 검색합니다. 페이로드를 다시 제출하거나 재구성하지 마세요. - 클라이언트 식별자로 상태를 다시 읽습니다. 시간 초과/연결 끊김/모호한 업스트림 응답 시 알 수 없는 결과를 보고하고 조정한 후 다른 시도를 제안합니다. 쓰기를 자동으로 재시도하지 마세요.
메인넷은 별도의 명시적 사용자 결정과 XROCKET_ALLOW_MAINNET_WRITES=true가 필요합니다. 이전 testnet 승인은 메인넷을 승인하지 않습니다.
입금 및 온보딩
감사된 Exchange API에는 입금 주소 엔드포인트가 없습니다. 확인되지 않은 주소를 발명하거나 수락하지 마세요. UI 안내에는 xrocket_onboarding_links를 사용하고, 해당 CTA에 추천 코드 kaban이 포함되어 있으며 유지관리자에게 혜택이 갈 수 있음을 공개한 후, 사용자가 입금을 완료하면 펀딩 잔액을 새로고침하세요.
추천 코드를 API, WebSocket, 문서, 저장소, 지원 또는 MCP URL에 추가하지 마세요. 프로젝트 관리형 프로덕션 및 testnet 봇 CTA는 모두 start=kaban 페이로드를 사용합니다. 다른 추천 URL 형식을 만들지 마세요.
확실한 경계
- Exchange 내부 전송을 사용자 간 결제로 취급하지 마세요. xRocket Pay는 별도 제품이며 이 도구를 통해 사용할 수 없습니다.
- 금융 소수 문자열을 이진 부동 소수점으로 변환하지 마세요.
- 오더북 델타 재구성, 재생 또는 비공개 이벤트 완전성을 주장하지 마세요. 0.1.0은 REST 스냅샷만 노출합니다.
- 지원되지 않는 제안/딜 동작을 튜토리얼에서 API 호출로 복사하지 마세요.
- 현재 Exchange 메타데이터에
TONCOIN이 필요한 경우TON을 자산 식별자로 사용하지 마세요. 네트워크TON과 자산TONCOIN은 다른 필드입니다. - 공개 인증되지 않은 MCP 엔드포인트 뒤에 비공개/쓰기 프로필을 배포하지 마세요.