Published using Google Docs
Volatility Analysis Web Component and API
Updated automatically every 5 minutes

Volatility Analysis (Power Stats) Widget

Webapp Configuration

The following optional query parameters can be provided to configure the webapp directly via the URL parameters:

Example URL: /va/results?broker_id=24&timezone=Africa%2FJohannesburg&locale=en

API Request Authentication

All API requests can be authenticated by passing along an MD5 authentication token.The 403 HTTP status code is returned when authentication has failed (due to unauthorized access to a resource).

The following HTTP url query parameters are required and should be sent with every request for authentication:

RESTful Web API Endpoints

This describes the resources that make up the va-widget API.

All data is sent and received as JSON.

All timestamps are returned in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

Results Resources

GET results/trumpet_results

Description

Returns latest power stats results for a specific broker. The power stats results are cached with 5 minutes interval.


Requires authentication


Parameters


Return format


Errors


Example

Request

GET resources/results/trumpet_results?broker_id=24&locale=en&timezone=Africa/Johannesburg

Return shortened for example purpose

{

  "date": "2016-09-02T07:30:52.434Z",

  "query": {

    "symbols": [

      "NZDCAD",

      "EURNZD",

      "EURCHF",

      "HKDJPY",

      "USDJPY",

      "CADCHF",

      "EURUSD",

      "USDKRW",

      ".US30",

      "GBPUSD",

      "NZDCHF",

      "AUDHKD",

      "EURTRY",

      "USDSEK",

      "AUDCAD",

      "GBPJPY",

      "ZL",

      "ZM",

      "CRD",

      ".JP225",

      "USDNOK",

      "NG",

      "EURZAR",

      "EURAUD",

      "XAUUSD",

      "USDCAD",

      "NZDUSD",

      "EURCZK",

      "RR",

      ".F40",

      "GBPEUR",

      "USDDKK",

      "C",

      "EURSEK",

      "USDHKD",

      ".HK40",

      "USDTRY",

      "SGDJPY",

      "AUDCHF",

      "O",

      "AUDNZD",

      "S",

      "EURCAD",

      "W",

      "USDZAR",

      "KC",

      "OJ",

      "GBPCAD",

      "CHFJPY",

      "USDMXN",

      "EURGBP",

      "EURPLN",

      ".UK100",

      "GBPCHF",

      "EURJPY",

      ".DE30",

      "CADJPY",

      "EURHUF",

      "USDCHF",

      "GBPNZD",

      "AUDUSD",

      "GBPAUD",

      "NZDJPY",

      ".USTEC",

      "USDSGD",

      "XAGUSD",

      ".US500",

      "AUDJPY",

      "PL",

      "HG"

    ],

    "day_of_week": 5,

    "from_time": 450,

    "symbol_id": 0,

    "page_limit": 0,

    "page_offset": 0

  },

  "returnSymbols": [

    "EURCZK",

    "NZDCAD",

    "NZDUSD",

    "USDDKK",

    "EURNZD",

    "EURSEK",

    "USDHKD",

    "USDTRY",

    "AUDCHF",

    "SGDJPY",

    "EURCHF",

    "HKDJPY",

    "AUDNZD",

    "USDJPY",

    "CADCHF",

    "EURCAD",

    "EURUSD",

    "USDKRW",

    "USDZAR",

    "CHFJPY",

    "GBPCAD",

    "GBPUSD",

    "USDMXN",

    "EURGBP",

    "EURPLN",

    "EURJPY",

    "GBPCHF",

    "CADJPY",

    "EURHUF",

    "USDCHF",

    "NZDCHF",

    "AUDHKD",

    "EURTRY",

    "GBPNZD",

    "AUDCAD",

    "USDSEK",

    "AUDUSD",

    "GBPJPY",

    "GBPAUD",

    "NZDJPY",

    "USDSGD",

    "XAGUSD",

    "USDNOK",

    "AUDJPY",

    "EURZAR",

    "EURAUD",

    "XAUUSD",

    "USDCAD"

  ],

  "page": {

    "number": 1,

    "limit": 20,

    "offset": 0,

    "total_items": 48,

    "total_pages": 3,

    "links": [

      {

        "rel": "first",

        "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&page_offset=0&locale=en&user=Direct&token=1447ac6a738d448043594c79d676b0fc",

        "display": "<<",

        "enabled": false

      },

      {

        "rel": "prev",

        "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&page_offset=0&locale=en&user=Direct&token=1447ac6a738d448043594c79d676b0fc",

        "display": "<",

        "enabled": false

      },

      {

        "rel": "pages[0]",

        "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&page_offset=0&locale=en&user=Direct&token=1447ac6a738d448043594c79d676b0fc",

        "display": "1",

        "enabled": false,

        "active": true

      },

      {

        "rel": "pages[1]",

        "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&page_offset=20&locale=en&user=Direct&token=1447ac6a738d448043594c79d676b0fc",

        "display": "2",

        "enabled": true,

        "active": false

      },

      {

        "rel": "pages[2]",

        "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&page_offset=40&locale=en&user=Direct&token=1447ac6a738d448043594c79d676b0fc",

        "display": "3",

        "enabled": true,

        "active": false

      },

      {

        "rel": "next",

        "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&page_offset=20&locale=en&user=Direct&token=1447ac6a738d448043594c79d676b0fc",

        "display": ">",

        "enabled": true

      },

      {

        "rel": "last",

        "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&page_offset=40&locale=en&user=Direct&token=1447ac6a738d448043594c79d676b0fc",

        "display": ">>",

        "enabled": true

      }

    ]

  },

  "items": [

    {

      "new": false,

      "data": {

        "datetime": "2016-09-02T13:37:37.953Z",

        "result_uid": 0,

        "broker_id": 24,

        "symbol": "AUDCAD",

        "symbol_id": 866761,

        "day_of_week": 5,

        "from_time": 210,

        "closing_price": 0.98898,

        "low_15": 0.9881,

        "high_15": 0.9899,

        "low_30": 0.988,

        "high_30": 0.99,

        "low_60": 0.9876,

        "high_60": 0.9903,

        "low_240": 0.9867,

        "high_240": 0.9912,

        "low_1440": 0.9832,

        "high_1440": 0.9947,

        "timezone_offset": -4,

        "timezone": "America/New_York"

      },

      "links": [

        {

          "rel": "detail",

          "href": "http://ssltest.autochartist.com/va/resources/results/detail/%5Bpricerangeforecast,%20hourlymovement,%20dailymovement%5D/866761?broker_id=24"

        },

        {

          "rel": "chart-xs-pricerangeforecast",

          "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results/../../charts/pricerangeforecast-866761.png?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&width=600&time_zone_offset=-4&locale=en&locale=en&user=Direct&from_time=210&symbol_id=866761&token=1447ac6a738d448043594c79d676b0fc&height=320&day_of_week=5"

        },

        {

          "rel": "chart-sm-pricerangeforecast",

          "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results/../../charts/pricerangeforecast-866761.png?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&width=600&time_zone_offset=-4&locale=en&locale=en&user=Direct&from_time=210&symbol_id=866761&token=1447ac6a738d448043594c79d676b0fc&height=320&day_of_week=5"

        },

        {

          "rel": "chart-md-pricerangeforecast",

          "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results/../../charts/pricerangeforecast-866761.png?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&width=600&time_zone_offset=-4&locale=en&locale=en&user=Direct&from_time=210&symbol_id=866761&token=1447ac6a738d448043594c79d676b0fc&height=450&day_of_week=5"

        },

        {

          "rel": "chart-lg-pricerangeforecast",

          "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results/../../charts/pricerangeforecast-866761.png?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&width=600&time_zone_offset=-4&locale=en&locale=en&user=Direct&from_time=210&symbol_id=866761&token=1447ac6a738d448043594c79d676b0fc&height=540&day_of_week=5"

        },

        {

          "rel": "chart-xs-hourlymovement",

          "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results/../../charts/hourlymovement-866761.png?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&width=600&time_zone_offset=-4&locale=en&locale=en&user=Direct&from_time=210&symbol_id=866761&token=1447ac6a738d448043594c79d676b0fc&height=320&day_of_week=5"

        },

        {

          "rel": "chart-sm-hourlymovement",

          "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results/../../charts/hourlymovement-866761.png?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&width=600&time_zone_offset=-4&locale=en&locale=en&user=Direct&from_time=210&symbol_id=866761&token=1447ac6a738d448043594c79d676b0fc&height=320&day_of_week=5"

        },

        {

          "rel": "chart-md-hourlymovement",

          "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results/../../charts/hourlymovement-866761.png?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&width=600&time_zone_offset=-4&locale=en&locale=en&user=Direct&from_time=210&symbol_id=866761&token=1447ac6a738d448043594c79d676b0fc&height=450&day_of_week=5"

        },

        {

          "rel": "chart-lg-hourlymovement",

          "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results/../../charts/hourlymovement-866761.png?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&width=600&time_zone_offset=-4&locale=en&locale=en&user=Direct&from_time=210&symbol_id=866761&token=1447ac6a738d448043594c79d676b0fc&height=540&day_of_week=5"

        },

        {

          "rel": "chart-xs-dailymovement",

          "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results/../../charts/dailymovement-866761.png?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&width=600&time_zone_offset=-4&locale=en&locale=en&user=Direct&from_time=210&symbol_id=866761&token=1447ac6a738d448043594c79d676b0fc&height=320&day_of_week=5"

        },

        {

          "rel": "chart-sm-dailymovement",

          "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results/../../charts/dailymovement-866761.png?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&width=600&time_zone_offset=-4&locale=en&locale=en&user=Direct&from_time=210&symbol_id=866761&token=1447ac6a738d448043594c79d676b0fc&height=320&day_of_week=5"

        },

        {

          "rel": "chart-md-dailymovement",

          "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results/../../charts/dailymovement-866761.png?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&width=600&time_zone_offset=-4&locale=en&locale=en&user=Direct&from_time=210&symbol_id=866761&token=1447ac6a738d448043594c79d676b0fc&height=450&day_of_week=5"

        },

        {

          "rel": "chart-lg-dailymovement",

          "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results/../../charts/dailymovement-866761.png?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&width=600&time_zone_offset=-4&locale=en&locale=en&user=Direct&from_time=210&symbol_id=866761&token=1447ac6a738d448043594c79d676b0fc&height=540&day_of_week=5"

        },

        {

          "rel": "csv-pricerangeforecast",

          "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results/../../charts/2016-09-02_866761_AUDCAD_pricerangeforecast_en_Fri_09h30.csv?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&time_zone_offset=-4&locale=en&locale=en&user=Direct&from_time=210&symbol_id=866761&token=1447ac6a738d448043594c79d676b0fc&day_of_week=5"

        },

        {

          "rel": "csv-hourlymovement",

          "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results/../../charts/2016-09-02_866761_AUDCAD_hourlymovement_en_Fri_09h30.csv?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&time_zone_offset=-4&locale=en&locale=en&user=Direct&from_time=210&symbol_id=866761&token=1447ac6a738d448043594c79d676b0fc&day_of_week=5"

        },

        {

          "rel": "csv-dailymovement",

          "href": "http://ssltest.autochartist.com/va/resources/results/trumpet_results/../../charts/2016-09-02_866761_AUDCAD_dailymovement_en_Fri_09h30.csv?account_type=LIVE&broker_id=24&timezone=Africa/Johannesburg&time_zone_offset=-4&locale=en&locale=en&user=Direct&from_time=210&symbol_id=866761&token=1447ac6a738d448043594c79d676b0fc&day_of_week=5"

        }

      ]

    },

Chart Resources

GET charts/powerstatsprojection-{symbolid}.png

Description

Returns latest power stats projection chart for a specific broker-symbol combination. The chart requires 2 sets of input data, namely the Power Stats trumpet data to determine the high and low price values for each time interval (1 hour, 4 hour, Daily) and the Price Graph data to display the last set of candles for the instrument.

The results are cached at every 5 minutes interval.


Requires authentication


Parameters


Return format

Image in image/png format.


Errors


Example

Request

GET charts/powerstatsprojection-866791.png?broker_id=24&from_time=660&day_of_week=4&symbol_id=866761&hourly_symbol_id=866791&width=600&height=320&timezone=America/New_York&time_zone_offset=-4&locale=en

Return - chart image for the power stats projection.

GET charts/pricerangeforecast-{symbolid}.png

Description

Returns latest price range forecast (trumpet) chart for a specific broker-symbol combination.

The results are cached at every 5 minutes interval.


Requires authentication


Parameters


Return format

Image in image/png format.


Errors


Example

Request

GET charts/pricerangeforecast-866759.png?broker_id=24&timezone=Africa/Johannesburg&width=600&time_zone_offset=-4&locale=en&locale=en&from_time=555&symbol_id=866759&height=540&day_of_week=1

Return - chart image for the price range forecast (trumpet) result item.

GET charts/dailymovement-{symbolid}.png

Description

Returns latest power stats daily movement chart for a specific symbol.

The results are cached at every 5 minutes interval.


Requires authentication


Parameters


Return format

Image in image/png format.


Errors


Example

Request

GET charts/dailymovement-955557.png?broker_id=24&timezone=Africa/Johannesburg&locale=en&symbol_id=955557&height=500&width=400&day_of_week=3

Return - chart image for the power stats daily movement. The chart shows bars for each day of the week (Sunday - Friday) with a 68% probability of price movement indicated by the bar height for each hour with the average price range superimposed on the bar.

GET charts/hourlymovement-{symbolid}.png

Description

Returns latest power stats hourly movement chart for a specific symbol.

The results are cached at every 5 minutes interval.


Requires authentication


Parameters


Return format

Image in image/png format.


Errors


Example

Request

GET charts/hourlymovement-866759.png?broker_id=24&from_time=555&symbol_id=866759&height=320&day_of_week=1

Return - chart image for the power stats hourly movement. The chart shows bars for each hour of the day (0 - 23) with a 68% probability of price movement indicated by the bar height for each hour with the average price range superimposed on the bar.

Language Resources

GET lang/messages

Description

Returns key/value pairs for translation.


Requires authentication


Parameters


Return format

A JSON object with key/value pairs for translations.


Errors


Example

Request

GET resources/lang/messages?lang=zh-CN

Return shortened for example purpose

{

  "PowerStatsUserMessage": "波动性分析工具提供关于所选金融工具的预期价格范围变化的综合观点。该信息可用于决定在当天的特定时间内应交易哪种工具,以及设定市场的恰当退出水平。",

  "PriceRangeForecast": "价格范围预测",

  "Legend": "説明",

  "Monday": "星期一",

  "PriceMovementRangeByDayOfWeek": "一周每天价格变动范围",

  "Symbol": "合约",

  "DailyMovementBody": "<br><br>对于任何市场参与者来说,对于每周各天特定范围的了解,可应用于入市交易,并且其效果可能随之显现。 每日变动是在24小时基础上计算出来的从高到低范围的一种测量,当天的平均变化在范围中标出。<br><br> 以上图表可以使您深入了解在一周的特定某天市场可能的走向,并且给出有益的资讯以微调您的交易买入。 它也可供业余交易者了解哪些日子最适于交易。<br><br>",

  "HourOfDay": "一日各时刻",

  "DownloadFileCSV": "下载文件(。CSV格式)",

  "ReturnToMainResults": "返回主要結果",

  "HourlyMovementBody": "<br><br>基本交易者及有技巧的交易者同样都需依赖于对每天特定时刻市场范围的了解。 世界上各主要金融中心均对交易时间有其独特的影响。 上述图表的功用在于现在您指尖轻点,即可查阅每小时价格范围的六个月平均数值。<br><br> 每个小时时刻都与世界各地的金融中心有相互关系。 何时您有可能看到某特定金融票据产品的波动,何时一种票据由于缺乏参与者而进入整理阶段,以及何时是最佳交易时间,了解这些信息可以让您看清市场的心理和流动。<br><br>",

  "ViewAnalysis": "查看分析",

  "Saturday": "星期六",

  "At": "At",

  "ExpectedPriceRange": "预期价格范围",

  "Friday": "星期五",

  "Tuesday": "星期二",

  "HighProbability": "高概率(概率68%)",

  "High": "高",

  "DayOfWeek": "一周各天",

  "TimeInterval": "时间间隔",

  "Hour": "时刻点数",

  "ExpectedPriceRangeFor": "预期价格范围",

  "Average": "Average",

  "MovementPerDay": "每天变动",

  "PriceMovementRange": "价格移动范围",

  "PriceMovementAnalysesFor": "的价格变动分析",

  "PriceRangeForecastBody": "<br><br>止损和止盈设置常常是根据极少的经验数据作出的随机选择。 以上图表显示所选定的交易品种在此后15分钟、30分钟、1小时、4小时和24小时内的预期价格范围变动。<br><br>信息针对每天的特定时刻和每周的特定各天来计算,以便为当前市场情形提供最精准的变化预测。<br><br>故而如果您已想好交易期限,使用以上图表帮助您适当地设置止盈止损。<br><br>",

  "MovementPerHour": "每小时变动",

  "PriceMovementRangeByHourOfDay": "一天每小时价格变动范围",

  "ResultsFilter": "结果筛选",

  "VolatilityAnalysisCharts": "波動分析圖表",

  "Thursday": "星期四",

  "Low": "低",

  "Sunday": "星期日",

  "Wednesday": "星期三",

  "Pips": "点数",

  "VolatilityAnalysis": "波动性分析"

}

System Resources

GET  system/status

Description

Returns the power stats refresh results status.


Requires authentication


Parameters


Return format

A JSON object with the following keys:


Errors


Example

Request

GET resources/system/status

Return shortened for example purpose

 {

   "status": "OK"

 }

GET  system/refreshServiceState

Description

Returns the power stats result refresh service state.


Requires authentication


Parameters


Return format

A JSON object with the following keys:


Errors


Example

Request

GET resources/system/refreshServiceState

Return shortened for example purpose

{

  "status": "RUNNING"

}

GET  system/refreshLastRunCheck

Description

Returns the power stats result refresh last run check status.


Requires authentication


Parameters


Return format

A JSON object with the following keys:


Errors


Example

Request

GET resources/system/refreshServiceState

Return shortened for example purpose

{

  "status": "OK"

}