User guide to the raw DARWIN data offered through FTP.
Table of contents
- Main FTP Directory Structure
- Structure of the Quotes folder
- Charts
- AVG_LEVERAGE
- BADGES
- BEHAVIOR
- CLOSE_STRATEGY
- DAILY_FIXED_DIVERGENCE
- DAILY_REAL_DIVERGENCE
- DURATION_CONSISTENCY
- EXPERIENCE
- LOSING_CONSISTENCY
- LOSS_AVERSION
- LOSS_AVERSION_UNADJUSTED_VAR
- MARKET_CORRELATION
- MONTHLY_DIVERGENCE
- OPEN_STRATEGY
- ORDER_DIVERGENCE
- PERFORMANCE
- POSITIONS
- RETURN
- RETURN_DIVERGENCE
- RISK_ADJUSTMENT
- RISK_STABILITY
- ROTATION
- SCALABILITY
- TRADE_CONSISTENCY
- TRADE_LOSS_AVERSION
- TRADES
- TRADE_UNADJUSTED_LOSS_AVERSION
- WINNING_CONSISTENCY
- INVESTMENT_CHART
- INVESTORS_CHART
1. Main FTP Directory Structure
Upon entering the FTP root directory, you will find a folder for each DARWIN ever listed on the DARWIN Exchange, with the folder names corresponding to DARWIN ticker symbols (e.g. NTI, PLF, etc.).
Each of these folders contains two folders, one named "quotes" that holds the asset's most up-to-date Quote time series in tick precision. The other one, named "{DARWIN_TICKER}_former_var10", holds the data for the former version of the DARWIN.
You will also find up to 30 more time series datasets in a DARWIN’s folder, containing data used to construct graphs and charts on its DARWIN listing page, e.g. Open Trades, D-Leverage, DARWIN volatility vs EURUSD volatility, etc.
The folder with the data for the former Darwin version follows the exact same structure: a folder with the quote time series and 30 time series datasets.
There is an exception to this format, though. If a DARWIN was closed before the creation of most recent version of the DARWINs, only the former folder will appear inside the ticker folder but nothing regarding the current version.
2. Structure of the Quotes folder
Inside this folder exists another set of folders organized by year and month, following the naming convention “YYYY-MM”.
These contain a collection of gzip-compressed CSV files. These files have the following naming convention:
{DARWIN_TICKER}.{PRODUCT_RISK}.{COLOUR}_{PRODUCTID}_YYYY-MM-DD.HH.csv.gz
For example:
AGD.4.9_6112_2018-01-01.01.csv.gz
Inside each file, there will be several lines showing the quote values for several moments during that hour. The csv contains just 2 fields:
- Timestamp in milliseconds from epoch (UTC time zone)
- Quote value (rounded to the 4th decimal place)
3. Charts
There are 30 different charts available. It is possible that some DARWINs have no information regarding some of the charts. If that is the case, there will be no file for that chart. The names of the different files are identical to the names of the charts themselves.
The different charts and their structure are listed below.
a) AVG_LEVERAGE
Contains information about the DARWIN’s D-Leverage, i.e. the volatility of the DARWIN compared with that of the EURUSD. The last field is an array with a series of values. The size of this array can be up to 24 elements (one per hour). In practice taking the last one is enough. The included fields are:
- Timestamp in milliseconds from epoch (UTC time zone)
- Number of periods at the end of the day
- An array with a variable number of values for D-Leverage
b) BADGES
Contains the history of the DARWIN’s attribute scores. Each line has the following structure:
- Timestamp in milliseconds from epoch (UTC time zone).
- Number of periods at the end of the day.
- An array with the attribute scores in that moment. The attributes are ordered following the table below.
- The time when the calculation of the first attribute was made. It is a timestamp in milliseconds from epoch (UTC time zone).
- The time when the calculation of the last attribute was made. It is a timestamp in milliseconds from epoch (UTC time zone).
Attribute order
Web symbol | Description |
EX | Experience |
MC | Market Correlation |
RS | Risk Stability |
RA | Risk Aversion |
OS | Open Strategy |
CS | Close Strategy |
R+ | Winning Consistency |
R- | Losing Consistency |
DC | Duration Consistency |
LA | Loss Aversion |
PF | Performance |
CP | Scalability |
D-Score | Darwinex Score |
c) BEHAVIOR
This chart shows the amount of orders per hour. Field distribution is:
- Timestamp in milliseconds from epoch (UTC time zone).
- Number of periods at the end of the day.
- [[Optional]] If the trader has traded that day, there will be an array with up to 24 elements containing the number of orders. The first element will contain the orders placed from 00:00 AM to 01:00 AM, the second one from 01:00 AM to 02:00 AM, and so on.
d) CLOSE_STRATEGY
A series of values showing the effect of closing a trade with a certain time difference compared to the actual closing time (expressed as a percentage). This one is analogous to the OPEN_STRATEGY chart. The line structure is as follows:
- Timestamp in milliseconds from epoch (UTC time zone).
- Number of periods at the end of the day.
- [[Optional]] If the trader traded that day, an array with 12 elements. It contains a comparison of the closing time with doing it a certain amount of time before or after. The strategy ranks are added by incrementally changing the closing time. For example, if a position was closed a 20% later it will rank 3rd, 7th and 5th. So this strategy is 15/3 = 5th average position.
Position in array | Variation | Description |
1 | -- | Number of closed trades during the day. |
2 | 0% | Sum of ranks on the real strategy. |
3 | -50% | Sum of ranks closing a 50% before. |
4 | -40% | Sum of ranks closing a 40% before. |
5 | -30% | Sum of ranks closing a 30% before. |
6 | -20% | Sum of ranks closing a 20% before. |
7 | -10% | Sum of ranks closing a 10% before. |
8 | +10% | Sum of ranks closing a 10% after. |
9 | +20% | Sum of ranks closing a 20% after. |
10 | +30% | Sum of ranks closing a 30% after. |
11 | +40% | Sum of ranks closing a 40% after. |
12 | +50% | Sum of ranks closing a 50% after. |
e) DAILY_FIXED_DIVERGENCE
Analyzes the effect of applying a fixed divergence (10-5) on the profit. Each line is composed of 2 fields:
- Timestamp in milliseconds from epoch (UTC time zone).
- Profit difference.
f) DAILY_REAL_DIVERGENCE
Analyzes the effect of applying the investors divergence on the profit. Again each line is composed of 2 fields:
- Timestamp in milliseconds from epoch (UTC time zone).
- Profit difference.
g) DURATION_CONSISTENCY
A series of data for every single position. The structure goes as follows:
- Timestamp in milliseconds from epoch (UTC time zone).
- Number of periods at the end of the day.
- An array with data of the last 100 positions in that day. It could be an empty array if there are no trades. Each position contains:
- The start time of the position expressed in milliseconds.
- The lifespan of the position in milliseconds.
- Gross profit of the position.
- The VaR at the beginning of the day of that position.
- The leverage at the beginning of the position.
h) EXPERIENCE
Contains information about D-periods for each day. The structure is:
- Timestamp in milliseconds from epoch (UTC time zone).
- Number of D-periods at the end of the day.
- An array with
- Number of days in that period.
- Number of decisions in that period.
i) LOSING_CONSISTENCY
Analogous to the DURATION_CONSISTENCY chart, this time with losing trades and limited to 50 trades. Contents are:
- Timestamp in milliseconds from epoch (UTC time zone).
- Number of periods at the end of the day.
- An array with data about the last 50 losing positions in that day. It could be an empty array if there are no trades. Each position has:
- Start time of the position expressed in milliseconds from epoch.
- Position lifespan in milliseconds.
- Gross profit of the position.
- VaR at the start of the day on that position.
- Leverage at the start of the position.
j) LOSS_AVERSION
Contains information of trades grouped by day and different profits: maximum, minimum and closed. There is a twin chart for traders (LOSS_AVERSION_UNADJUSTED_VAR) with the only change of not adjusting the size of trades by VaR. The content structure is:
- Timestamp in milliseconds from epoch (UTC time zone).
- Number of periods at the end of the day.
- An array with date for each trade in the day:
- Instrument Id.
- Trade start date in milliseconds.
- Max profit of trade.
- Min profit of trade.
- Real profit of trade when it was closed.
- Trade still open (1 means “yes”, 0 means “no”)
k) LOSS_AVERSION_UNADJUSTED_VAR
Just like the previous one, only this time the size of the trades is not adjusted by VaR. The contents are also equal to the LOSS_AVERSION chart:
- Timestamp in milliseconds from epoch (UTC time zone).
- Number of periods at the end of the day.
- An array with date for each trade in the day:
- Instrument Id.
- Trade start date in milliseconds.
- Max profit of trade.
- Min profit of trade.
- Real profit of trade when it was closed.
- Trade still open (1 means “yes”, 0 means “no”)
l) MARKET_CORRELATION
Analyzes the correlation between the trader’s strategy with the market evolution in different durations, namely 3, 6 and 12 D-periods. It has the following format:
- Timestamp in milliseconds from epoch (UTC time zone).
- Number of periods at the end of the day.
- An array with different data for each period:
- 3 Periods.
- 6 Periods.
- 12 Periods.
Each of those positions has another array with information regarding that time span:- Instrument Id.
- Correlation between market and trader for that instrument.
- Instrument’s weight towards total position.
- Number of consecutive long positions.
- Number of consecutive short positions.
- Ratio between time with long positions and time of the whole day.
- Ratio between time with short positions and time of the whole day.
- Time percentage, weighted with leverage of long positions.
- Time percentage, weighted with leverage of short positions.
- Time percentage, weighted with leverage of closed positions.
m) MONTHLY_DIVERGENCE
Contains data regarding the average and monthly divergence. Does not contain information about periods:
- Timestamp in milliseconds from epoch (UTC time zone).
- Average divergence.
- Monthly divergence.
n) OPEN_STRATEGY
Similar to the CLOSE_STRATEGY chart, this is a series of values showing the effect of opening a trade with a certain time difference (expressed in percentage). Each line goes as follows:
- Timestamp in milliseconds from epoch (UTC time zone).
- Number of periods at the end of the day.
- [[Optional]] If the trader traded that day, an array with 12 elements. It contains a comparison of the opening time with doing it a certain amount of time before or after. The strategy ranks are added changing percentually the opening time. For example, if a position was closed a 20% later it will rank 3rd, 7th and 5th. So this strategy is 15/3 = 5th average position.
Position in array | Variation | Description |
1 | -- | Number of open trades during the day. |
2 | 0% | Sum of ranks on the real strategy. |
3 | -50% | Sum of ranks opening 50% before. |
4 | -40% | Sum of ranks opening 40% before. |
5 | -30% | Sum of ranks opening 30% before. |
6 | -20% | Sum of ranks opening 20% before. |
7 | -10% | Sum of ranks opening 10% before. |
8 | +10% | Sum of ranks opening 10% after. |
9 | +20% | Sum of ranks opening 20% after. |
10 | +30% | Sum of ranks opening 30% after. |
11 | +40% | Sum of ranks opening 40% after. |
12 | +50% | Sum of ranks opening 50% after. |
o) ORDER_DIVERGENCE
Offers information about detailed divergence per order. It is a set of arrays with the following structure:
- Timestamp in milliseconds from epoch. It is the time when the DARWIN places an order for investors.
- Instrument ID.
- Investors volume in USD.
- Latency.
- Divergence experienced by investors on this order.
p) PERFORMANCE
This one contains data about the DARWIN’s profit compared to that of several random strategies, simulated during several time ranges: 3 periods, 6 periods and 12 periods. The data contains:
- Timestamp in milliseconds from epoch. It is the time when the DARWIN places an order for investors.
- Number of periods.
- An array with the following data for the day.
- Number of positions in the day.
- An array with data for 3 periods.
- An array with data for 6 periods.
- An array with data for 12 periods.
All of the arrays above hold the following information:- The percentile where the current strategy belongs.
- Profit in the current strategy time window.
- Simulation profits. This is also an array with elements for each percentile.
- Profit in percentile 99
- Profit in percentile 95
- Profit in percentile 90
- Profit in percentile 80
- Profit in percentile 70
- Profit in percentile 60
- Profit in percentile 50
- Profit in percentile 40
- Profit in percentile 30
- Profit in percentile 20
- Profit in percentile 10
- Profit in percentile 5
- Profit in percentile 1
- Activity (This field is usually null): The number of days with activity and without anomalies.
q) POSITIONS
Offers information about positions every day:
- Timestamp in milliseconds from epoch. It is the time when the DARWIN places an order for investors.
- Number of periods
- An array with aggregated data in the day per open instruments in that moment. That means it could have an array for “EURUSD+GBPJPY+XAUUSD” and another one only for “EURUSD”.
- Array with the following:
- Instrument ID
- Number of positions
- Number of winning positions
- Number of losing positions
- Performance of winning positions
- Performance of losing positions
- Duration of winning positions
- Duration of losing positions
- Total position number
- Max number of open trades
- Array with the following:
r) RETURN
This chart contains information regarding profitability. The structure has the following pattern:
Timestamp in milliseconds from epoch. It is the time when the DARWIN places an order for investors.- Number of periods
- An array with profitability info in key moments:
- First return of the day
- From position 2 up to N-1 → [Optional] A series of points used to calculate drawdown.
- [Optional] In the last position of the array we will find the last return of the day.
s) RETURN_DIVERGENCE
Here you will find information regarding the DARWIN’s divergence. It contains:
- Timestamp in milliseconds from epoch. It is the time when the DARWIN places an order for investors.
- DARWIN’s quote in this moment.
- DARWIN's quote after applying real divergence.
t) RISK_ADJUSTMENT
Contains information about the amount of risk adjustment applied to the strategy. The structure:
- Timestamp in milliseconds from epoch. It is the time when the DARWIN places an order for investors.
- Number of periods
- An array with risk adjustment information. Each element contains
- Default Leverage Target. It can be null if it is not available.
- Normalized daily VaR.
- A set of data for each position:
- Time of the adjustment in milliseconds
- Duration
- D-Leverage
- VaR adjustment
- Number of simultaneous trades
- Position profitLeverage on the day it was opened
u) RISK_STABILITY
Information about the VaR variability or stability within the strategy. The chart includes:
- Timestamp in milliseconds from epoch. It is the time of the DARWIN actuation.
- Number of periods.
- An array with VaR information. Each position contains:
- Current VaR.
- Max VaR.
- Min VaR.
- Normalized current VaR.
- Normalized max VaR.
- Normalized min VaR.
- Return.
v) ROTATION
Contains information about daily rotation. Contains a value for each day with the following data:
- Timestamp in milliseconds from epoch. It is the time of the strategy actuation.
- Number of periods
- Daily rotation
w) SCALABILITY
This chart offers data for several capacity graphs shown on the web, structured as follows:
- Timestamp in milliseconds from epoch. It is the time of the strategy actuation.
- Number of periods
- An array with scalability information. Each position has:
- An array containing how the quotes would look like with some hypothetical spread increases:
- Original quote value
- 0.00002 ( +0.2 spread pips)
- 0.00005 ( +0.5 spread pips)
- 0.0001 ( +1.0 spread pips)
- 0.0002 ( +2.0 spread pips)
- Max allowed divergence. That means, the spread that, when added, makes the investor’s profit lower than 98.5% the DARWIN’s profit.
- Average leverage per trade.
- Volume without leverage.
- An array containing how the quotes would look like with some hypothetical spread increases:
x) TRADE_CONSISTENCY
Shows information regarding the results of a group of trades per day.
- Timestamp in milliseconds from epoch. It is the time when the underlying strategy trades.
- Number of periods
- An array showing information about the last 100 closed trades during the day, with the following data per trade:
- Open time.
- Duration.
- Return.
- VaR.
- Leverage.
y) TRADE_LOSS_AVERSION
Shows how the profits or losses would have changed in the best and worst case scenario for a DARWIN. There is a twin chart TRADE_UNADJUSTED_LOSS_AVERSION that does not take into account the VaR and leverage adjustments.
- Timestamp in milliseconds from epoch. It is the time when the underlying strategy trades.
- Number of periods
- An array showing information about the last 100 closed trades during the day, with the following data per trade:
- Instrument ID.
- Start time in milliseconds.
- Max benefit the trader could have gotten if the trade had been close before.
- Min benefit the trader could have gotten if the trada had been closed before.
- The actual benefit the trade got if it was closed or the benefit it would get right now if it is still open.
- “true” if the trade is still open, “null” otherwise.
z) TRADES
Gives information about the result of closed trades, aggregated by instrument:
- Timestamp in milliseconds from epoch. It is the time of the strategy’s trades.
- Number of periods.
- An array with aggregated information about trades grouped by instrument.
- Instrument ID.
- Number of trades.
- Number of winning trades.
- Number of losing trades.
- Profitability of winning trades (will be 1 if there are no trades).
- Profitability of losing trades (will be 1 if there are no trades).
- Duration of winning trades (will be 0 if there are no trades).
- Duration of losing trades (will be 0 if there are no trades)
aa) TRADE_UNADJUSTED_LOSS_AVERSION
Similar to TRADE_LOSS_AVERSION but applied to the underlying strategy instead of the DARWIN. So this chart uses trades without VaR or leverage adjustments. It shows how the profits or losses of certain trades would have changed in the best and worst moments to close. It contains information for up to 100 trades per day:
- Timestamp in milliseconds from epoch. It is the time of the strategy’s trades.
- Number of periods
- An array showing information about the last 100 closed trades during the day, with the following data per trade:
- Instrument ID.
- Start time in milliseconds.
- Max benefit the trader could have gotten if the trade had been close before.
- Min benefit the trader could have gotten if the trada had been closed before.
- The actual benefit the trade got if it was closed or the benefit it would get right now if it is still open.
- “true” if the trade is still open, “null” otherwise.
ab) WINNING_CONSISTENCY
Analogous to the LOSING_CONSISTENCY chart, but this time using just winning trades and limited to 50 trades. Contents are also equal to the other chart:
- Timestamp in milliseconds from epoch (UTC time zone).
- Number of periods at the end of the day.
- An array with data about the last 50 winning positions in that day. It could be an empty array if there are no operations. Each position has:
- Start time of the position expressed in milliseconds from epoch.
- Position lifespan in milliseconds.
- Gross profit of the position.
- VaR at the start of the day on that position.
- Leverage at the start of the position.
ac) INVESTMENT_CHART
This chart shows information about how much money has been invested into the DARWIN. The contents are very simple:
- Timestamp in milliseconds from epoch (UTC time zone).
- Amount of money invested.
ad) INVESTORS_CHART
This one is similar to the INVESTMENT_CHART. This time instead of focusing on how much money has been invested, we show how many investors have invested money in the DARWIN. Again very simple contents:
- Timestamp in milliseconds from epoch (UTC time zone).
- Amount of investors with investment in the DARWIN.