Cảnh báo Rủi ro: Giao dịch các sản phẩm CFD có mức độ rủi ro cao và có thể không phù hợp với mọi nhà đầu tư.

XBTFX Trading API

Tương thích với tài khoản XBTFX MetaTrader 5®

Giao dịch theo phương thức lập trình, quản lý vị thế, theo dõi trạng thái tài khoản và stream dữ liệu thị trường thời gian thực trên các tài khoản XBTFX MetaTrader 5® tương thích qua REST và WebSocket. Xây các chiến lược tự động, kết nối tác nhân AI và tích hợp tài khoản vào quy trình tùy biến. Bắt đầu từ tài liệu, các ví dụ chạy được, AI skills hoặc máy chủ XBTFX MCP. Thiết kế cho lập trình viên và người dùng có kinh nghiệm với lập trình hoặc trợ lý AI viết code.

Tài khoản Edge & ECN
Truy cập lập trình đầy đủ
Chế độ Hedging & Netting
Sẵn sàng cho tác nhân AI (MCP)
Tạo tài khoản API Console Tài liệu
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 }
Giao thức icon
REST
Giao thức
Streaming icon
WebSocket
Streaming
Weight / phút icon
600
Weight / phút
Định dạng phản hồi icon
JSON
Định dạng phản hồi

Tự động hóa giao dịch với XBTFX API

XBTFX Trading API cho phép bạn gửi lệnh đến tài khoản XBTFX MetaTrader 5® tương thích. Mở vị thế, sửa stop, truy vấn số dư và stream giá trực tiếp qua các lệnh REST và WebSocket chuẩn.

Chiến lược tự động
Xây các bot giao dịch và chiến lược thuật toán tự động gửi lệnh đến tài khoản. Vận hành thực thi theo tín hiệu, tái cân bằng danh mục hoặc logic quản trị rủi ro tùy biến.
Tích hợp tác nhân AI
Kết nối các trợ lý AI vào tài khoản qua XBTFX Skills Hub hoặc máy chủ MCP. Đưa lệnh giao dịch bằng ngôn ngữ tự nhiên qua Claude Code, Cursor, Windsurf hoặc các client tương thích khác.
Tích hợp tùy biến
Xây bảng điều khiển, kết nối nguồn dữ liệu bên ngoài, chuyển tín hiệu giao dịch từ nền tảng khác hoặc tích hợp dữ liệu tài khoản vào hệ thống báo cáo và phân tích của bạn.

Endpoint API cho giao dịch, vị thế & dữ liệu thị trường

Mở/đóng vị thế, đặt stop loss và take profit, truy vấn số dư, lấy lịch sử giao dịch và stream giá forex/crypto trực tiếp qua WebSocket.

POST Gửi lệnh
Gửi lệnh thị trường tới tài khoản kèm stop loss và take profit. Hỗ trợ cả chế độ margin Hedging và Netting.
/v1/trade
POST Đóng & sửa lệnh
Đóng vị thế toàn phần hoặc một phần. Cập nhật SL/TP trên các vị thế đang mở. Đóng tất cả, đóng theo mã hoặc nét các vị thế đối nghịch.
/v1/close · /v1/modify · /v1/close-all
GET Vị thế & lệnh
Lấy mọi vị thế đang mở và lệnh chờ theo thời gian thực. Lọc theo mã. Phản hồi từ cache kèm cập nhật push trực tiếp.
/v1/positions · /v1/orders
GET Tài khoản & số dư
Số dư, equity, margin, free margin, PnL nổi và đòn bẩy theo thời gian thực. Một lệnh gọi cho ảnh chụp đầy đủ.
/v1/account
GET Mã & thông số
Danh sách mã đầy đủ với bid/ask trực tiếp, spread, kích cỡ hợp đồng, khối lượng tối thiểu/tối đa/bước, số lẻ và yêu cầu margin.
/v1/symbols · /v1/symbols/:symbol
WS Streaming WebSocket
Báo giá streaming thời gian thực với 5 mức độ sâu thị trường. Đăng ký bất kỳ mã nào có sẵn trên tài khoản của bạn.
wss://ws.xbtfx.com/v1/ws

Gửi lệnh API đầu tiên trong vài phút

Vài dòng mã trong ngôn ngữ bạn chọn. HTTP chuẩn — bất kỳ ngôn ngữ nào có thể gửi POST đều hoạt động.

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

Thực thi lệnh bằng ngôn ngữ tự nhiên

XBTFX Trading API được thiết kế để các tác nhân AI và mô hình ngôn ngữ lớn dùng — JSON sạch, lỗi dễ đọc, endpoint dự đoán được. Kết nối qua XBTFX Skills Hub hoặc máy chủ MCP và client AI của bạn có thể gửi lệnh qua các câu lệnh hội thoại.

  • Lệnh hội thoại — mua, bán, đóng, đặt điều kiện theo dữ liệu.
  • Suy luận dựa trên công cụ — mọi hành động trả về phản hồi có cấu trúc.
  • Di động giữa các client — Claude, Cursor, Windsurf, Codex.
Tài liệu API MCP Server

Cần phiên bản ít kỹ thuật hơn? Xem trang AI Agent Trading.

Cuộc hội thoại ví dụ →
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

Ví dụ minh họa. Các luồng có điều kiện phụ thuộc vào tác nhân và nguồn dữ liệu thị trường được cấu hình.

Trường hợp sử dụng

Tác nhân AI làm gì với API

Bốn mẫu thường thấy trong các quy trình tự động và do AI dẫn dắt trên tài khoản XBTFX.

Giao dịch theo sự kiện

AI giám sát tin tức và dữ liệu kinh tế thời gian thực, gửi lệnh đến tài khoản khi phát hiện sự kiện ảnh hưởng thị trường.

Quản trị rủi ro thông minh

AI theo dõi margin, PnL nổi và độ phơi nhiễm — điều chỉnh stop, giảm khối lượng hoặc đóng lệnh để bảo vệ vốn.

Tái cân bằng danh mục

Định mức phân bổ mục tiêu rồi để AI duy trì, gửi lệnh điều chỉnh khi độ lệch vượt ngưỡng của bạn.

Phân tích tự chủ

Yêu cầu AI phân tích lịch sử giao dịch, tính tỉ lệ thắng theo mã và nhận diện setup hiệu quả nhất.

Xây cho tài khoản XBTFX bạn đã có

Dùng tài khoản MetaTrader 5 Edge hoặc ECN hiện tại, loại tiền cơ sở hiện tại và chế độ margin hiện tại. API kết nối tới chính tài khoản bạn đang giao dịch.

Thông số kỹ thuật

Endpoint sẵn sàng cho production

Chế độ Hedging & Netting

Cả hai chế độ margin của MT5 đều được hỗ trợ. Chế độ gắn theo API key của bạn.

Khóa idempotency

Gửi cùng một key trong vòng 120 giây và chúng tôi trả về phản hồi đã cache. Retry an toàn, không có lệnh khớp trùng.

Rate limit theo trọng số

600 weight/phút mỗi key. Đọc và lệnh tốn 1, thao tác hàng loạt 10. Header trên mọi phản hồi cho biết ngân sách còn lại.

FIX 4.4 cho tổ chức

Truy cập FIX 4.4 qua hạ tầng xPro dành cho prime broker, hedge fund và công ty HFT. Liên hệ sales.
Tương thích tài khoản

Edge hoặc ECN — cùng một tài khoản

Tài khoản Edge & ECN

Spread chặt hơn kèm hoa hồng theo lot. API đối xử với mọi tài khoản Edge / ECN giống nhau — cùng endpoint, cùng JSON, cùng luồng xác thực.

Tài khoản PAMM, MAM & Copy Master

Tài khoản quản lý có thể được vận hành lập trình qua API cho phân bổ, tái cân bằng và thực thi. Liên hệ onboarding để cấp quyền.

Thanh toán đa loại tiền

Mọi loại tiền cơ sở XBTFX MT5 hỗ trợ cho Edge & ECN: USD, EUR, USDT, BTC, ETH, XRP, SOL, LTC, ZEC, XAU. Số dư, equity, margin và PnL trả về theo loại tiền gốc của tài khoản — không cần logic chuyển đổi ở phía bạn.

Hedging hoặc Netting

Bạn đặt chế độ margin nào trên tài khoản MT5 thì API dùng đúng chế độ đó. Không cần cấu hình lại.

Tài nguyên cho lập trình viên

Mã ví dụ, file AI skill và tài liệu API đầy đủ — mọi thứ bạn cần để bắt tay vào xây dựng.

Tài liệu API

Tham chiếu endpoint đầy đủ kèm ví dụ request/response, hướng dẫn xác thực và tích hợp WebSocket.
docs.xbtfx.com

Ví dụ API

Mã mẫu trong Python, JavaScript, curl và nhiều ngôn ngữ khác. Sao chép và chạy.
GitHub

AI Skills Hub

Các file skill cho luồng giao dịch, tài khoản, dữ liệu thị trường và WebSocket trên các framework tác nhân tương thích.
Tài liệu GitHub

MCP Server

Dành cho Claude Code, Claude Desktop, OpenAI Codex, Cursor, Windsurf và các client tương thích MCP khác.
Tài liệu GitHub

Bắt đầu trong ba bước

Cùng một khung, hai điểm xuất phát — chọn cái khớp với trạng thái tài khoản của bạn.

1
Tạo API key
Đăng nhập console.xbtfx.com bằng thông tin XBTFX, chọn tài khoản giao dịch và tạo key.
Mở Console
2
Cài Skill hoặc MCP
Cài skill từ Skills Hub, hoặc kết nối máy chủ MCP với Claude Code, Cursor, Windsurf hoặc client tương thích khác. Key được giữ ở máy bạn.
Tài liệu MCP
3
Bắt đầu giao dịch
Xác thực bằng GET /v1/auth/status, sau đó đưa lệnh bằng ngôn ngữ tự nhiên hoặc gọi trực tiếp các endpoint REST/WebSocket.
Đọc tài liệu

Frequently
Asked Questions

  • XBTFX Trading API là gì?

    XBTFX Trading API cung cấp truy cập REST và WebSocket cho giao dịch lập trình, theo dõi tài khoản, lấy dữ liệu thị trường và streaming trên các tài khoản XBTFX MetaTrader 5® tương thích. Do XBTFX xây dựng — bạn tương tác qua các endpoint HTTP gọn gàng và phản hồi JSON để gửi lệnh và lấy dữ liệu tài khoản.

  • Tôi có thể dùng ngôn ngữ lập trình nào?

    Bất kỳ ngôn ngữ nào có thể gửi yêu cầu HTTP. Python, JavaScript, Go, Rust, C#, Java, Ruby, PHP — nếu nó có thể gửi POST với JSON body, nó có thể gửi lệnh tới tài khoản XBTFX qua API.

  • Tôi có thể xây các chiến lược giao dịch tự động không?

    Có. XBTFX Trading API được thiết kế cho giao dịch thuật toán và tự động. Bạn có thể xây bot theo tín hiệu, công cụ tái cân bằng, hệ thống quản trị rủi ro hoặc bất kỳ logic tùy biến nào để gửi lệnh tới tài khoản.

  • Có feed WebSocket giá thời gian thực không?

    Có. XBTFX Trading API cung cấp endpoint WebSocket để stream giá thời gian thực cho các mã có sẵn trên tài khoản. Báo giá kèm 5 mức độ sâu thị trường khi có. Mỗi kết nối tối đa 1.000 mã đăng ký và tối đa 10 kết nối song song.

  • Khác biệt giữa chế độ Hedging và Netting là gì?

    Đây là các chế độ margin xác định cách hành xử của vị thế. Hedging cho phép nhiều vị thế độc lập trên cùng một mã, kể cả mua/bán đối nghịch. Netting gộp tất cả thành một vị thế duy nhất cho mỗi mã. API key kế thừa chế độ từ tài khoản.

  • Rate limit là bao nhiêu?

    600 weight mỗi phút trên một API key. Hầu hết yêu cầu tốn 1 weight — tối đa 600 cuộc gọi mỗi phút. Thao tác hàng loạt như close-all tốn 10 weight. Mỗi phản hồi có header thể hiện ngân sách còn lại.

  • Tôi có thể giao dịch CFD crypto qua API không?

    Có. Mọi mã có sẵn trong tài khoản XBTFX đều truy cập được qua API — bao gồm CFD tiền mã hóa. Bạn cũng có thể dùng API với các tài khoản định danh BTC, ETH, USDT hoặc XRP.

  • API có miễn phí không?

    Có. XBTFX Trading API đi kèm mỗi tài khoản giao dịch không tốn thêm phí. Không phí API, không thuê bao, không phí theo lệnh gọi ngoài hoa hồng và spread giao dịch thông thường.

  • Lấy API key thế nào?

    Trước tiên tạo tài khoản giao dịch XBTFX tại my.xbtfx.com nếu bạn chưa có. Sau đó đăng nhập API Console tại console.xbtfx.com bằng thông tin XBTFX, chọn tài khoản giao dịch và tạo key. Xác thực key bằng cách gửi GET /v1/auth/status trước khi đặt lệnh.

  • Có thể dùng API với tài khoản demo không?

    Có. API key dùng được cho cả tài khoản thật và demo. Bạn có thể kiểm thử tích hợp và xác nhận mã trước khi vận hành thật — trên cùng một API và endpoint.

  • Trước khi đặt lệnh tôi nên làm gì?

    Hãy xác minh trạng thái API key và tài khoản trước bằng GET /v1/auth/status. Lệnh này xác nhận key hợp lệ, hiển thị quyền và chế độ margin, đảm bảo tài khoản sẵn sàng trước khi gửi yêu cầu giao dịch.

  • Tôi có cần kinh nghiệm lập trình không?

    Dùng REST API trực tiếp cần kiến thức lập trình cơ bản. Tuy nhiên với các đường tích hợp AI, bạn không phải tự viết mã — kết nối máy chủ XBTFX MCP với Claude Code hoặc Cursor, hoặc cài file skill từ Skills Hub, rồi đưa lệnh giao dịch bằng ngôn ngữ tự nhiên. Quen thuộc với trợ lý AI viết code sẽ có lợi.

  • Tôi có thể dùng AI để giao dịch tài khoản của mình không?

    Có. Dùng XBTFX Skills Hub cho các framework tác nhân hỗ trợ file skill, hoặc kết nối máy chủ XBTFX MCP với các client tương thích MCP như Claude Code, Claude Desktop, OpenAI Codex, Cursor hoặc Windsurf. Cả hai con đường đều cho phép đưa lệnh giao dịch bằng ngôn ngữ tự nhiên qua XBTFX Trading API.

  • Có an toàn khi cấp quyền tài khoản cho tác nhân AI không?

    API key thường được tác nhân lưu cục bộ trên máy bạn và không được tải lên máy chủ bên thứ ba. Tác nhân gửi lệnh API trực tiếp tới máy chủ XBTFX bằng key của bạn. Bạn có thể thu hồi key tức thì từ Console bất cứ lúc nào. Khuyến nghị bắt đầu với tài khoản demo để kiểm tra cấu hình trước khi vận hành thật.

Bắt đầu xây dựng ngay hôm nay với

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 →

Trang này thuộc sở hữu và được vận hành bởi các công ty XBTFX, bao gồm:

XBTFX LLC được thành lập tại Antigua và Barbuda với số đăng ký ILLC001 và địa chỉ đăng ký tại Hodges Bay, P.O. Box 1348, St. John's, Antigua.

XBTFX (SC) Ltd. được thành lập tại Seychelles với số đăng ký 8434947-1 và địa chỉ kinh doanh tại Office 1, Block 2, 1st Floor, Sai-fu Building, Zone 20, Providence, Mahe, Seychelles, với Giấy phép số SD169.
Xử lý thanh toán được thực hiện bởi CLEARAY LTD, một công ty trách nhiệm hữu hạn được thành lập hợp pháp theo Luật Công ty, Chương 113 của Cộng hòa Síp, với số đăng ký công ty HE 462275 và văn phòng đăng ký tại Archiepiskopou Makariou ΙΙΙ, 160, 1st Floor, 3026, Limassol, Síp. XBTFX là nhà cung cấp hợp đồng chênh lệch (CFDs) trên nhiều loại tài sản, cung cấp dịch vụ trên cơ sở đòn bẩy. Xin lưu ý rằng việc định giá các khoản đầu tư của bạn phụ thuộc vào sự biến động của thị trường và có thể tăng hoặc giảm. Do đó, vốn đầu tư của bạn có rủi ro. Tài sản tiền điện tử, đặc biệt là không được quản lý và biến động đáng kể, không được bảo vệ người tiêu dùng. Ngoài ra, mọi lợi nhuận từ các khoản đầu tư của bạn có thể phải chịu thuế. XBTFX không cung cấp dịch vụ cho các cá nhân cư trú tại một số khu vực pháp lý nhất định, bao gồm nhưng không giới hạn ở Hoa Kỳ, Quebec (Canada), Bỉ, Belarus, Nga, Iran, Bắc Triều Tiên, Sudan, Yemen, hoặc bất kỳ khu vực nào khác mà các dịch vụ do XBTFX cung cấp sẽ vi phạm luật pháp hoặc quy định địa phương hiện hành. Danh sách này không đầy đủ và có thể được cập nhật khi cần thiết. XBTFX không nhắm mục tiêu tích cực vào khách hàng EU/EAA. Chúng tôi mạnh mẽ khuyến khích khách hàng tiềm năng hiểu rõ các quy định về ngoại hối áp dụng tại quốc gia của họ trước khi sử dụng dịch vụ của XBTFX. Thông báo Đầu tư Rủi ro Cao: Hợp đồng Chênh lệch (CFDs) là các công cụ tài chính phức tạp tiềm ẩn rủi ro đáng kể do bản chất đòn bẩy của chúng. Tổn thất tiền tệ nhanh chóng là một hệ quả có thể xảy ra khi sử dụng các công cụ này. Bạn bắt buộc phải đánh giá cẩn thận sự hiểu biết của mình về cách thức hoạt động của CFDs và xác định mức độ phù hợp của giao dịch CFD trong tình huống cụ thể của bạn. Bạn được khuyên mạnh mẽ không nên đầu tư các khoản tiền mà bạn không thể chấp nhận mất. Các sản phẩm có đòn bẩy có thể không phù hợp với tất cả mọi người và có thể dẫn đến việc cạn kiệt hoàn toàn vốn của bạn. Vui lòng đọc ‘Thông báo Công bố Rủi ro’. Giao dịch với XBTFX bằng cách theo dõi và/hoặc sao chép hoặc nhân bản các giao dịch của các nhà giao dịch khác liên quan đến mức độ rủi ro cao, ngay cả khi theo dõi/sao chép/nhân bản các nhà giao dịch hàng đầu. Những rủi ro này bao gồm rủi ro bạn có thể đang theo dõi/sao chép các quyết định giao dịch của các nhà giao dịch có thể thiếu kinh nghiệm/không chuyên nghiệp, hoặc các nhà giao dịch có mục đích cuối cùng, ý định hoặc tình trạng tài chính có thể khác với của bạn. Hiệu suất trong quá khứ không phải là chỉ báo về hiệu suất tương lai. Nội dung trên nền tảng giao dịch xã hội của XBTFX được tạo ra bởi các thành viên cộng đồng và không chứa lời khuyên hoặc khuyến nghị từ XBTFX hoặc thay mặt XBTFX. Thông báo Bảo vệ Chống Lừa đảo: XBTFX chỉ cung cấp dịch vụ môi giới cho khách hàng. Ngoài ra, XBTFX chỉ hoạt động thông qua URL xbtfx.com và khách hàng nên đảm bảo rằng họ chỉ truy cập dịch vụ của chúng tôi qua URL đó. XBTFX sẽ không bao giờ yêu cầu mật khẩu của bạn cũng như không liên hệ với bạn qua SMS/Điện thoại để yêu cầu điều đó. Nội dung được trình bày ở đây chỉ được cung cấp cho mục đích thông tin và tiếp thị. Nó không cấu thành, cũng như không nên được hiểu là, lời khuyên tài chính, đầu tư hoặc lời khuyên chuyên nghiệp khác hoặc khuyến nghị. Hơn nữa, nó không đại diện cho lời mời chào hoặc đề nghị mua, bán hoặc tham gia vào bất kỳ công cụ hoặc giao dịch tài chính nào. Khách hàng nên tìm kiếm ý kiến của các cố vấn tài chính được cấp phép để đảm bảo rằng họ có khẩu vị rủi ro, kinh nghiệm và kiến thức liên quan trước khi giao dịch. Trang này đã được dịch để thuận tiện cho bạn. Phiên bản tiếng Anh của tất cả các điều khoản, thỏa thuận, tài liệu pháp lý và điều kiện giao dịch sẽ được ưu tiên áp dụng trong trường hợp có bất kỳ sự không nhất quán nào.
2026 XBTFX LLC. All Rights Reserved.