Register and Login   | Jul 23 18:33

Now 3 Great Ways to Integrate

Pick your poison

• CSV Nightly Dumps
• XML Query
• Mail-Push SMTP Service

CSV All-submitted-entries market dumps

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:

1. All timestamps are in Pacfic time (7 or 8 hours off GMT depending on daylight savings time, designed to make your life more interesting) up until October 2007, when we moved to GMT/UTC.
2. This is a first shot at the data, it probably contains some bugs.
3. For awhile, buy order ranges were being inserted totally wrong, making the bid range field useless for a good part of 2006.
4. The data is big. Its 511MB compressed for the time period 2006-01-15 to 2007-5-1, but thats at around a 90% compression savings. You will have gigs of data in CSV files when you gunzip them.
5. It isn't live. Its generated nightly around 2am pacific for the previous day.

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.

XML HTTP APIs

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:

• This is direct from ingame data and has some useage restrictions. If you are unsure what that is, please see the EVE-Online Terms of Service.
• Do not hammer the server every second - If you are writing a killboard, it is ok to grab updated prices on a regular (hourly, daily, etc) basis to make cool loss/gain graphs, but do NOT try getting data on every page load. Most forms of caching for your site is ok. If you're unsure - ask.
• Do not query type IDs which do not exist in the market over and over! Its a waste of resources. This irritating practice will lead to swift bannination if I see it. Type IDs do not extend from 1 to 100000000000. Use the CCP data exports to figure out which types actually have a market group.

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.

marketstat_xml

Usage: http://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://eve-central.com/api/marketstat?typeid=34&typeid=35®ionlimit=10000002

quicklook

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://eve-central.com/api/quicklook?typeid=34

evemon

Usage: http://eve-central.com/api/evemon
Purpose: Retrieve the median mineral prices in the empire regions in a format digestable by EVEmon.
No parameters supported
Example: http://eve-central.com/api/evemon

If you have any questions or wish for more APIs, send me an e-mail. And donate some ISKies ;)

Deprecated XML Datafeeds

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.

Mail-Push Instant Market Log Service

Important Notice: Many mail services can't handle the large number of messages delivered by our system. These systems include:

• Live.com/Hotmail.com/live.co.uk (rate-limits messages)
• fastmail.fm (rate-limits messages)

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.

All times GMT unless otherwise specified. It is now: Jul 23 18:33 (GMT)

EVE Online Game Time Codes - Support EVE-Central by purchasing them at ShatteredCrystal.com through this affiliate link.

EVE-Central.com does not select nor endorse any advertisers which make use of Google AdSense keyword based advertising. Don't buy ISK for real cash! It is against the EVE-Online Terms of Service. For more details, please consult the EVE-Online website. Material related to EVE-Online is used with limited permission of CCP Games hf. No official affiliation or endorsement by CCP Games hf is stated or implied.

Powered by:


© 2005-2008 Yann Ramin Feedback? Bug reports? Send them to atrus [at] stackworks.net or Kaladr in game. EVE-Central.com uses advertising and affiliate links to help offset the cost of co-location, servers and bandwidth.