API XML Char Journal

From EVEDev
Jump to: navigation, search

Contents

WalletJournal

Address

  • /char/WalletJournal.xml.aspx
  • /corp/WalletJournal.xml.aspx
  • /char/WalletJournal.csv.aspx
  • /corp/WalletJournal.csv.aspx

Overview

Returns a list of journal transactions for owner or corporation

Data Caching

This method is cached according to the Long Cache Style.

Input Arguments

Name Type Description
userID int userID of account for authentication.
apiKey char(64) Full access API key of account.
charID/corpID int character ID or corporation ID depending on mode.
accountKey int 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 int used for walking the journal backwards to get more entries, see the section on journal walking below.

Output XML

 
<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>
 

Output CSV

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,""

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.

Personal tools