1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
|
/**
* API data is taken from IEX Trading, Morningstar, Coinmarketcap, and News API.
* https://iextrading.com/developer/docs/
* http://www.morningstar.com/
* https://coinmarketcap.com/api/
* https://newsapi.org/docs
*/
#ifndef API_H
#define API_H
#define EMPTY (-999)
#include <stddef.h>
#include <curl/curl.h>
#include <json-c/json_tokener.h>
#include "string-tick.h"
struct info {
char* name; // Name of security (ex. Apple Inc.)
char* symbol; // Symbol of security (ex. AAPL)
double price; // Current price of security in USD (ex. 174.54)
double change_1d, change_7d, change_30d; // Percent change in the past x days (ex. -7.49)
double div_yield; // Percent dividend yield (ex. 1.46)
long marketcap; // Market cap in USD (ex. 890489000000)
long volume_1d; // Volume in shares of security (ex. 33812360)
};
typedef struct info Info;
/**
* Creates and returns an Info object. name and symbol are allocated 64 bytes. the doubles and long are set to EMPTY
* @return Info object
*/
Info* api_info_init(void);
/**
* writefunction for cURL HTTP GET/POST
* stolen from a nice man on stackoverflow
*/
size_t api_string_writefunc(void* ptr, size_t size, size_t nmemb, String* hString);
/**
* If post_field is not NULL, performs a HTTP POST with the given parameters. Otherwise, performs a HTTP GET. Response
* data is stored and returned in a String.
* @param url API url to GET/POST
* @param post_field data needed for POST
* @return NULL if no response from server. Otherwise, String containing data.
*/
String* api_curl_data(char* url, char* post_field);
/**
* Returns a double* containing the current price and yesterday's price of a stock or cryptocurrency.
* [0] = current intraday price
* [1] = last close price
* The function will first query IEX. If no response, it will query Morningstar. If no response, it will query
* Coinmarketcap. If Coinmarketcap returns NULL, the function returns NULL.
* 1. IEX -- NASDAQ/NYSE/NYSEARCA
* 2. Morningstar -- MUTF/OTCMKTS
* 3. Coinmarketcap -- CRYPTO
* @param ticker_name_string security symbol or name to get prices of
* @return price data or NULL if invalid symbol
*/
double* api_get_current_price(const char* ticker_name_string);
/**
* Returns current and yesterday's price of a stock with data from IEX.
* Tested for NASDAQ, NYSE, and NYSEARCA listed stocks/ETFs.
* @param ticker_name_string symbol
* @return price data as defined by api_get_current_price or NULL if invalid symbol
*/
double* iex_get_price(const char* ticker_name_string);
/**
* Returns current and yesterday's price of a mutual fund with data from Morningstar
* Tested for MUTF and OTCMKTS listed securities.
* @param ticker_name_string symbol
* @param offset number of days ago to get price of (0 = today)
* @return price data as defined by api_get_current_price or NULL if invalid symbol
*/
double* morningstar_get_price(const char* ticker_name_string);
/**
* Returns current and yesterday's price of a cryptocurrency with data from Coinmarketcap.
* All cryptocurrencies listed on Coinmarketcap will work.
* @param ticker_name_string symbol
* @return price data as defined by api_get_current_price or NULL if invalid symbol
*/
double* coinmarketcap_get_price(const char* ticker_name_string);
/**
* Returns an array of doubles containing the close price each day in the past 5 years
* @param ticker_name_string symbol
* @return double array of close prices
*/
double* api_get_hist_5y(const char* ticker_name_string);
/**
* Returns an array of doubles containing the close price each day in the past 5 years
* @param ticker_name_string symbol of stock or etf
* @return double array of close prices
*/
double* iex_get_hist_5y(const char* ticker_name_string);
/**
* Returns an array of doubles containing the close price each day in the past 5 years
* @param ticker_name_string symbol of mutf/otcmkts
* @return double array of close prices
*/
double* morningstar_get_hist_5y(const char* ticker_name_string);
/**
* Prints the top three news articles by popularity pertaining to the given string, ticker_name_string. Spaces and
* underscores will be url-encoded (replaced by "%20"). News API will be used for data.
* @param ticker_name_string the string to query
*/
void news_print_top_three(const char* ticker_name_string);
/**
* Prints relevant information about up to three articles given a News API JSON formatted response object. Title, source,
* and URL will always be printed. The URL will be shortened by Google's URL-shortener API. If the author and date
* are specified, those will be printed as well.
* @param jobj the JSON array
*/
void json_print_news(Json* jobj);
/**
* Prints information about the symbol ticker_name_string by calling the function json_print_news.
* @param ticker_name_string
*/
void api_print_info(const char* ticker_name_string);
/**
* Returns a pointer to an Info object containing info pertaining
* to the given symbol with data from IEX.
* @param ticker_name_string stock/etf symbol
* @return Info object
*/
Info* iex_get_info(const char* ticker_name_string);
/**
* Returns a pointer to an Info object containing info pertaining
* to the given symbol with data from Morningstar
* @param ticker_name_string mutf/otc symbol
* @return Info object
*/
Info* morningstar_get_info(const char* ticker_name_string);
/**
* Returns a pointer to an Info object containing info pertaining to the given cryptocurrency from Coinmarketcap.
* @param ticker_name_string the crypto's name
* @return Info object
*/
Info* coinmarketcap_get_info(const char* ticker_name_string);
/**
* Given a url, returns a shorter link using Google's URL-shortener API.
* @param url_string the link to shorten
* @return the shortened link
*/
char* google_shorten_link(const char* url_string);
/**
* Destroys Info object and frees memory. Sets the pointer to the Info to NULL
* @param phInfo the Info to destroy
*/
void api_info_destroy(Info** phInfo);
#endif
|