Fix example in comments for the 'trades' API call.
Fix minor comment inconsistencies.
Document 'order' key for return value of 'trades' call.