buyitem qty price [have-left] * time: 0 days * priority: 1
Buy quantity of the given item for no more than price each.
If quantity is zero, any pending
buy order for the
indicated item will be canceled.
Only one pending
buy order may be active for each item at a time.
buy orders are issued for the same item, and the first has
not yet completed, the second
buy order will replace the first.
Buys and sells are only matched in cities, where markets may be found to
execute trades. However,
sell may be issued
If the a match is found with a seller, the trade will be executed immediately. Otherwise, the trade will be saved until a match with a seller may be found.
> buy 79 3 5 Try to buy three iron  for 5 gold each.
If there is a seller of iron in the city, selling for 5 gold or less, the trade will be executed:
1: Bought three iron  for 15 gold.
Otherwise, the buy will be placed on the character's pending trades list:
Pending trades: trade price qty item ----- ----- --- ---- buy 5 3 iron 
At the end of the turn, the buy order will appear in the city's market report:
Market report: trade who price qty item ----- --- ----- --- ---- buy 2019 5 3 iron 
A trade will match between a buyer and a seller if the buyer's price is greater than or equal to the seller's price. The actual price that the trade will be made at is the seller's price.
Have-left is an amount of gold that the character will not spend on this
trade. For instance, if the unit issued
buy 79 2 10 5, this
would mean `
Buy two iron  for 10 gold each, but not if I'll have less than 5 gold left over.' If the character had 15 gold, only
one of the iron would be bought.