Python SDK for MetaStats forex trading statistics API. Can calculate metrics for MetaTrader accounts added to MetaApi. Supports both MetaTrader 5 (MT5) and MetaTrader 4 (MT4). (https://metaapi.cloud)
MetaStats is a fast, cost-efficient, easy to use and standards-driven cloud forex trading statistics API supporting both MetaTrader 4 and MetaTrader 5 platforms designed to boost forex application development process.
Using MetaStats API you can develop applications similar to Myfxbook or MetriX extremely fast, saving time you otherwise spend for coding, optimizing and testing your own trading metrics calculation engine, since we already did it for you.
MetaStats API is a member of MetaApi project (https://metaapi.cloud), a powerful cloud forex trading API which supports both MetaTrader 4 and MetaTrader 5 platforms.
This SDK requires a 3.8+ version of Python to run.
MetaStats API features
support for MetaTrader 4 and MetaTrader 5 platforms
metrics calculation for MetaTrader accounts added to MetaApi
optionally include open positions in metrics calculation
get historical trades for MetaApi account. The historical trades data is updated when you invoke metrics calculation endpoint or when set query parameter updateHistory to true
get open trades for MetaApi account
The features described above are available for use via a professional, fast, easy to use, standards-driven REST API which can be easily consumed from any programming language.
The primary intended use of MetaStats API is creating trade monitoring applications.
MetaStats is available to all MetaApi users without extra charges at this point.
You pay a fee executing MetaTrader terminal on MetaApi cloud. See https://metaapi.cloud/#pricing for more details.
MetaApi provides a free tier so that you can test our APIs without any charges.
Frequently asked questions (FAQ)
FAQ is located here: http://metaapi.cloud/docs/metastats/faq
REST API documentation
MetaStats SDK is built on top of MetaStats REST API.
MetaStats REST API docs are available at https://metaapi.cloud/docs/metastats/
We published some code examples in our github repository, namely:
pip install metaapi-cloud-sdk
Retrieving API token
Please visit https://app.metaapi.cloud/token web UI to obtain your API token.
Configuring trading statistics
from metaapi_cloud_sdk import MetaStats token = '...' api = MetaStats(token=token)
See in-code documentation for full definition of possible configuration options.
Retrieving trading statistics
account_id = '...' # MetaApi account id # retrieve MetaApi MetaTrader account statistics print(await metaStats.get_metrics(account_id=account_id)) # retrieve MetaApi MetaTrader account statistics including open positions print(await metaStats.get_metrics(account_id=account_id, include_open_positions=True)) # retrieve MetaApi MetaTrader account trades print(await metaStats.get_account_trades(account_id=account_id, start_time='2020-01-01 00:00:00.000', end_time='2021-01-01 00:00:00.000')) # retrieve MetaApi MetaTrader account open trades print(await metaStats.get_account_open_trades(account_id=account_id))
Quotas and rate limits
API calls you make are subject to rate limits. See https://metaapi.cloud/docs/metastats/rateLimiting/ for more details.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for metaapi_cloud_metastats_sdk-3.2.0.tar.gz