위험 경고: CFD 상품 거래는 높은 수준의 위험을 동반하며 모든 투자자에게 적합하지 않을 수 있습니다.

XBTFX Trading API

XBTFX MetaTrader 5® 계좌 호환

REST와 WebSocket으로 호환되는 XBTFX MetaTrader 5® 계좌에서 프로그래밍 방식으로 거래하고, 포지션을 관리하고, 계좌 상태를 모니터링하며 실시간 시장 데이터를 스트리밍하세요. 자동화 전략을 구축하고, AI 에이전트를 연결하고, 계좌를 맞춤 워크플로에 통합하세요. 문서, 동작 가능한 예제, AI skills, XBTFX MCP 서버 중 어디서든 시작할 수 있습니다. 프로그래밍 또는 AI 코딩 어시스턴트 사용 경험이 있는 개발자와 사용자를 위해 설계되었습니다.

Edge & ECN 계좌
완전한 프로그래머블 액세스
Hedging & Netting 모드
AI 에이전트 지원 (MCP)
계좌 만들기 API Console 문서
terminal
# Send a trade to your XBTFX account curl -X POST https://interface.xbtfx.com/v1/trade \ -H "Authorization: Bearer xbtfx_live_..." \ -H "Content-Type: application/json" \ -d '{ "symbol": "EURUSD", "side": "buy", "volume": 0.10, "sl": 1.08200, "tp": 1.09000 }' # Response { "ticket": 184729, "status": "filled", "price": 1.08650, "retcode": 10009 }
프로토콜 icon
REST
프로토콜
스트리밍 icon
WebSocket
스트리밍
Weight / 분 icon
600
Weight / 분
응답 포맷 icon
JSON
응답 포맷

XBTFX API로 트레이딩 자동화

XBTFX Trading API로 호환 XBTFX MetaTrader 5® 계좌에 명령을 보낼 수 있습니다. 표준 REST와 WebSocket 호출로 포지션을 열고 손절을 수정하고 잔고를 조회하며 실시간 호가를 스트리밍하세요.

자동화 전략
거래 봇과 알고리즘 전략을 만들어 자동으로 계좌에 주문을 보내세요. 시그널 기반 실행, 포트폴리오 리밸런싱, 맞춤 리스크 관리 로직 등을 운영할 수 있습니다.
AI 에이전트 통합
XBTFX Skills Hub 또는 MCP 서버로 AI 어시스턴트를 계좌에 연결하세요. Claude Code, Cursor, Windsurf 등 호환 클라이언트로 자연어 거래 명령을 내릴 수 있습니다.
맞춤 통합
대시보드를 만들고, 외부 데이터 소스에 연결하고, 다른 플랫폼의 시그널을 라우팅하거나, 계좌 데이터를 자체 리포팅·분석 시스템에 통합하세요.

거래·포지션·시장 데이터용 API 엔드포인트

WebSocket으로 포지션 개·폐, 손절·익절 설정, 잔고 조회, 거래 내역 조회, 외환·암호화폐 호가 실시간 스트리밍을 지원합니다.

POST 주문 전송
손절·익절을 포함한 시장가 주문을 계좌로 전송하세요. Hedging 및 Netting 마진 모드를 모두 지원합니다.
/v1/trade
POST 청산 및 수정
포지션을 전체 또는 부분 청산하세요. 미결 포지션의 SL/TP를 업데이트하세요. 전체 청산, 심볼별 청산, 반대 포지션 네팅이 가능합니다.
/v1/close · /v1/modify · /v1/close-all
GET 포지션 및 주문
모든 미결 포지션과 대기 주문을 실시간으로 조회하세요. 심볼로 필터링 가능. 캐시에서 응답되며 실시간 푸시 업데이트가 함께 제공됩니다.
/v1/positions · /v1/orders
GET 계좌 및 잔고
실시간 잔고, 자기자본, 마진, 가용 마진, 부동손익, 레버리지. 한 번의 호출로 완전한 스냅샷을 받습니다.
/v1/account
GET 심볼 및 사양
실시간 bid/ask, 스프레드, 계약 크기, 최소/최대/스텝 수량, 소수점 자릿수, 마진 요구치를 포함한 전체 심볼 목록.
/v1/symbols · /v1/symbols/:symbol
WS WebSocket 스트리밍
5단계 호가창을 포함한 실시간 호가 스트리밍. 계좌에서 사용 가능한 어떤 심볼이든 구독할 수 있습니다.
wss://ws.xbtfx.com/v1/ws

몇 분이면 첫 API 거래를 보냅니다

원하는 언어로 몇 줄만 쓰면 됩니다. 표준 HTTP — POST 요청을 보낼 수 있는 언어라면 무엇이든 동작합니다.

XBTFX Trading API · examples
# Send a buy order to your XBTFX account curl -X POST https://interface.xbtfx.com/v1/trade \ -H "Authorization: Bearer $XBTFX_API_KEY" \ -H "Content-Type: application/json" \ -d '{"symbol":"EURUSD","side":"buy","volume":0.10,"sl":1.082,"tp":1.09}' # Retrieve open positions curl https://interface.xbtfx.com/v1/positions \ -H "Authorization: Bearer $XBTFX_API_KEY"
import requests API_KEY = "xbtfx_live_your_key_here" BASE = "https://interface.xbtfx.com" HEADERS = {"Authorization": f"Bearer {API_KEY}"} # Send a trade to your account r = requests.post(f"{BASE}/v1/trade", json={ "symbol": "EURUSD", "side": "buy", "volume": 0.10 }, headers=HEADERS) print(r.json()) # {"status": "filled", "retcode": 10009}
const ws = new WebSocket("wss://ws.xbtfx.com/v1/ws"); ws.onopen = () => { ws.send(JSON.stringify({ type: "auth", api_key: "xbtfx_live_..." })); ws.send(JSON.stringify({ type: "subscribe", symbols: ["EURUSD", "BTCUSD"] })); }; ws.onmessage = (e) => { const q = JSON.parse(e.data); console.log(q.symbol, q.bid, q.ask); };
main 0 errors Shell UTF-8 LF interface.xbtfx.com
AI-Ready

자연어로 거래 실행

XBTFX Trading API는 AI 에이전트와 대규모 언어 모델이 소비할 수 있도록 설계되었습니다 — 깔끔한 JSON, 사람이 읽을 수 있는 오류, 예측 가능한 엔드포인트. XBTFX Skills Hub 또는 MCP 서버로 연결하면 AI 클라이언트가 대화형 명령으로 거래를 보낼 수 있습니다.

  • 대화형 주문 — 매수, 매도, 청산, 데이터 기반 조건부 실행.
  • 도구 기반 추론 — 모든 액션이 구조화된 응답을 반환합니다.
  • 클라이언트 간 이식성 — Claude, Cursor, Windsurf, Codex.
API 문서 MCP Server

덜 기술적인 설명을 원하시나요? AI Agent Trading 페이지를 보세요.

대화 예시 →
XBTFX Trading Agent
online · executing trades
Today · 13:25 GMT
If today's NFP prints above 200k, close all my open EURUSD and GBPUSD trades.
13:25 ✓✓
Got it. Watching the BLS release at 13:30 GMT. I'll close 4 positions if NFP > 200k.
13:25
tool · xbtfx_get_positions4 open · EURUSD ×2, GBPUSD ×2 · floating +$184.20
13:26
13:30 · NFP released — 247k (forecast 195k)
tool · xbtfx_close_all (filter: EURUSD, GBPUSD)Closed 4 positions in 38 ms · realized +$212.80
13:30

예시용입니다. 조건부 흐름은 설정된 에이전트와 시장 데이터 피드에 따라 다릅니다.

사용 사례

AI 에이전트는 API로 무엇을 하는가

XBTFX 계좌의 자동화·AI 주도 워크플로에서 자주 보는 네 가지 패턴입니다.

이벤트 기반 트레이딩

AI가 뉴스와 경제 데이터를 실시간으로 모니터링하며 시장을 움직이는 이벤트가 감지되면 계좌로 주문을 보냅니다.

스마트 리스크 관리

AI가 마진, 부동손익, 노출을 추적하면서 자본을 보호하기 위해 손절을 조정하고 사이즈를 줄이거나 포지션을 청산합니다.

포트폴리오 리밸런싱

목표 비중을 정해 두면 편차가 임계값을 넘었을 때 AI가 조정 주문을 보내며 유지합니다.

자율 분석

AI에게 거래 이력을 분석하고 심볼별 승률을 계산하며 가장 성과가 좋았던 셋업을 식별하라고 요청하세요.

기존 XBTFX 계좌를 위해 만들어졌습니다

지금 사용 중인 MetaTrader 5 Edge 또는 ECN 계좌, 기준 통화, 마진 모드를 그대로 사용하세요. API는 이미 거래 중인 동일한 계좌에 연결됩니다.

기술 사양

프로덕션 등급 엔드포인트

Hedging & Netting 모드

MT5의 두 가지 마진 모드를 모두 지원합니다. 모드는 API 키에 바인딩됩니다.

Idempotency 키

120초 이내 같은 키를 다시 보내면 캐시된 응답을 반환합니다. 안전한 재시도 — 중복 체결 없음.

Weight 기반 레이트 리밋

키당 분당 600 weight. 조회와 거래는 1, 일괄 작업은 10. 모든 응답 헤더에 남은 예산이 표시됩니다.

FIX 4.4 기관용

프라임 브로커, 헤지펀드, HFT 회사를 위한 FIX 4.4 액세스를 xPro 인프라를 통해 제공합니다. 영업팀 문의.
계좌 호환성

Edge 또는 ECN — 같은 계좌

Edge & ECN 계좌

더 좁은 스프레드와 랏당 수수료. API는 모든 Edge / ECN 계좌를 동일하게 처리합니다 — 같은 엔드포인트, 같은 JSON, 같은 인증 흐름.

PAMM, MAM, Copy Master 계좌

매니저 계좌도 API로 프로그래밍 방식으로 운용해 분배·리밸런싱·실행이 가능합니다. 자격 증명 발급은 온보딩 팀에 문의하세요.

다중 통화 결제

Edge & ECN에서 XBTFX MT5가 지원하는 모든 기준 통화: USD, EUR, USDT, BTC, ETH, XRP, SOL, LTC, ZEC, XAU. 잔고·자기자본·마진·손익은 계좌의 원시 통화로 반환되어 변환 로직이 필요 없습니다.

Hedging 또는 Netting

MT5 계좌에 설정한 마진 모드 그대로 API가 사용합니다. 재설정 불필요.

개발자 리소스

예제 코드, AI skill 파일, 전체 API 문서 — 시작에 필요한 모든 것.

API 문서

요청/응답 예제, 인증 가이드, WebSocket 통합을 포함한 전체 엔드포인트 레퍼런스.
docs.xbtfx.com

API 예제

Python, JavaScript, curl 등의 샘플 코드. 복사해서 바로 실행하세요.
GitHub

AI Skills Hub

호환 에이전트 프레임워크용 거래·계좌·시장데이터·WebSocket 워크플로 skill 파일.
문서 GitHub

MCP Server

Claude Code, Claude Desktop, OpenAI Codex, Cursor, Windsurf 등 MCP 호환 클라이언트용.
문서 GitHub

3단계로 시작하기

같은 셸, 두 가지 시작 지점 — 계좌 상태에 맞는 쪽을 고르세요.

1
API 키 발급
XBTFX 자격 증명으로 console.xbtfx.com에 로그인하고 거래 계좌를 선택해 키를 발급하세요.
Console 열기
2
Skill 또는 MCP 설치
Skills Hub에서 skill을 설치하거나 MCP 서버를 Claude Code, Cursor, Windsurf 등 호환 클라이언트에 연결하세요. 키는 로컬에 머무릅니다.
MCP 문서
3
거래 시작
GET /v1/auth/status로 점검한 뒤 자연어로 명령하거나 REST/WebSocket 엔드포인트를 직접 호출하세요.
문서 읽기

Frequently
Asked Questions

  • XBTFX Trading API란?

    XBTFX Trading API는 호환 XBTFX MetaTrader 5® 계좌에서 프로그램에 의한 거래, 계좌 모니터링, 시장 데이터 조회·스트리밍을 위한 REST 및 WebSocket 액세스를 제공합니다. XBTFX가 직접 만든 것으로, 깔끔한 HTTP 엔드포인트와 JSON 응답을 통해 거래를 보내고 계좌 데이터를 받습니다.

  • 어떤 프로그래밍 언어를 쓸 수 있나요?

    HTTP 요청을 보낼 수 있는 어떤 언어든 가능합니다. Python, JavaScript, Go, Rust, C#, Java, Ruby, PHP — JSON 본문으로 POST 요청을 보낼 수 있다면 API로 XBTFX 계좌에 거래를 보낼 수 있습니다.

  • 자동화 거래 전략을 만들 수 있나요?

    네. XBTFX Trading API는 알고리즘·자동화 트레이딩을 위해 설계되었습니다. 시그널 기반 봇, 포트폴리오 리밸런서, 리스크 관리 시스템, 또는 계좌에 거래를 보내는 어떤 맞춤 로직이든 만들 수 있습니다.

  • 실시간 가격을 위한 WebSocket 피드가 있나요?

    네. XBTFX Trading API는 계좌에서 사용 가능한 심볼의 실시간 호가를 위한 WebSocket 엔드포인트를 제공합니다. 가능한 경우 5단계 호가창을 포함합니다. 연결당 최대 1,000개 심볼 구독, 동시 연결 최대 10개.

  • Hedging과 Netting 모드의 차이는?

    포지션 동작을 결정하는 마진 모드입니다. Hedging은 같은 심볼에서 반대 방향(매수·매도)을 포함해 여러 독립 포지션을 허용합니다. Netting은 모든 것을 심볼당 단일 포지션으로 합칩니다. API 키는 계좌의 모드를 상속합니다.

  • 레이트 리밋은 어떻게 되나요?

    API 키당 분당 600 weight입니다. 대부분의 요청은 1 weight — 분당 최대 600회. close-all 같은 일괄 작업은 10 weight입니다. 모든 응답 헤더에 남은 예산이 표시됩니다.

  • API로 암호화폐 CFD를 거래할 수 있나요?

    네. XBTFX 계좌의 모든 심볼은 API로 접근 가능하며 암호화폐 CFD도 포함됩니다. BTC, ETH, USDT, XRP 표시 계좌에도 API를 사용할 수 있습니다.

  • API는 무료인가요?

    네. XBTFX Trading API는 모든 거래 계좌에 추가 비용 없이 포함됩니다. API 요금, 구독료, 호출당 요금이 없으며 일반적인 거래 수수료와 스프레드만 부담합니다.

  • API 키는 어떻게 받나요?

    먼저 my.xbtfx.com에서 XBTFX 거래 계좌를 만드세요. 그런 다음 console.xbtfx.com의 API Console에 XBTFX 자격 증명으로 로그인하고 거래 계좌를 선택해 키를 발급하세요. 거래 전에 GET /v1/auth/status를 보내 키가 동작하는지 확인하세요.

  • API를 데모 계좌에서 쓸 수 있나요?

    네. API 키는 실 계좌와 데모 계좌 모두에서 동작합니다. 실 계좌로 가기 전에 동일한 API와 엔드포인트로 통합과 코드를 검증할 수 있습니다.

  • 거래 전에 무엇을 해야 하나요?

    먼저 GET /v1/auth/status로 API 키와 계좌 상태를 확인하세요. 키 유효성, 권한, 마진 모드를 확인하고 계좌가 거래 요청을 받을 준비가 됐는지 확인합니다.

  • 프로그래밍 경험이 필요한가요?

    REST API를 직접 사용하려면 기본 프로그래밍 지식이 필요합니다. 다만 AI 통합 경로를 쓰면 코드를 작성할 필요가 없습니다 — XBTFX MCP 서버를 Claude Code나 Cursor에 연결하거나 Skills Hub의 skill 파일을 설치한 뒤 자연어로 명령하세요. AI 코딩 어시스턴트에 익숙하면 좋습니다.

  • AI로 제 계좌를 거래해도 되나요?

    네. skill 파일을 지원하는 에이전트 프레임워크에는 XBTFX Skills Hub를 쓰거나, Claude Code, Claude Desktop, OpenAI Codex, Cursor, Windsurf 같은 MCP 호환 클라이언트에 XBTFX MCP 서버를 연결하세요. 두 경로 모두 XBTFX Trading API를 통해 자연어로 거래 명령을 내릴 수 있습니다.

  • AI 에이전트에 계좌 접근을 주는 게 안전한가요?

    API 키는 보통 사용자 머신의 에이전트가 로컬에 저장하며 제3자 서버로 업로드되지 않습니다. 에이전트는 사용자의 키로 직접 XBTFX 서버에 API 호출을 보냅니다. Console에서 언제든 키를 즉시 철회할 수 있습니다. 실 계좌로 가기 전에 데모 계좌로 설정을 점검하시기를 권장합니다.

오늘 바로 빌드를 시작하세요 —

Chat

24/7 Chat Support

Need help with the API? Our team is available around the clock.

Chat Now →
FAQ

API Documentation

Full endpoint reference, authentication guide, and examples.

View Docs →
Blog

GitHub Repos

API examples, AI skills, and sample code ready to use.

View on GitHub →

본 페이지는 다음을 포함한 XBTFX 회사들이 소유하고 운영합니다:

XBTFX LLC는 앤티가 바부다에 등록번호 ILLC001로 설립되었으며, 등록 주소는 Hodges Bay, P.O. Box 1348, St. John's, Antigua입니다.

XBTFX (SC) Ltd.는 세이셸에 등록번호 8434947-1로 설립되었으며, 사업장 주소는 Office 1, Block 2, 1st Floor, Sai-fu Building, Zone 20, Providence, Mahe, Seychelles이고, 라이선스 번호는 SD169입니다.
결제 처리는 CLEARAY LTD가 수행하며, 이는 키프로스 공화국 회사법 제113장에 따라 정식으로 설립된 유한책임회사로, 회사 등록번호는 HE 462275이며 등록 사무소는 Archiepiskopou Makariou ΙΙΙ, 160, 1st Floor, 3026, Limassol, Cyprus입니다. XBTFX는 다양한 자산에 대한 차액결제계약(CFDs) 제공업체로서 레버리지 기반의 서비스를 제공합니다. 귀하의 투자 가치는 시장 변동성의 영향을 받으며 상승하거나 하락할 수 있음을 유의하시기 바랍니다. 따라서 투자 자본은 위험에 노출됩니다. 특히 규제되지 않고 변동성이 큰 암호화폐 자산은 소비자 보호를 받지 못합니다. 또한, 투자 수익에 대해 세금이 부과될 수 있습니다. XBTFX는 미국, 퀘벡(캐나다), 벨기에, 벨라루스, 러시아, 이란, 북한, 수단, 예멘 또는 XBTFX의 서비스 제공이 현지 법률 또는 규정에 위배되는 기타 지역을 포함하되 이에 국한되지 않는 특정 관할권에 거주하는 개인에게 서비스를 제공하지 않습니다. 이 목록은 완전한 것이 아니며 필요에 따라 업데이트됩니다. XBTFX는 EU/EEA 고객을 적극적으로 타겟으로 하지 않습니다. 잠재 고객은 XBTFX의 서비스를 이용하기 전에 자국에서 적용되는 외환 규정을 충분히 이해할 것을 강력히 권장합니다. 고위험 투자 안내: 차액결제계약(CFDs)은 레버리지 특성으로 인해 상당한 위험을 수반하는 정교한 금융 상품입니다. 이러한 상품을 이용할 경우 빠른 금전적 손실이 발생할 가능성이 있습니다. CFDs의 작동 방식에 대한 이해도를 신중히 평가하고 본인의 상황에 CFD 거래가 적합한지 판단하는 것이 필수적입니다. 잃어도 감당할 수 있는 자금만 투자할 것을 강력히 권고합니다. 레버리지 상품은 모든 사람에게 적합하지 않을 수 있으며 자본의 완전한 손실을 초래할 수 있습니다. 당사의 ‘위험 공시 안내’. 다른 트레이더의 거래를 따라하거나 복제하여 XBTFX에서 거래하는 것은 최고 성과를 내는 트레이더를 따라하거나 복제하는 경우에도 높은 수준의 위험을 수반합니다. 이러한 위험에는 경험이 부족하거나 비전문 트레이더, 또는 궁극적인 목적, 의도, 재정 상태가 귀하와 다를 수 있는 트레이더의 거래 결정을 따르거나 복제할 위험이 포함됩니다. 과거 실적은 미래 실적의 지표가 아닙니다. XBTFX 소셜 트레이딩 플랫폼의 콘텐츠는 커뮤니티 회원들이 생성하며 XBTFX 또는 XBTFX를 대신한 조언이나 권장사항을 포함하지 않습니다. 사기 방지 안내: XBTFX는 고객에게 오직 중개 서비스만 제공합니다. 또한, XBTFX는 URL xbtfx.com을 통해서만 운영되며, 고객은 해당 URL을 통해서만 당사 서비스에 접근하고 있는지 확인해야 합니다. XBTFX는 절대로 비밀번호를 요청하지 않으며 SMS/전화로 비밀번호를 요청하기 위해 연락하지 않습니다. 본 페이지의 내용은 정보 제공 및 마케팅 목적으로만 제공됩니다. 이는 금융, 투자 또는 기타 전문적인 조언이나 권장사항을 구성하거나 그렇게 해석되어서는 안 됩니다. 또한, 이는 어떠한 금융 상품이나 거래의 매수, 매도 또는 참여에 대한 제안 또는 권유를 나타내지 않습니다. 고객은 거래하기 전에 적절한 위험 감수도, 관련 경험 및 지식을 보유하고 있는지 확인하기 위해 인가받은 금융 자문가의 의견을 구해야 합니다. 이 페이지는 귀하의 편의를 위해 번역되었습니다. 모든 약관, 계약, 법률 문서 및 거래 조건의 영문 버전이 불일치 발생 시 우선합니다.
2026 XBTFX LLC. All Rights Reserved.