fixes #728
* updated API spec to inculde futuers trade and price examples