API Methods - Item Price Information
This method is indended for apps that want the simple data: price of an item. In most cases you'll want the median, as the true average is skewed heavily on some items by outlier orders.
By default, all trading regions are considered in this request. Optionally, additional regions can be selected individually by region ID.
The optinal parameter min_quantity specifies the minimum amount of items which needs to be available. This is useful to check which price needs to be paid to buy a specific amount of items.
Multiple items can be selected with this request.
Parameters
Optional
- region_ids - Command-seperated list of region IDs
- min_quantity - Limit orders considered by filtering by minimum quantity (overrides EM's own filters)
- key - Developer key for authentication and tracking
- callback - JSON format only, specifies a JSONP callback method for the data to be wrapped in
Required
- type_ids - Comma-seperated list of type IDs
Use Case: Google Docs Spreadsheet
If you wanted to load the mineral buy prices into a Google Docs spreadsheet, you could use the following line to do so:
=ImportXML("http://www.eve-metrics.com/api/item.xml?type_ids=34,35,36,37,38,39,40", "/evemetrics/type/global/buy/average")
This will select the average buy price for each of the minerals for use in your calculations.
Return Values
- min - minimum price, after filtering
- max - maximum price, after filtering
- median - median price, after filtering
- avg - average price, after filtering, weighted by available volume
- kurtosis - kurtosis of prices, after filtering, weighted by available volume
- skew - skew of prices, after filtering, weighted by available volume
- variance - variance of prices, after filtering, weighted by available volume
- standard_deviation - standard deviation of prices, after filtering, weighted by available volume
- simulated - estimated price paid per unit for buying 5% of the volume on the market or fulfilling 5% of sell orders on the market, after order filtering, weighted by available volume.
Note that if there are insufficient numbers of orders to calculate a simulated result with any degree of accuracy, the API will provide the average price as a simulated result.
Example URIs
Click through to each URI to see the returned XML/JSON.
- /api/item.xml?type_ids=34 - single type, global statistics, XML format
- /api/item.json?type_ids=34 - single type, global statistics, JSON format
- /api/item.json?type_ids=34&callback=setPrice - single type, global statistics, JSONP format using callback function setPrice
- /api/item.xml?type_ids=34,35 - multiple types, global statistics
- /api/item.xml?type_ids=34®ion_ids=10000032 - single type, global statistics and Sinq Laison statistics
- /api/item.xml?type_ids=34&min_quantity=0 - single type, global statistics, unfiltered