More actions
mNo edit summary |
Finshed the market endpoint. |
||
| Line 75: | Line 75: | ||
'''Endpoint''': /market/<region_id>/types/<type_id>/history/ | '''Endpoint''': /market/<region_id>/types/<type_id>/history/ | ||
'''Possible Applications''': | '''Usage''': This endpoint returns records of high/low and average prices of the item that matches <type_id> for the region which matches <region_id> for all days since a year from the day before you made the request. There is no system-wise or station wise options for the market endpoint at this time. Note that the records on items for the day which the request was made are populated with information for the previous day, as the API only allows you to get real data from the day before the day you made the request and before. | ||
The result code contains the following JSON variables: | |||
*'''totalCount_str''': The ''totalCount_str'' variable contains the amount of entries that are available for the item in question, as a string. (Ex: "totalCount_str":"353") | |||
*'''items''': The ''items'' variable contains the actual JSON Array of entries of the item's market data. This is usually what you want to grab information from when you access this endpoint. This array contains X amount of entries, where X = ''totalCount''. Each entry has seven variables, which are listed below: | |||
**'''avgPrice''': The ''avgPrice'' variable contains the average price of the item you looked for for the date that is contained within this entry's ''date'' variable. | |||
**'''date''': The ''date'' variable contains the date for which the information in that particular entry is relevant. In other words, the value of avgPrice is the actual average price for the item you looked for on the date noted by the ''date'' variable. It is in the format '''yyyy-MM-ddThh:mm:ss''', where '''hh:mm:ss''' is always 00:00:00 Eve Time (UTC). | |||
**'''highPrice''': The ''highPrice'' variable, as its name suggests, contains the value of the highest price the item you looked for achieved on the date for which the entry is relevant. | |||
**'''lowPrice''': The ''lowPrice'' variable, as its name suggests, contains the value of the lowest price the item you looked for achieved on the date for which the entry is relevant. | |||
**'''orderCount''': The ''orderCount'' variable represents the total amount of orders (buy and sell) for the item you looked for on the date for which this entry is relevant. | |||
**'''orderCount_str''': The value represented by the ''orderCount'' variable, as a string. | |||
**'''volume''': The ''volume'' variable represents the total volume (items moved, bought and sold) for the item you looked for on the date for which this entry is relevant. | |||
**'''volume_str''': The value represented by the ''volume'' variable, as a string. | |||
'''Possible Applications''': Possible applications for this endpoint include market analysis to predict movement of item(s). With some work, you can predict when an item will be at it's lowest value over a period of time, invest in said item and then sell when the item is highest. The aforementioned is just an example of what you can do. | |||