User Tools

Site Tools


evec-api:start

EVE-Central APIs

Web APIs

We have a set of XML and JSON datafeeds available to query pricing information from your own application, killboard, or website. But first, the rules:

  1. This is direct from in game data and has some usage restrictions. If you are unsure what that is, please see the EVE-Online Terms of Service.
  2. 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.

It is advisable to set a custom User-Agent header when requesting data to determine the source application. We can also add you to the “Applications using EVE-Central” section on our page.

CORS is enabled for all APIs.

API UPDATES

Nov 19, 2012: CORS support is enabled.

marketstat

This API uses parameters in the form of a form submission. The following form parameters are allowed:

Parameter Usage Required Can be specified more than once
hours Statistics from the last X specified hours. Defaults to 24. 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
usesystem Restrict statistics to a system. False False

Examples: http://api.eve-central.com/api/marketstat?typeid=34&typeid=35&regionlimit=10000002 http://api.eve-central.com/api/marketstat?typeid=34&usesystem=30000142

quicklook

  • Purpose: Retrieve all of the available market orders, including prices, stations, order IDs, volumes, etc.
  • Allowed methods: GET (parameter list), POST (form data)
  • Return type: XML

This API uses parameters in the form of a form submission. The following form parameters are allowed:

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

Examples: http://api.eve-central.com/api/quicklook?typeid=34

quicklook path

This API is very similar to the above API, but should be considered more experimental.

This API uses parameters in the form of a form submission combined with RESTful parameters. The following form parameters are allowed, and considered optional:

Parameter Usage Required Can be specified more than once
sethours Get orders which have been posted within the last X hours. Defaults to 360 False False
setminQ Restrict the view to show only orders above the specified quantity False False

The following positional parameters are allowed:

Parameter Description
XXX The name or solarsystem ID where to start the path
YYY The name or solarsystem ID where to end the path
ZZZ The numeric type ID for which to show (i.e., 34 for Tritanium)

Examples: http://api.eve-central.com/api/quicklook/onpath/from/Jita/to/Amarr/fortype/34

history

You can get a snapshot of EVE-Central statistics (not game statistics) over time.

URL Position Description
TYPE The type ID (numeric only) of the item you wish to get statistics for.
Locale The literal text “system” or “region”, meaning to look at per system or per region statistics.
id or name If you specified “system” or “region”, the text or numerical ID of the system or region.
bid Bid = 1 for buy orders, 0 for sell orders

Examples:

http://api.eve-central.com/api/history/for/type/34/system/Amarr/bid/1

http://api.eve-central.com/api/history/for/type/34/region/The%20Forge/bid/0

evemon

Example: http://api.eve-central.com/api/evemon

route

This URL is in a RESTful style. Substitute XXX and YYY with the either the exact system name or the system ID.

Examples: http://api.eve-central.com/api/route/from/Jita/to/V2-VC2

Libraries

Mail (SMTP) Push

EVE Market Data Relay

EVE-Central operates in and participates with the EVE Market Data Relay project.

For more information, see the documentation: http://eve-market-data-relay.readthedocs.org/en/latest/index.html

CSV Daily Market Dumps

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 appended end to end (though in-file sorting is not guaranteed).

There are of course some historical caveats:

  • 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.
  • Buy order ranges were incorrect for 2006 (ancient history, I know)

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.

evec-api/start.txt · Last modified: 2014/05/25 03:23 by theatrus