EVE API - Journal Data
The journal corresponds precisely to the in-game journal. This includes all entries that you would expect, such as NPC kills, market transactions, player money transfers, etc. If you are looking for market information, the transactions view is probably more appropriate to your needs.
/char/WalletJournal.xml.aspx
/corp/WalletJournal.xml.aspx
/char/WalletJournal.csv.aspx
/corp/WalletJournal.csv.aspx
/corp/WalletJournal.xml.aspx
/char/WalletJournal.csv.aspx
/corp/WalletJournal.csv.aspx
Returns an XML or CSV formatted list of the journal entries
contained in the specified wallet and account.
Method Parameters
| name | data type | description/purpose |
|---|---|---|
| userID | number | user account number |
| apiKey | stringer | user authentication token |
| characterID | number | for char mode, ID of character; in corp mode we use this character's corp |
| accountKey | number | corporations have seven accounts, this number comes from the /corp/AccountBalance.xml.aspx view and is always in the range 1000 to 1006; characters only have a single account (1000) |
| beforeRefID | number | used for walking the journal backwards to get more entries, see the section on journal walking below |
Method Sample Output
CSV format:
date,refID,refType,ownerName1,ownerName2,argName1,amount,balance,reason 2007-06-13 20:26:00,59008,"Transaction Tax","Mark Roled","Secure Commerce Commission","EVE System",-49.95,1000396718.05,"" 2007-06-13 20:26:00,59007,"Market Transaction","Mark Player","Mark Roled","Swordspine",9990.00,1000396768.00,"" 2007-06-13 20:26:00,59006,"Broker fee","Mark Roled","Nugoeihuvi Corporation","EVE System",-749.25,1000386778.00,"" 2007-06-13 20:16:00,58989,"Market Escrow","Mark Roled","","",-76269.53,1000387527.25,"" 2007-06-13 20:16:00,58986,"Market Escrow","Mark Roled","","",-23730.47,1000463796.78,"" 2007-06-13 20:16:00,58985,"Broker fee","Mark Roled","Nugoeihuvi Corporation","EVE System",-750.00,1000487527.25,"" 2007-06-13 17:33:00,58974,"Player Donation","Mark Roled","Banana Republic","",-500000.00,1000488277.25,"" 2007-06-13 17:00:00,58970,"Transaction Tax","Mark Roled","Secure Commerce Commission","EVE System",-2628.55,1000988277.25,"" 2007-06-13 17:00:00,58969,"Market Transaction","Nugoeihuvi Corporation","Mark Roled","Maulus",525710.00,1000990905.80,"" 2007-06-13 17:00:00,58968,"Broker fee","Mark Roled","Nugoeihuvi Corporation","EVE System",-3942.83,1000465195.80,"" 2007-06-13 17:00:00,58967,"Transaction Tax","Mark Roled","Secure Commerce Commission","EVE System",-2628.55,1000469138.63,"" 2007-06-13 17:00:00,58966,"Market Transaction","Nugoeihuvi Corporation","Mark Roled","Atron",525710.00,1000471767.18,"" 2007-06-13 17:00:00,58965,"Broker fee","Mark Roled","Nugoeihuvi Corporation","EVE System",-3942.83,999946057.18,"" 2007-05-22 11:28:00,57035,"Player Donation","Mark Roled","Banana Republic","",-50000.00,999950000.00,""
XML format:
<eveapi version="1">
<currentTime>2007-06-21 17:49:22</currentTime>
<result>
<rowset name="entries" key="refID">
<row date="2007-06-15 14:13:00" refID="59149" refTypeID="54" ownerName1="corpslave" ownerID1="150337897" ownerName2="Secure Commerce Commission" ownerID2="1000132" argName1="" argID1="0" amount="-7.93" balance="190210393.87" reason=""/>
<row date="2007-06-15 14:13:00" refID="59148" refTypeID="2" ownerName1="University of Caille" ownerID1="1000115" ownerName2="corpslave" ownerID2="150337897" argName1="682" argID1="0" amount="793.13" balance="190210401.80" reason=""/>
<row date="2007-06-15 08:52:00" refID="59120" refTypeID="54" ownerName1="corpslave" ownerID1="150337897" ownerName2="Secure Commerce Commission" ownerID2="1000132" argName1="" argID1="0" amount="-7.93" balance="190209608.67" reason=""/>
<row date="2007-06-15 08:52:00" refID="59119" refTypeID="2" ownerName1="University of Caille" ownerID1="1000115" ownerName2="corpslave" ownerID2="150337897" argName1="670" argID1="0" amount="793.13" balance="190209616.61" reason=""/>
<row date="2007-06-15 08:51:00" refID="59110" refTypeID="54" ownerName1="corpslave" ownerID1="150337897" ownerName2="Secure Commerce Commission" ownerID2="1000132" argName1="" argID1="0" amount="-11119.68" balance="190208823.48" reason=""/>
<row date="2007-06-15 08:51:00" refID="59109" refTypeID="2" ownerName1="University of Caille" ownerID1="1000115" ownerName2="corpslave" ownerID2="150337897" argName1="665" argID1="0" amount="1111968.26" balance="190219943.16" reason=""/>
<row date="2007-06-15 08:48:00" refID="59090" refTypeID="54" ownerName1="corpslave" ownerID1="150337897" ownerName2="Secure Commerce Commission" ownerID2="1000132" argName1="" argID1="0" amount="-11119.68" balance="189107974.90" reason=""/>
<row date="2007-06-15 08:48:00" refID="59089" refTypeID="2" ownerName1="University of Caille" ownerID1="1000115" ownerName2="corpslave" ownerID2="150337897" argName1="655" argID1="0" amount="1111968.26" balance="189119094.58" reason=""/>
</rowset>
</result>
<cachedUntil>2007-06-21 17:49:32</cachedUntil>
</eveapi>
As you can see, the CSV format is optimized for viewing in Excel or similar programs, whereas the XML format contains extra data (such as IDs) that are not likely useful to people who are just downloading the data for analysis in a spreadsheet.
Journal Walking
The journal is configured to provide up to 1000 entries per request. It is
also configured to allow you to view up to one week's worth of data. If the first 1000 entries
you view stretch back further than a week, then you will not need to do any walking. However,
if you have enough entries in your journal that 1000 is less than a week, you can walk backwards
in the log to get more data.
Walking is performed by specifying the beforeRefID parameter as the
lowest refID you have seen so far. You will then get another page with entries. This process can
be repeated until you have gone back a week. The server will return an error if you attempt to
go back farther.
Programmatically, it will be easiest to just loop while you are getting
the max number of entries from the server, stopping when the server returns less than the max (i.e.
you get 853 entries in a pull), the oldest entry is over a week old, or the server returns an error.


























