API | Myfxbook

Bạn muốn tạo một ứng dụng iPhone/Android hoặc một tiện ích Facebook? Bây giờ bạn có thể làm điều đó với Myfxbook API. API cho phép bạn truy cập dữ liệu tài khoản theo lập trình và tạo các ứng dụng tùy chỉnh của riêng bạn.

Lưu ý quan trọng và mẹo

Phiên không kết thúc. Để kết thúc phiên, hãy sử dụng phương pháp đăng xuất.
Đặt ’debug=1’ ở kiểu JSON để phát triển dễ dàng hơn (văn bản thuần túy và có định dạng).
Sử dụng kết nối an toàn (HTTPS) để bảo mật tối đa.
Trong trường hợp xảy ra lỗi, hãy xem phần ’tin nhắn’ để tìm hiểu lý do.
Mốc thời gian giao dịch (lệnh/giao dịch mở, lịch sử, điểm dữ liệu cho mức sinh lời/số dư hàng ngày) tính theo múi giờ của sàn giao dịch địa phương.
Tất cả các trường phản hồi đều rất rõ ràng. ’Id’ là id của thực thể, ’accountId’ là số tài khoản.
Loạ quy mô có thể là lô hoặc đơn vị (tài khoản OANDA).
API chỉ cho phép truy cập thông tin cá nhân.

Phương pháp

API bao gồm các phương thức sau:

Phương pháp	Mô tả	Bình luận
Login	Đăng nhập tài khoản.	Tạo một phiên mới.
Logout	Đăng xuất tài khoản.	Vô hiệu hóa phiên hiện tại.
get-my-accounts	Lấy danh sách tài khoản của tôi và dữ liệu của chúng.
get-watched-accounts	Lấy danh sách các tài khoản đã theo dõi của tôi.
get-open-trades	Lấy giao dịch mở cho một tài khoản.
get-open-orders	Lấy lệnh mở cho một tài khoản.
get-history	Lấy lịch sử cho một tài khoản.	Lịch sử được giới hạn đến 50 giao dịch gần nhất.
get-daily-gain	Lấy giá trị sinh lời hàng ngày.	Sử dụng để tạo biểu đồ tăng trưởng.
get-gain	Lấy giá trị sinh lời giữa các ngày.
get-custom-widget	Lấy tiện ích tùy chỉnh.	Sử dụng để tạo tiện ích tùy chỉnh về số dư hoặc biểu đồ tăng trưởng của tài khoản.
get-community-outlook	Lấy dữ liệu triển vọng cộng đồng.	Free version up to 100 requests per 24 hours. Paid version up to 2880 requests per 24 hours.
get-community-outlook-by-country	Lấy triển vọng cộng đồng theo dữ liệu quốc gia.	Phải cung cấp tên mã.
get-data-daily	Lấy dữ liệu hàng ngày.	Sử dụng để tạo biểu đồ tăng trưởng, số dư, vốn chủ sở hữu, pip hoặc lợi nhuận.

Xử lý lỗi

Một số loại lỗi có thể xảy ra:

Chưa nhập trường bắt buộc
Sai email/mật khẩu
Phiên không hợp lệ
Tài khoản không hợp lệ

Nguyên tắc phần mềm

Vì chúng tôi cố gắng duy trì dịch vụ miễn phí tại Myfxbook nên bất kỳ phần mềm nào do bạn phát triển đều phải miễn phí. Các ứng dụng được thiết kế tốt và hoạt động tốt sẽ được giới thiệu trong khu vực ứng dụng của chúng tôi (sắp ra mắt).

Hỗ trợ

Vào phần Lập trình để đăng bất kỳ câu hỏi nào liên quan đến API.

Điều khoản sử dụng

Bằng cách sử dụng Myfxbook API, bạn đồng ý với Điều khoản sử dụng.

Phiên bản API

Current version of the API is v1.37 (July 19, 2020) - Please check back once in a while for changes and updates.

07/19/20 - get-community-outlook has now two versions - in the free version it is limited to 100 requests per 24 hours while the paid version limit is increased to 2800 requests per 24 hours.

10/04/12 - get-daily-balance method deprecated, added pips to get-my-accounts, added get-data-daily. Version changed to 1.37

11/27/11 - added profit factor to get-my-accounts method. Version changed to 1.36

09/21/11 - added currency to get-my-accounts method. Version changed to 1.35

08/23/11 - added get-gain. Version changed to 1.34

08/07/11 - added profit to Daily Gain . Version changed to 1.33

06/23/11 - added invitationUrl . Version changed to 1.32

05/18/11 - added comment to open orders method and to open trades method. Version changed to 1.31

03/27/11 - added commission to get-my-accounts method. Added interest and commission to get-history method. Version changed to v1.3

11/14/10 - added avgLongPrice/avgShortPrice to get-community-outlook method. Version changed to v1.2

11/01/10 - get-community-outlook and get get-community-outlook-by-country added. Version changed to v1.1

10/03/10 - firstTradeDate added. Version changed to v1.03

06/27/10 - get-custom-widget added. Version changed to v1.02

05/23/10 - get-watched-accounts added. Version Changed to v1.01

04/11/10 - gmtOffset field deprecated.

Đăng nhập

Thông số	Mô tả
email	Email người dùng
password	Mật khẩu người dùng

Yêu cầu:

https://www.myfxbook.com/api/[email protected]&password=letsboogie

Phản hồi:

<response error="false" message="">
    <session>DSL07vu14QxHWErTIAFrH40></session>
</response>

Đăng xuất

Thông số	Mô tả
session	Session ID

Yêu cầu:

https://www.myfxbook.com/api/logout.xml?session=DSL07vu14QxHWErTIAFrH40

Phản hồi:

<response error="false" message="Logged out."></response>

Lấy tài khoản của tôi

Thông số	Mô tả
session	Session ID

Yêu cầu:

https://www.myfxbook.com/api/get-my-accounts.xml?session=DSL07vu14QxHWErTIAFrH40

Phản hồi:

<response error="false" message="">
    <accounts>
        <account>
            <id>12345</id>
            <name>Holy Grail</name>
            <description>
            Super duper MA+CCI trading system.
            </description>
            <accountId>1013230</accountId>
            <gain>8.92</gain>
            <absGain>8.92</absGain>
            <daily>0.04</daily>
            <monthly>1.25</monthly>
            <withdrawals>0.00</withdrawals>
            <deposits>10000.00</deposits>
            <interest>11.10</interest>
            <profit>892.45</profit>
            <balance>10892.45</balance>
            <drawdown>53.53</drawdown>
            <equity>10892.45</equity>
            <demo>true</demo>
            <lastUpdateDate>03/01/2010 10:14</lastUpdateDate>
            <creationDate>08/06/2009 08:13</creationDate>
            <firstTradeDate>04/21/2008 11:58</firstTradeDate>
            <tracking>21</tracking>
            <views>549</views>
            <commission>0</commission>
            <currency>USD</currency>
            <profitFactor>0.16</profitFactor>
            <pips>81.20</pips>
            <invitationUrl>https://www.myfxbook.com/members/john101/anyone/347/SDa45X5TSkdIsXg8</invitationUrl>
            <server>
                <name>Alpari UK</name>
            </server>
        </account>
    </accounts>
</response>

Lấy danh sách tài khoản theo dõi

Thông số	Mô tả
session	Session ID

Yêu cầu:

https://www.myfxbook.com/api/get-watched-accounts.xml?session=DSL07vu14QxHWErTIAFrH40

Phản hồi:

<response error="false" message="">
    <accounts>
        <account>
            <name>Holy Grail</name>
            <gain>8.92</gain>
            <drawdown>53.53</drawdown>
            <demo>true</demo>
            <change>1.53</change>
        </account>
    </accounts>
</response>

Lấy lệnh mở

Thông số	Mô tả
session	Session ID
id	Account ID

Yêu cầu:

https://www.myfxbook.com/api/get-open-orders.xml?session=DSL07vu14QxHWErTIAFrH40&id=12345

Phản hồi:

 <response error="false" message="">
     <openOrders>
         <order>
             <openDate>03/01/2010 13:52</openDate>
             <symbol>GBPUSD</symbol>
             <action>Sell Limit</action>
             <sizing>
                 <type>lots</type>
                 <value>0.08</value>
             </sizing>
             <openPrice>1.4932</openPrice>
             <tp>1.48820</tp>
             <sl>0.00000</sl>
             <comment>Best trade ever</comment>
         </order>
     </openOrders>
 </response>

Lấy diao dịch mở

Thông số	Mô tả
session	Session ID
id	Account ID

Yêu cầu:

https://www.myfxbook.com/api/get-open-trades.xml?session=DSL07vu14QxHWErTIAFrH40&id=12345

Phản hồi:

<response error="false" message="">
    <opentrades>
        <trade>
            <openDate>03/01/2010 13:39</openDate>
            <symbol>GBPUSD</symbol>
            <action>Sell</action>
            <sizing>
                <type>lots</type>
                <value>0.01</value>
            </sizing>
            <openPrice>1.4802</openPrice>
            <tp>1.4832</tp>
            <sl>0</sl>
            <profit>-10.8</profit>
            <pips>-108.0</pips>
            <swap>0.0</swap>
            <comment>Best trade ever</comment>
            <magic>24129962</magic>
        </trade>
    </opentrades>
</response>

Lấy lịch sử

Thông số	Mô tả
session	Session ID
id	Account ID

Yêu cầu:

https://www.myfxbook.com/api/get-history.xml?session=DSL07vu14QxHWErTIAFrH40&id=12345

Phản hồi:

<response error="false" message="">
   <history>
       <transaction>
           <openDate>03/01/2010 14:13</openDate>
           <closeDate>03/01/2010 15:26</closeDate>
           <symbol>GBPUSD</symbol>
           <action>Buy Limit</action>
           <sizing>
               <type>lots</type>
               <value>0.04</value>
           </sizing>
           <openPrice>1.48310</openPrice>
           <closePrice>1.49340</closePrice>
           <tp>1.48810</tp>
           <sl>0.00000</sl>
           <pips>0.0</pips>
           <profit>0.00</profit>
           <comment>Best trade ever</comment>
           <interest>12.1</interest>
           <commission>0</commission>
       </transaction>
   </history>
</response>

Lấy mức sinh lợi hàng ngày

Thông số	Mô tả
session	Session ID
id	Account ID
start	Start date, format: yyyy-mm-dd
end	End date, format: yyyy-mm-dd

Yêu cầu:

https://www.myfxbook.com/api/get-daily-gain.xml?session=DSL07vu14QxHWErTIAFrH40&id=12345&start=2000-01-01&end=2010-01-01

Phản hồi:

<response error="false" message="">
    <dailyGain>
        <gain>
            <date>02/01/2010</date>
            <value>0.07</value>
            <profit>0.03</profit>
        </gain>
    </dailyGain>
</response>

Đạt mức sinh lời

Thông số	Mô tả
session	Session ID
id	Account ID
start	Start date, format: yyyy-mm-dd
end	End date, format: yyyy-mm-dd

Yêu cầu:

https://www.myfxbook.com/api/get-gain.xml?session=DSL07vu14QxHWErTIAFrH40&id=12345&start=2000-01-01&end=2010-01-01

Phản hồi:

<response error="false" message="">
   <value>86.69</value>
</response>

Lấy tiện ích tùy chỉnh

Thông số	Mô tả
session	Session ID
id	Account ID
width	Chiều rộng tiện ích
height	Chiều cao tiện ích
bgcolor	Màu nền
chartbgc	Màu nền biểu đồ
gridcolor	Màu lưới
linecolor	Màu đường kẻ
barcolor	Màu thanh
fontcolor	Màu chữ
bart	Tiêu đề thanh
linet	Tiêu đề dòng
charttitle	Tiêu đề biểu đồ
titles	Cỡ chữ tiêu đề

Yêu cầu:

https://widgets.myfxbook.com/api/get-custom-widget.png?session=DSL07vu14QxHWErTIAFrH40&id=12345&width=300&height=200&bart=1&linet=0&bgColor=000000&gridColor=BDBDBD&lineColor=00CB05&barColor=FF8D0A&fontColor=FFFFFF&title=&titles=20&chartbgc=474747

Phản hồi: (chỉ là ví dụ)

Lấy triển vọng cộng đồng

Thông số	Mô tả
session	Session ID

*Giá trị tiền tệ được thể hiện bằng USD ($).

Yêu cầu:

https://www.myfxbook.com/api/get-community-outlook.xml?session=DSL07vu14QxHWErTIAFrH40

Phản hồi:

<response error="false" message="">
    <community-outlook>
        <symbols>
            <symbol>
                <name>EURUSD</name>
                <shortPercentage>55</shortPercentage>
                <longPercentage>44</longPercentage>
                <shortVolume>1142.58</shortVolume>
                <longVolume>905.47</longVolume>
                <longPositions>2932</longPositions>
                <shortPositions>3888</shortPositions>
                <totalPositions>2048</totalPositions>
                <avgShortPrice>1.3808</avgShortPrice>
                <avgLongPrice>1.4097</avgLongPrice>
            </symbol>
        </symbols>

        <general>
            <demoAccountsPercentage>43</demoAccountsPercentage>
            <realAccountsPercentage>56</realAccountsPercentage>
            <profitablePercentage>54</profitablePercentage>
            <nonProfitablePercentage>45</nonProfitablePercentage>
            <fundsWon>6,819,251.63</fundsWon>
            <fundsLost>-8,740,646.15</fundsLost>
            <averageDeposit>21,740.16</averageDeposit>
            <averageAccountProfit>4,127.88</averageAccountProfit>
            <averageAccountLoss>-5,290.95</averageAccountLoss>
            <totalFunds>35,914,737.56</totalFunds>
        </general>
    </community-outlook>
</response>

Lấy triển vọng cộng đồng theo quốc gia

Thông số	Mô tả
session	Session ID
symbol	Tên mã

Yêu cầu:

https://www.myfxbook.com/api/get-community-outlook-by-country.xml?session=DSL07vu14QxHWErTIAFrH40&symbol=eurusd

Phản hồi:

<response error="false" message="">
    <community-outlook-by-country>
        <countries>
            <country>
                <name>GERMANY</name>
                <code>DE</code>
                <longVolume>13.71</longVolume>
                <shortVolume>35.76</shortVolume>
                <longPositions>111</longPositions>
                <shortPositions>489</shortPositions>
            </country>
        </countries>
    </community-outlook-by-country>
</response>

Lấy dữ liệu hàng ngày

Thông số	Mô tả
session	Session ID
id	Account ID
start	Start date, format: yyyy-mm-dd
end	End date, format: yyyy-mm-dd

Yêu cầu:

https://www.myfxbook.com/api/get-data-daily.xml?session=DSL07vu14QxHWErTIAFrH40&id=12345&start=2000-01-01&end=2010-01-01

Phản hồi:

<response error="false" message="">
    <dataDaily>
        <data>
            <date>02/01/2010</date>
            <balance>25083.56</balance>
            <pips>83.30</pips>
            <lots>0.41</lots>
            <floatingPL>-500.00</floatingPL>
            <profit>84.7400</profit>
            <growthEquity>-4.15</growthEquity>
            <floatingPips>1.00</floatingPips>
        </data>
    </dataDaily>
</response>

Đăng nhập

Thông số	Mô tả
email	Email người dùng
password	Mật khẩu người dùng

Yêu cầu:

https://www.myfxbook.com/api/[email protected]&password=letsboogie

Phản hồi:

{
 "error": false,
 "message": "",
 "session": "DSL07vu4QxHWErTIAFrH40"
}

Đăng xuất

Thông số	Mô tả
session	Session ID

Yêu cầu:

https://www.myfxbook.com/api/logout.json?session=DSL07vu14QxHWErTIAFrH40

Phản hồi:

{
 "error": false,
 "message": "Logged out."
}

Lấy tài khoản của tôi

Thông số	Mô tả
session	Session ID

Yêu cầu:

https://www.myfxbook.com/api/get-my-accounts.json?session=DSL07vu14QxHWErTIAFrH40

Phản hồi:

{
     "error": false,
     "message": "",
     "accounts":  [
        {
       "id": 12345,
       "name": "Holy Grail",
       "description": "Super duper MA+CCI trading system.",
       "accountId": 1013230,
       "gain": 8.92,
       "absGain": 8.92,
       "daily": "0.04",
       "monthly": "1.25",
       "withdrawals": 0,
       "deposits": 10000,
       "interest": 11.1,
       "profit": 892.45,
       "balance": 10892.45,
       "drawdown": 53.53,
       "equity": 10892.45,
       "equityPercent": 100,
       "demo": true,
       "lastUpdateDate": "03/01/2010 10:14",
       "creationDate": "08/06/2009 08:13",
       "firstTradeDate": "04/21/2008 12:18",
       "tracking": 21,
       "views": 549,
       "commission":0,
       "currency":"USD",
       "profitFactor": 0.3,
       "pips": 81.20,
       "invitationUrl": "https://www.myfxbook.com/members/john101/anyone/347/SDa45X5TSkdIsXg8",
       "server":    {
        "name": "Alpari UK"
       }
      }
     ]
}

Lấy danh sách tài khoản theo dõi

Thông số	Mô tả
session	Session ID

Yêu cầu:

https://www.myfxbook.com/api/get-watched-accounts.json?session=DSL07vu14QxHWErTIAFrH40

Phản hồi:

{
     "error": false,
     "message": "",
     "accounts":  [
        {
       "name": "Holy Grail",
       "gain": 8.92,
       "drawdown": 53.53,
       "demo": true,
       "change": 1.53,
      }
     ]
}

Lấy lệnh mở

Thông số	Mô tả
session	Session ID
id	Account ID

Yêu cầu:

https://www.myfxbook.com/api/get-open-orders.json?session=DSL07vu14QxHWErTIAFrH40&id=12345

Phản hồi:

{
 "error": false,
 "message": "",
 "openOrders":  [
    {
   "openTime": "03/01/2010 13:52",
   "symbol": "GBPUSD",
   "action": "Sell Limit",
   "sizing":    {
    "type": "lots",
    "value": "0.08"
   },
   "openPrice": 1.4932,
   "tp": 1.4882,
   "sl": 0,
   "comment":"Best trade ever"
  }
 ]
}

Lấy diao dịch mở

Thông số	Mô tả
session	Session ID
id	Account ID

Yêu cầu:

https://www.myfxbook.com/api/get-open-trades.json?session=DSL07vu14QxHWErTIAFrH40&id=12345

Phản hồi:

{
 "error": false,
 "message": "",
 "openTrades":  [
    {
   "openTime": "03/01/2010 13:39",
   "symbol": "GBPUSD",
   "action": "Sell",
   "sizing":    {
    "type": "lots",
    "value": "0.01"
   },
   "openPrice": 1.4802,
   "tp": 1.4832,
   "sl": 0,
   "comment":"best trade ever",
   "profit": -10.8,
   "pips": -108,
   "swap": 0,
   "magic": 24129962

  }
 ]
}

Lấy lịch sử

Thông số	Mô tả
session	Session ID
id	Account ID

Yêu cầu:

https://www.myfxbook.com/api/get-history.json?session=DSL07vu14QxHWErTIAFrH40&id=12345

Phản hồi:

{
 "error": false,
 "message": "",
 "history":  [
    {
   "openTime": "03/01/2010 14:13",
   "closeTime": "03/01/2010 15:26",
   "symbol": "GBPUSD",
   "action": "Buy Limit",
   "sizing":    {
    "type": "lots",
    "value": "0.04"
   },
   "openPrice": 1.4831,
   "closePrice": 1.4934,
   "tp": 1.4881,
   "sl": 0,
   "comment":"best trade ever",
   "pips": 0,
   "profit": 0,
   "interest": 12.1,
   "commission": 0
  }
 ]
}

Lấy mức sinh lợi hàng ngày

Thông số	Mô tả
session	Session ID
id	Account ID
start	Start date, format: yyyy-mm-dd
end	End date, format: yyyy-mm-dd

Yêu cầu:

https://www.myfxbook.com/api/get-daily-gain.json?session=DSL07vu14QxHWErTIAFrH40&id=12345&start=2000-01-01&end=2010-01-01

Phản hồi:

{
 "error": false,
 "message": "",
 "dailyGain":  [
  [  {
   "date": "02/01/2010",
   "value": 0.07,
   "profit": 0.03
  }]
 ]
}

Đạt mức sinh lời

Thông số	Mô tả
session	Session ID
id	Account ID
start	Start date, format: yyyy-mm-dd
End	End date, format: yyyy-mm-dd

Yêu cầu:

https://www.myfxbook.com/api/get-gain.json?session=DSL07vu14QxHWErTIAFrH40&id=12345&start=2000-01-01&end=2010-01-01

Phản hồi:

{
 "error": false,
 "message": "",
 "value": 86.69
}

Lấy tiện ích tùy chỉnh

Thông số	Mô tả
session	Session ID
id	Account ID
width	Chiều rộng tiện ích
height	Chiều cao tiện ích
bgcolor	Màu nền
chartbgc	Màu nền biểu đồ
gridcolor	Màu lưới
linecolor	Màu đường kẻ
barcolor	Màu thanh
fontcolor	Màu chữ
bart	Tiêu đề thanh
linet	Tiêu đề dòng
charttitle	Tiêu đề biểu đồ
titles	Cỡ chữ tiêu đề

Yêu cầu:

https://widgets.myfxbook.com/api/get-custom-widget.png?session=DSL07vu14QxHWErTIAFrH40&id=12345&width=300&height=200&bart=1&linet=0&bgColor=000000&gridColor=BDBDBD&lineColor=00CB05&barColor=FF8D0A&fontColor=FFFFFF&title=&titles=20&chartbgc=474747

Phản hồi:

Lấy triển vọng cộng đồng

Thông số	Mô tả
session	Session ID

Yêu cầu:

https://www.myfxbook.com/api/get-community-outlook.json?session=DSL07vu14QxHWErTIAFrH40

Phản hồi:

{
 "error": false,
 "message": "",
 "symbols":  [
    {
   "name": "EURUSD",
   "shortPercentage": 55,
   "longPercentage": 44,
   "shortVolume": 1142.58,
   "longVolume": 905.47,
   "longPositions": 2932,
   "shortPositions": 3888,
   "totalPositions": 2048,
   "avgShortPrice":1.3808,
   "avgLongPrice":1.4097
  }
 ],
 "general":  {
  "demoAccountsPercentage": 43,
  "realAccountsPercentage": 56,
  "profitablePercentage": 54,
  "nonProfitablePercentage": 45,
  "fundsWon": "6,819,251.63",
  "fundsLost": "-8,740,646.15",
  "averageDeposit": "21,740.16",
  "averageAccountProfit": "4,127.88",
  "averageAccountLoss": "-5,290.95",
  "totalFunds": "35,914,737.56"
 }
}

Lấy triển vọng cộng đồng theo quốc gia

Thông số	Mô tả
session	Session ID
symbol	Tên mã

Yêu cầu:

https://www.myfxbook.com/api/get-community-outlook-by-country.json?session=DSL07vu14QxHWErTIAFrH40&symbol=eurusd

Phản hồi:

{
 "error": false,
 "message": "",
 "countries":  [
    {
   "name": "GERMANY",
   "code": "DE",
   "longVolume": 13.71,
   "shortVolume": 35.76,
   "longPositions": 111,
   "shortPositions": 489
  }
 ]
}

Lấy dữ liệu hàng ngày

Thông số	Mô tả
session	Session ID
id	Account ID
start	Start date, format: yyyy-mm-dd
end	End date, format: yyyy-mm-dd

Yêu cầu:

https://www.myfxbook.com/api/get-data-daily.json?session=DSL07vu14QxHWErTIAFrH40&id=12345&start=2000-01-01&end=2010-01-01

Phản hồi:

{
 "error": false,
 "message": "",
 "dataDaily":  [
  [  {
   "date": "02/01/2010",
   "balance": 25083.56,
   "pips": 83.30,
   "lots": 0.41,
   "floatingPL": -500.00,
   "profit": 84.7400,
   "growthEquity": -4.15,
   "floatingPips": 1.00
  }]
 ]
}

EURUSD	1.05813	GBPUSD	1.27446	AUDUSD	0.6524
USDJPY	149.627	USDCAD	1.39998	USDCHF	0.88044