MarketOrders

Retrieve character Market Orders.

  • Path: /char/MarketOrders.xml.aspx

  • Access mask: 4096

  • Cache timer: 1 hour

  • Parameters:

    Argument Type Meaning
    keyID long API key ID
    vCode char API verification code
    characterID long ID of character. Optional only if the key is character specific, otherwise mandatory.
    orderID long Optional order ID of order to retrieve. If omitted, retrieves an order batch (see notes).

Sample Response

<result>
    <rowset name="orders" key="orderID" columns="orderID,charID,stationID,volEntered,volRemaining,minVolume,orderState,typeID,range,accountKey,duration,escrow,price,bid,issued">
        <row orderID="4053334100" charID="1801683792" stationID="60005686" volEntered="340000" volRemaining="245705" minVolume="1" orderState="0" typeID="24488" range="32767" accountKey="1000" duration="90" escrow="0.00" price="92.00" bid="0" issued="2015-05-19 03:16:16"/>
        <row orderID="4097983513" charID="1801683792" stationID="60005686" volEntered="390" volRemaining="336" minVolume="1" orderState="0" typeID="3568" range="32767" accountKey="1000" duration="14" escrow="0.00" price="480000.00" bid="0" issued="2015-05-20 03:40:06"/>
        <row orderID="4111136138" charID="1801683792" stationID="60005701" volEntered="27" volRemaining="0" minVolume="1" orderState="2" typeID="20417" range="-1" accountKey="1000" duration="0" escrow="0.00" price="122000.00" bid="1" issued="2015-05-16 04:16:28"/>
        <row orderID="4111136288" charID="1801683792" stationID="60007294" volEntered="79" volRemaining="0" minVolume="1" orderState="2" typeID="20417" range="-1" accountKey="1000" duration="0" escrow="0.00" price="130000.00" bid="1" issued="2015-05-16 04:16:37"/>
    </rowset>
</result>

Result Data

orders rowset Rowset containing 1 row per market order.
orderID long Unique order ID.
charID long Character ID of the character which placed this order.
stationID int [1], [2], [3], [4] Station ID where order was placed.
volEntered int Quantity of items required or offered at time order was placed.
volRemaining int Quantity of items still required or offered.
minVolume int For bids (buy orders), the minimum quantity that will be accepted in a matching offer (sell order).
orderState int [1] Current order state.
typeID int [1], [2], [3], [4], [5] The type ID of the item transacted in this order.
range int [1] Valid order range.
accountKey int Wallet division for the buyer or seller of this order. Always 1000 for characters. Currently 1000 through 1006 for corporations.
duration int Numer of days for which order is valid (starting from the issued date). An order expires at time issued + duration.
escrow decimal For buy orders, the amount of ISK in escrow.
price decimal Cost per unit for this order.
bid bool True (1) for a bid (buy) order. False (0) for an offer (sell) order.
issued datetime Date and time when this order was issued.

Notes

  • If order ID is omitted, this call will return an order “batch” for the current month, which consists of:
    • All open “limit” orders (the first two rows in the example above). These are orders which were placed with a particular price target and were not fulfilled immediately.
    • All completed “market” orders (the last two rows in the example above). These are orders which were matched immediately when they were placed.
  • An open “limit” order which is later fulfilled or otherwise closed will no longer be provided in the order batch. To discover the state of such an order, you will need to pass the order ID explicitly.