Advertisement
Deseja criar uma app para iPhone/Android ou um widget do Facebook? Agora pode fazê-lo com a API Myfxbook. A API permite-lhe aceder aos dados da sua conta programaticamente e criar as suas próprias apps personalizadas.
- Sessions are IP-bound and expire after 1 month. Sessions are valid only from the login IP and have a 1-month TTL. Use the logout method to revoke early.
- Use o tipo JSON para facilitar o desenvolvimento (texto simples e formatado).
- Use uma ligação segura (HTTPS) para segurança máxima.
- Em caso de erro, verifique no campo o motivo.
- Os carimbos de data/hora da transação (ordens/negociações abertas, historial, pontos de dados para ganho/saldo diário) estão no fuso horário dos corretores locais.
- Todos os campos de resposta são autoexplicativos. Id é o id da entidade, accountId é o número da conta.
- O tipo de dimensionamento pode ser por lotes ou unidades (contas OANDA).
- A API permite acesso apenas a informações pessoais.
A API consiste nos seguintes métodos:
| Métodos | Descrição | Comentários |
|---|---|---|
| Login | Autentique-se na sua conta. | Creates a new session. |
| Logout | Saia da sua conta. | Invalidar a sessão atual. |
| get-my-accounts | Obter uma lista das minhas contas e dos meus dados. | |
| get-watched-accounts | Obter uma lista das minhas contas monitorizadas. | |
| get-open-trades | Obter negociações em aberto para uma conta. | |
| get-open-orders | Obter pedidos em aberto para uma conta. | |
| get-history | Obter historial para uma conta. | O historial é limitado às últimas 50 transações. |
| get-daily-gain | Obter valores de ganho diários. | Use para criar um gráfico de crescimento. |
| get-gain | Obter valor de ganho entre as datas. | |
| get-custom-widget | Obter um widget personalizado. | Use para criar um widget personalizado do saldo ou gráfico de crescimento da conta. |
| get-community-outlook | Obter a perspetiva de dados da comunidade. | Free version up to 100 requests per 24 hours. Paid version up to 2880 requests per 24 hours. |
| get-community-outlook-by-country | Obter a perspetiva da comunidade por dados do país. | Deve fornecer o nome do símbolo. |
| get-data-daily | Obter dados diários. | Use para criar um gráfico de crescimento, equilíbrio, património líquido, pips ou lucro. |
Existem vários tipos de erros possíveis:
- Campos obrigatórios ausentes
- E-mail/senha errado
- Sessão inválida
- Conta inválida
Como nos esforçamos no Myfxbook para manter o nosso serviço gratuito, qualquer software que venha desenvolver deverá ser gratuito. Apps bem desenhadas e a funcionar corretamente serão apresentadas na nossa área de apps (em breve).
Por favor, use a secção Programação para postar quaisquer perguntas sobre a API.
Ao usar a API Myfxbook, concorda com os Termos de Utilização.
Current version of the API is v1.38 (October 19, 2025) - Please check back once in a while for changes and updates.
10/19/25 - Sessions now IP-bound and 1-month TTL.
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.
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.
| Parâmetro | Descrição |
|---|---|
| Email do utilizador | |
| password | Senha do utilizador |
Pedido:
https://www.myfxbook.com/api/[email protected]&password=letsboogie
Resposta:
<response error="false" message="">
<session>DSL07vu14QxHWErTIAFrH40></session>
</response>
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
Pedido:
https://www.myfxbook.com/api/logout.xml?session=DSL07vu14QxHWErTIAFrH40
Resposta:
<response error="false" message="Logged out."></response>
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
Pedido:
https://www.myfxbook.com/api/get-my-accounts.xml?session=DSL07vu14QxHWErTIAFrH40
Resposta:
<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>
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
Pedido:
https://www.myfxbook.com/api/get-watched-accounts.xml?session=DSL07vu14QxHWErTIAFrH40
Resposta:
<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>
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
| id | Account ID |
Pedido:
https://www.myfxbook.com/api/get-open-orders.xml?session=DSL07vu14QxHWErTIAFrH40&id=12345
Resposta:
<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>
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
| id | Account ID |
Pedido:
https://www.myfxbook.com/api/get-open-trades.xml?session=DSL07vu14QxHWErTIAFrH40&id=12345
Resposta:
<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>
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
| id | Account ID |
Pedido:
https://www.myfxbook.com/api/get-history.xml?session=DSL07vu14QxHWErTIAFrH40&id=12345
Resposta:
<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>
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
| id | Account ID |
| start | Start date, format: yyyy-mm-dd |
| end | End date, format: yyyy-mm-dd |
Pedido:
https://www.myfxbook.com/api/get-daily-gain.xml?session=DSL07vu14QxHWErTIAFrH40&id=12345&start=2000-01-01&end=2010-01-01
Resposta:
<response error="false" message="">
<dailyGain>
<gain>
<date>02/01/2010</date>
<value>0.07</value>
<profit>0.03</profit>
</gain>
</dailyGain>
</response>
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
| id | Account ID |
| start | Start date, format: yyyy-mm-dd |
| end | End date, format: yyyy-mm-dd |
Pedido:
https://www.myfxbook.com/api/get-gain.xml?session=DSL07vu14QxHWErTIAFrH40&id=12345&start=2000-01-01&end=2010-01-01
Resposta:
<response error="false" message="">
<value>86.69</value>
</response>
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
| id | Account ID |
| width | Largura do widget |
| height | Altura do widget |
| bgcolor | Cor do fundo |
| chartbgc | Cor de fundo do gráfico |
| gridcolor | Cor da grelha |
| linecolor | Cor da linha |
| barcolor | Cor da barra |
| fontcolor | Cor da fonte |
| bart | Título da barra |
| linet | Título da linha |
| charttitle | Título do gráfico |
| titles | Tamanho da fonte do título |
Pedido:
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
Resposta: (exemplo apenas)
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
*Os valores das moedas são representados em USD ($).
Pedido:
https://www.myfxbook.com/api/get-community-outlook.xml?session=DSL07vu14QxHWErTIAFrH40
Resposta:
<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>
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
| symbol | Nome do símbolo |
Pedido:
https://www.myfxbook.com/api/get-community-outlook-by-country.xml?session=DSL07vu14QxHWErTIAFrH40&symbol=eurusd
Resposta:
<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>
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
| id | Account ID |
| start | Start date, format: yyyy-mm-dd |
| end | End date, format: yyyy-mm-dd |
Pedido:
https://www.myfxbook.com/api/get-data-daily.xml?session=DSL07vu14QxHWErTIAFrH40&id=12345&start=2000-01-01&end=2010-01-01
Resposta:
<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>
| Parâmetro | Descrição |
|---|---|
| Email do utilizador | |
| password | Senha do utilizador |
Pedido:
https://www.myfxbook.com/api/[email protected]&password=letsboogie
Resposta:
{
"error": false,
"message": "",
"session": "DSL07vu4QxHWErTIAFrH40"
}
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
Pedido:
https://www.myfxbook.com/api/logout.json?session=DSL07vu14QxHWErTIAFrH40
Resposta:
{
"error": false,
"message": "Logged out."
}
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
Pedido:
https://www.myfxbook.com/api/get-my-accounts.json?session=DSL07vu14QxHWErTIAFrH40
Resposta:
{
"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"
}
}
]
}
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
Pedido:
https://www.myfxbook.com/api/get-watched-accounts.json?session=DSL07vu14QxHWErTIAFrH40
Resposta:
{
"error": false,
"message": "",
"accounts": [
{
"name": "Holy Grail",
"gain": 8.92,
"drawdown": 53.53,
"demo": true,
"change": 1.53,
}
]
}
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
| id | Account ID |
Pedido:
https://www.myfxbook.com/api/get-open-orders.json?session=DSL07vu14QxHWErTIAFrH40&id=12345
Resposta:
{
"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"
}
]
}
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
| id | Account ID |
Pedido:
https://www.myfxbook.com/api/get-open-trades.json?session=DSL07vu14QxHWErTIAFrH40&id=12345
Resposta:
{
"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
}
]
}
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
| id | Account ID |
Pedido:
https://www.myfxbook.com/api/get-history.json?session=DSL07vu14QxHWErTIAFrH40&id=12345
Resposta:
{
"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
}
]
}
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
| id | Account ID |
| start | Start date, format: yyyy-mm-dd |
| end | End date, format: yyyy-mm-dd |
Pedido:
https://www.myfxbook.com/api/get-daily-gain.json?session=DSL07vu14QxHWErTIAFrH40&id=12345&start=2000-01-01&end=2010-01-01
Resposta:
{
"error": false,
"message": "",
"dailyGain": [
[ {
"date": "02/01/2010",
"value": 0.07,
"profit": 0.03
}]
]
}
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
| id | Account ID |
| start | Start date, format: yyyy-mm-dd |
| End | End date, format: yyyy-mm-dd |
Pedido:
https://www.myfxbook.com/api/get-gain.json?session=DSL07vu14QxHWErTIAFrH40&id=12345&start=2000-01-01&end=2010-01-01
Resposta:
{
"error": false,
"message": "",
"value": 86.69
}
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
| id | Account ID |
| width | Largura do widget |
| height | Altura do widget |
| bgcolor | Cor do fundo |
| chartbgc | Cor de fundo do gráfico |
| gridcolor | Cor da grelha |
| linecolor | Cor da linha |
| barcolor | Cor da barra |
| fontcolor | Cor da fonte |
| bart | Título da barra |
| linet | Título da linha |
| charttitle | Título do gráfico |
| titles | Tamanho da fonte do título |
Pedido:
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
Resposta:
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
Pedido:
https://www.myfxbook.com/api/get-community-outlook.json?session=DSL07vu14QxHWErTIAFrH40
Resposta:
{
"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"
}
}
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
| symbol | Nome do símbolo |
Pedido:
https://www.myfxbook.com/api/get-community-outlook-by-country.json?session=DSL07vu14QxHWErTIAFrH40&symbol=eurusd
Resposta:
{
"error": false,
"message": "",
"countries": [
{
"name": "GERMANY",
"code": "DE",
"longVolume": 13.71,
"shortVolume": 35.76,
"longPositions": 111,
"shortPositions": 489
}
]
}
| Parâmetro | Descrição |
|---|---|
| session | Session ID |
| id | Account ID |
| start | Start date, format: yyyy-mm-dd |
| end | End date, format: yyyy-mm-dd |
Pedido:
https://www.myfxbook.com/api/get-data-daily.json?session=DSL07vu14QxHWErTIAFrH40&id=12345&start=2000-01-01&end=2010-01-01
Resposta:
{
"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
}]
]
}