나만의 트레이딩 에이전트
프롬프트, 규칙, 한도를 직접 작성하세요. 에이전트는 시세, 주문, 포지션, 실시간 계좌 상태 등 Mega1의 다른 모든 기능과 같은 API로 거래합니다.
AI 에이전트를 위해 만든 최초의 외환 브로커
AI 트레이딩 API
& MCP 서버
Mega1의 오픈 API로 트레이딩 에이전트, 대시보드, 도구를 만들거나, Claude, Cursor를 비롯한 MCP 클라이언트를 XBTFX 계좌에 연결하세요. 직접 작성한 코드나 자연어로 거래하고, 포지션을 관리하고, 시장 데이터를 실시간으로 스트리밍하세요.
- API 명세
- OpenAPI 3.1
- 프로토콜
- REST + WebSocket
- API 키
- Mega1 터미널에서 발급
- 암호화폐 거래
- 24/7
- GET/v1/whoamitrader · 2 accounts
- GET/v1/quotes?symbols=EURUSDbid 1.08421 · ask 1.08424
- POST/v1/chartEURUSD · H1 · 200 candles
- POST/v1/preview/ordermargin 108.42 · commission 0.35
- POST/v1/trade-operationskey rebalance-0142 · filled 0.10
- WS/v1/streamquotes · positions · account_state
설명을 위한 예시이며, 실제 거래 데이터가 아닙니다.
Mega1 API로 개발하는 이유
거래 과정에 AI를 참여시키려는 트레이더를 위한, 하는 일을 정확히 명시한 API입니다.
AI가 읽을 수 있는 API 명세
Mega1은 API를 OpenAPI 3.1 문서로 공개합니다. 이 문서를 Claude, Cursor 또는 다른 코딩 어시스턴트에게 건네면, 코드를 한 줄 쓰기도 전에 모든 엔드포인트, 필드, 오류를 파악합니다.
안전하게 재시도할 수 있는 주문
거래 작업마다 직접 지정한 ID가 붙습니다. 연결이 끊기면 에이전트는 같은 작업을 두 번 보내는 대신, 그 작업이 처리되었는지 확인합니다.
보내기 전에 확인
주문이 시장에 나가기 전에 필요한 마진과 수수료, 그리고 계좌가 이를 감당할 수 있는지 미리 확인하세요.
AI가 만드는 대시보드와 도구
내 API 키로 동작하는 대시보드, 리스크 모니터, 전문 인터페이스를 AI에게 만들어 달라고 하세요. 브라우저, 커맨드 라인, 데스크톱 어디서든 쓸 수 있습니다.
하나의 실시간 스트림
WebSocket 하나로 시세, 호가창, 주문, 포지션, 체결, 계좌 상태가 모두 전달되므로, 무언가 바뀌는 순간 도구가 바로 반응합니다.
API가 다루는 범위
Mega1 API 중 트레이더용 기능은 여섯 그룹으로 나뉩니다. 내 API 키는 내 계좌에서만 작동합니다.
시장 데이터
현재 시세, 과거 캔들, 내 계좌의 심볼과 각 심볼의 거래 조건.
주문
시장가 주문과 대기 주문: 제출, 수정, 개별 또는 일괄 취소가 가능하며, 제출 전에 마진과 수수료를 미리 확인할 수 있습니다.
포지션
손절과 익절을 설정하고, 전체 또는 일부를 청산하고, 포지션을 반전하거나, 두 헤지 포지션을 서로 상계 청산하세요.
계좌
실시간 잔고, 에쿼티, 마진, 내 계좌 목록, 그리고 심볼별로 적용되는 레버리지.
보고서
주문·체결·포지션 내역, 계좌 명세서, 그리고 시간에 따른 에쿼티·마진 스냅샷.
스트리밍
시세, 호가, 주문, 포지션, 체결, 계좌 상태를 하나의 JSON WebSocket으로 받습니다.
지원되는 MCP 클라이언트 연결하기
XBTFX MCP 서버를 Claude Desktop, Cursor, Windsurf 또는 다른 MCP 클라이언트에 추가하면, 어시스턴트가 자연어로 내 계좌에서 거래할 수 있습니다.
설정 가이드는 API 키, 클라이언트별 설정, 서버가 제공하는 모든 도구를 다룹니다.
설정 가이드 읽기{
"mcpServers": {
"xbtfx": {
"command": "npx",
"args": ["@xbtfx/mcp-trading"],
"env": { "XBTFX_API_KEY": "your_key_here" }
}
}
}세 단계로 시작하는 Mega1 API 개발
-
계좌 개설
XBTFX에 가입한 뒤 포털에서 Mega1 거래 계좌를 개설하세요.
계좌 개설 -
API 키 만들기
Mega1 터미널에서 에이전트가 사용할 키를 만드세요. 키는 비밀번호처럼 다루고, 코드나 채팅에 넣지 마세요.
-
AI 연결하기
코딩 어시스턴트에게 OpenAPI 명세를 주고 무엇을 만들지 설명하세요. 실제 거래를 맡기기 전에 결과물을 검토하세요.
OpenAPI 명세
자주 묻는 질문
XBTFX의 AI 트레이딩이란 무엇인가요?
AI로 나만의 거래 도구를 만들고 운용하는 것입니다. 내 규칙에 따라 주문을 내고 거래를 관리하는 에이전트, 대시보드, 리스크 모니터 등이 여기에 해당합니다. XBTFX에서는 Mega1 터미널에서 만든 API 키로 Mega1의 오픈 API를 통해 작동합니다.
프로그래밍 경험이 필요한가요?
꼭 그렇지는 않습니다. Claude Desktop 같은 MCP 클라이언트를 쓰면 자연어로 거래할 수 있습니다. Mega1 API로 나만의 에이전트를 만들 때는 AI 코딩 어시스턴트가 많은 작업을 대신할 수 있습니다. OpenAPI 명세를 주고 원하는 것을 설명한 뒤, 만든 결과물에 의존하기 전에 꼭 검토하세요.
XBTFX의 AI 트레이딩은 무료인가요?
네. Mega1 API는 계좌에서 무료로 이용할 수 있습니다. 스프레드와 수수료 같은 일반적인 거래 비용만 부담하면 됩니다.
API 키는 어디서 받나요?
Mega1 터미널에서 받을 수 있습니다. 키는 비밀번호처럼 환경 변수나 시크릿 매니저에 보관하고, 코드나 채팅에는 절대 넣지 마세요.
어떤 AI 어시스턴트가 XBTFX와 함께 작동하나요?
Claude Desktop, Cursor, Windsurf 같은 MCP 클라이언트는 XBTFX MCP 서버를 통해 연결됩니다. Mega1 API로 개발할 때는 OpenAPI 문서를 읽고 HTTPS 및 WebSocket 요청을 보낼 수 있는 어시스턴트나 프레임워크라면 무엇이든 쓸 수 있습니다. Claude, ChatGPT, Cursor는 물론 Python, TypeScript 등 어떤 언어로 직접 작성한 코드도 가능합니다.
에이전트는 무엇을 거래할 수 있나요?
Mega1 계좌에서 거래할 수 있는 상품, 즉 외환, 암호화폐, 금속, 지수, 주식, 에너지입니다.
AI에게 내 계좌로 거래를 맡겨도 안전한가요?
내 API 키는 내 계좌에서만 작동하며, 모든 동작은 기록하고 검토할 수 있는 API 호출입니다. 작은 포지션 규모로 시작하고, 주문 미리보기를 활용하고, 한도를 에이전트의 규칙에 반영하세요.
에이전트가 주문을 안전하게 재시도할 수 있나요?
네. 거래 작업마다 직접 지정한 ID가 붙으므로, 요청 시간이 초과되더라도 에이전트는 주문을 다시 넣는 대신 해당 작업이 처리되었는지 조회할 수 있습니다.
에이전트를 만드세요.
XBTFX에서 거래하세요.
XBTFX 계좌를 개설하고, Mega1 터미널에서 API 키를 만든 다음 AI를 연결하세요.