- enhanced api doc
- added price param to list