More actions
No edit summary |
m Reverted edit by Rika Nipah Nanodesu (talk) to last revision by Evon R'al Tag: Rollback |
||
| (8 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
{{ | {{Deprecated|Use [https://www.fuzzwork.co.uk/ Fuzzworks] or [https://evetycoon.com/ EVETycoon]}} | ||
Out-of-game EVE data access is provided by CCP through the [[EVE Swagger Interface]]. However, this access method is not convenient for casual use. | Out-of-game EVE data access is provided by CCP through the [[EVE Swagger Interface]] (ESI). However, this access method is not convenient for casual use. Fortunately, third-party services have arisen to provide better access for the casual player. EVE Market data can be accessed through an API provided by [https://api.evemarketer.com/ec/ EVEMarketer]. This service replaces a previous service provided by the defunct EVE Central. EVEMarketer API access methods are very similar to those used by EVE Central but different enough that previous calls will not work. These API calls can be used in a spreadsheet (e.g., Google Sheets, Excel) to provide programmatic access to Market Data even for casual users. | ||
== API Call construction == | == API Call construction == | ||
[https://api.evemarketer.com/ec/ EVEMarketer] provides an endpoint accepting POST or GET methods and returns data in either XML (/marketstat) or JSON (/marketstat/json) formats. The call requires an item identifier (typeID) and has optional parameters to limit data to either a system (usesystem) or a region (regionlimit). A single call can contain up to 200 different items. By default, the data returned is XML and for all of Singularity. The following method describes how to use the GET access method. The GET call method produces a URL that can be directly entered into a web browser to provide data without any additional tools or knowledge. Users interested in the POST method should be able to construct the request given the GET method construction. | [https://api.evemarketer.com/ec/ EVEMarketer] provides an endpoint accepting POST or GET methods and returns data in either XML (/marketstat) or JSON (/marketstat/json) formats. The call requires an item identifier (typeID) and has optional parameters to limit data to either a system (usesystem) or a region (regionlimit). A single call can contain up to 200 different items. By default, the data returned is XML and for all of Singularity. The following method describes how to use the GET access method. The GET call method produces a URL that can be directly entered into a web browser to provide data without any additional tools or knowledge. Users interested in the POST method should be able to construct the request given the GET method construction. | ||
| Line 17: | Line 16: | ||
=== Obtaining the typeID === | === Obtaining the typeID === | ||
TypeIDs are unique identifiers specifying an item. There are several ways to get access to this information. Here are a few: | TypeIDs are unique identifiers specifying an item. There are several ways to get access to this information. Here are a few: | ||
* [https://www.fuzzwork.co.uk/resources/typeids.csv | * Use CCP's ESI site. See [[How to get ID]] for details. | ||
* [https://www.fuzzwork.co.uk/tools/api-typename-to-typeid/ | * Fuzzworks hosts a [https://www.fuzzwork.co.uk/resources/typeids.csv csv] containing all typeIDs and item names | ||
* Fuzzworks hosts an [https://www.fuzzwork.co.uk/tools/api-typename-to-typeid/ API lookup for item names] | |||
* Most websites providing EVE Market data use typeid to reference the specific examples ([https://evemarketer.com/types/215 EVE Marketer for Iron Charge S]) | * Most websites providing EVE Market data use typeid to reference the specific examples ([https://evemarketer.com/types/215 EVE Marketer for Iron Charge S]) | ||
| Line 26: | Line 26: | ||
The other two parameters, systemID and regionID are also unique identifiers specifying a singular region or solar system in EVE. There are several ways to access this information. Here are a few: | The other two parameters, systemID and regionID are also unique identifiers specifying a singular region or solar system in EVE. There are several ways to access this information. Here are a few: | ||
* [https://www.adam4eve.eu/info_locations.php | * Use CCP's ESI site. See [[How to get ID]] for details. | ||
* Adam4EVE hosts a [https://www.adam4eve.eu/info_locations.php list] | |||
* [https://docs.google.com/spreadsheets/d/1HkBZ_KvCYQeFf3awm91fmoPdHTBWugvVKpcwZUv7gXM Google Docs Spreadsheet] | * [https://docs.google.com/spreadsheets/d/1HkBZ_KvCYQeFf3awm91fmoPdHTBWugvVKpcwZUv7gXM Google Docs Spreadsheet] | ||
* EVEMarketer can specify specific regions or systems. The identifier is available in the url.(Example: [https://evemarketer.com/regions/10000043/types/215 Iron Charge S in Domain]) | * EVEMarketer can specify specific regions or systems. The identifier is available in the url.(Example: [https://evemarketer.com/regions/10000043/types/215 Iron Charge S in Domain]) | ||
| Line 40: | Line 41: | ||
The returned data object contains Market Order information for both Buy and Sell orders. The relevant fields available are: | The returned data object contains Market Order information for both Buy and Sell orders. The relevant fields available are: | ||
* volume: Volume of buy or sell orders | * volume: Volume of buy or sell orders | ||
* avg: Average buy or sell | * avg: Average buy or sell price | ||
* max: Maximum buy or sell | * max: Maximum buy or sell price | ||
* min: Minimum buy or sell | * min: Minimum buy or sell price | ||
* stddev: Standard deviation of buy or sell | * stddev: Standard deviation of buy or sell prices | ||
* median: Median buy or sell | * median: Median buy or sell price | ||
* percentile: 95th percentile buy or sell | * percentile: 95th percentile buy or sell price | ||