-
Notifications
You must be signed in to change notification settings - Fork 2
HT_TRENDLINE
essegisolutions edited this page Jan 13, 2018
·
8 revisions
This API returns the Hilbert transform, instantaneous trendline (HT_TRENDLINE) values. The related REST API documentation is here
The very first thing to do before diving into HT_TRENDLINE calls is to include the right namespace.
using Avapi.AvapiHT_TRENDLINE
The HT_TRENDLINE object is retrieved from the Connection object.
The snippet below shows how to get the Connection object:
...
IAvapiConnection connection = AvapiConnection.Instance
connection.Connect("Your Alpha Vantage API Key !!!!");
...
Once you got the Connection object you can extract the HT_TRENDLINE from it.
...
Int_HT_TRENDLINE httrendline =
connection.GetQueryObject_HT_TRENDLINE();
To perform a HT_TRENDLINE request you have 2 options:
- The request with constants:
IAvapiResponse_HT_TRENDLINE Query(string symbol,
HT_TRENDLINE_interval interval,
HT_TRENDLINE_series_type series_type);
- The request without constants:
IAvapiResponse_HT_TRENDLINE QueryPrimitive(string symbol,
string interval,
string series_type);
To perform an HT_TRENDLINE asynchronous request you have 2 options:
- The request with constants:
async Task<IAvapiResponse_HT_TRENDLINE> QueryAsync(string symbol,
HT_TRENDLINE_interval interval,
HT_TRENDLINE_series_type series_type);
- The request without constants:
async Task<IAvapiResponse_HT_TRENDLINE> QueryAsync(string symbol,
string interval,
string series_type);
The parameters below are needed to perform the HT_TRENDLINE request.
- symbol: The name of the equity
- interval: The time interval between two consecutive data points in the time series.
- series_type: The price type in the time series. The types supported are: close, open, high, low
Please notice that the info above are copied from the official alphavantage documentation, that you can find here.
The request with constants implies the use of different enums:
- HT_TRENDLINE_interval
- HT_TRENDLINE_series_type
HT_TRENDLINE_interval: The time interval between two consecutive data points in the time series.
public enum HT_TRENDLINE_interval
{
none,
n_1min,
n_5min,
n_15min,
n_30min,
n_60min,
daily,
weekly,
monthly
}
HT_TRENDLINE_series_type: The price type in the time series. The types supported are: close, open, high, low
public enum HT_TRENDLINE_series_type
{
none,
close,
open,
high,
low
}
The response of a HT_TRENDLINE request is an object that implements the IAvapiResponse_HT_TRENDLINE interface.
public interface IAvapiResponse_HT_TRENDLINE
{
string RawData
{
get;
}
IAvapiResponse_HT_TRENDLINE_Content Data
{
get;
}
}
The IAvapiResponse_HT_TRENDLINE interface has two members: RawData and Data.
- RawData: represents the json response in string format.
- Data: It represents the parsed response in an object implementing the interface IAvapiResponse_HT_TRENDLINE_Content.
Complete Example of a Console App: Display the result of a HT_TRENDLINE request by using the method Query (synchronous request)
using System;
using System.IO;
using Avapi.AvapiHT_TRENDLINE;
namespace Avapi
{
public class Example
{
static void Main()
{
// Creating the connection object
IAvapiConnection connection = AvapiConnection.Instance;
// Set up the connection and pass the API_KEY provided by alphavantage.co
connection.Connect("Your Alpha Vantage API Key !!!!");
// Get the HT_TRENDLINE query object
Int_HT_TRENDLINE ht_trendline =
connection.GetQueryObject_HT_TRENDLINE();
// Perform the HT_TRENDLINE request and get the result
IAvapiResponse_HT_TRENDLINE ht_trendlineResponse =
ht_trendline.Query(
"MSFT",
Const_HT_TRENDLINE.HT_TRENDLINE_interval.n_1min,
Const_HT_TRENDLINE.HT_TRENDLINE_series_type.close);
// Printout the results
Console.WriteLine("******** RAW DATA HT_TRENDLINE ********");
Console.WriteLine(ht_trendlineResponse.RawData);
Console.WriteLine("******** STRUCTURED DATA HT_TRENDLINE ********");
var data = ht_trendlineResponse.Data;
if (data.Error)
{
Console.WriteLine(data.ErrorMessage);
}
else
{
Console.WriteLine("Symbol: " + data.MetaData.Symbol);
Console.WriteLine("Indicator: " + data.MetaData.Indicator);
Console.WriteLine("LastRefreshed: " + data.MetaData.LastRefreshed);
Console.WriteLine("Interval: " + data.MetaData.Interval);
Console.WriteLine("SeriesType: " + data.MetaData.SeriesType);
Console.WriteLine("TimeZone: " + data.MetaData.TimeZone);
Console.WriteLine("========================");
Console.WriteLine("========================");
foreach (var technical in data.TechnicalIndicator)
{
Console.WriteLine("HT_TRENDLINE: " + technical.HT_TRENDLINE);
Console.WriteLine("DateTime: " + technical.DateTime);
Console.WriteLine("========================");
}
}
}
}
}
Complete Example of a Windows Form App: Display the result of a HT_TRENDLINE request by using the method QueryAsync (asynchronous request)
using Avapi;
using Avapi.AvapiHT_TRENDLINE
using System;
using System.Windows.Forms;
namespace WindowsFormsApp1
{
public partial class Form1 : Form
{
private IAvapiConnection m_connection = AvapiConnection.Instance;
private Int_HT_TRENDLINE m_ht_trendline;
private IAvapiResponse_HT_TRENDLINE m_ht_trendlineResponse;
public Form1()
{
InitializeComponent();
}
protected override void OnLoad(EventArgs e)
{
// Set up the connection and pass the API_KEY provided by alphavantage.co
m_connection.Connect("Your Alpha Vantage Key");
// Get the HT_TRENDLINE query object
m_ht_trendline = m_connection.GetQueryObject_HT_TRENDLINE();
base.OnLoad(e);
}
private async void HT_TRENDLINEAsyncButton_Click(object sender, EventArgs e)
{
// Perform the HT_TRENDLINE request and get the result
m_ht_trendlineResponse =
await m_ht_trendline.QueryAsync(
"MSFT",
Const_HT_TRENDLINE.HT_TRENDLINE_interval.n_1min,
Const_HT_TRENDLINE.HT_TRENDLINE_series_type.close);
// Show the results
resultTextBox.AppendText("******** RAW DATA HT_TRENDLINE ********" + "\n");
resultTextBox.AppendText(m_ht_trendlineResponse.RawData + "\n");
resultTextBox.AppendText("******** STRUCTURED DATA HT_TRENDLINE ********" + "\n");
var data = m_ht_trendlineResponse.Data;
if (data.Error)
{
resultTextBox.AppendText(data.ErrorMessage + "\n");
}
else
{
resultTextBox.AppendText("Symbol: " + data.MetaData.Symbol + "\n");
resultTextBox.AppendText("Indicator: " + data.MetaData.Indicator + "\n");
resultTextBox.AppendText("LastRefreshed: " + data.MetaData.LastRefreshed + "\n");
resultTextBox.AppendText("Interval: " + data.MetaData.Interval + "\n");
resultTextBox.AppendText("SeriesType: " + data.MetaData.SeriesType + "\n");
resultTextBox.AppendText("TimeZone: " + data.MetaData.TimeZone + "\n");
resultTextBox.AppendText("========================" + "\n");
resultTextBox.AppendText("========================" + "\n");
foreach (var technical in data.TechnicalIndicator)
{
resultTextBox.AppendText("HT_TRENDLINE: " + technical.HT_TRENDLINE + "\n");
resultTextBox.AppendText("DateTime: " + technical.DateTime + "\n");
resultTextBox.AppendText("========================" + "\n");
}
}
}
}
}