| Register and Login | Sep 2 18:09 |
Pick your poison
The feature you've all been asking for, dumped market files. These CSV files contain all of our user provided uploads dating back to 1/15/2006. Sure to be a boon to those of you who like lots of data to chew on. Note that this isn't a static price dump of prices for a day; instead its every market log that was uploaded appened end to end (though in-file sorting is not guaranteed).
There are of course some caveats:
The dump files are available here: http://eve-central.com/dumps/. The first tar file in the directory is a combination of the first file set, saving you time vs. downloading it file by file.
We now have a limited set of XML datafeeds available to query pricing information from your own application, killboard, or website. See the upgrade news here. But first, the rules:
You simply make an HTTP GET or POST request to a given URL and read the generated XML document. The following APIs are available, along with query parameters. The query paramaters can be passed in an HTTP GET or POST request.
It is adivsable to set a custom User-Agent header when requesting data to determine the soruce application. We can also add you to the "Applications using EVE-Central" section on our page.
Usage: http://api.eve-central.com/api/marketstat
Purpose: Retrieve aggerate statistics for the items specified.
| Parameter | Usage | Required | Can be specified more than once |
|---|---|---|---|
hours | Statistics from the last X specified hours. | False | False |
typeid | The type ID of the item you are requesting. I.e., 34 for Tritanium. Can be specified more than once | True | True |
minQ | The minimum quantity in an order to consider it for the statistics | False | False |
regionlimit | Restrict statistics to a region. Can be specified more than once. | False | True |
Example: http://api.eve-central.com/api/marketstat?typeid=34&typeid=35®ionlimit=10000002
Usage: http://eve-central.com/api/quicklook
Purpose: Retrieve all of the available market orders, including prices, stations, order IDs, volumes, etc.
| Parameter | Usage | Required | Can be specified more than once |
|---|---|---|---|
typeid | The type ID to be queried | True | False |
sethours | Get orders which have been posted within the last X hours. Defaults to 360 | False | False |
regionlimit | Restrict the view to only show from within the specified region IDs. Can be specified multiple times. | False | True |
usesystem | Restrict the view to the following system only. | False | False |
setminQ | Restrict the view to show only orders above the specified quantity | False | False |
Example: http://api.eve-central.com/api/quicklook?typeid=34
Usage: http://api.eve-central.com/api/evemon
Purpose: Retrieve the median mineral prices in the empire regions in a format digestible by EVEmon.
No parameters supported
Example: http://api.eve-central.com/api/evemon
Usage: http://api.eve-central.com/api/upload_suggest
Purpose: Retrieve a random assortment of not-recently-updated items per region.
| Parameter | Usage | Required | Can be specified more than once |
|---|---|---|---|
region | The region in which to suggest an upload | True | False |
Example: http://api.eve-central.com/api/upload_suggest?region=10000002
If you have any questions or wish for more APIs, send me an e-mail.
We've done some internal URL and system cleanup. These APIs will still work, and many packages support them, but should be considered deprecated. Don't use these for new designs.
See the documentation.Important Notice: Many mail services can't handle the large number of messages delivered by our system. These systems include:
The above addresses are not allowed to subscribe to the list, as a majority of the mail will never reach it, and I don't like to wakeup to a mail queue of 20,000 messages.
Now you can receive every market log uploaded to EVE-Central.com via e-mail, more or less the instant it happens. From there, you can filter it to a script on your e-mail server, or pull it from a POP/IMAP server at your end to process messages. This is probably the most advanced system we offer. It will chew through a lot of bandwidth and storage space, generating potentially hundreds of e-mails per hour.
It is implemented as a mailman mailing list which you can subscribe a special e-mail address to. Don't subscribe your normal e-mail, you WILL regret it. To subscribe, go here: http://lists.stackworks.net/cgi-bin/mailman/listinfo/evec-upload. Note that you will need to confirm your subscription, so if you have a mail eating script, turn it off when you first subscribe so you can receive the confirmation key. From there, the mailing list will forward you all upload messages. The first relevant line of data is the top of the CSV file spit out by the EVE client, with every following line containing an order. We may reserve lines above the beginning CSV line and the subject line (and any mail headers) for exciting meta-data, so don't count on the format being set in stone.
Note that you can't post to the list - your messages will get rejected. This is not a discussion list.
Accepting any and all feedback.