MAIN, README: Improve optional params documentation

README.md

@@ -34,7 +34,8 @@ CFFI.
 
 ## Getting started
 
-To use, git clone the repo into your `~/quicklisp/local-projects` directory, then:
+To use, git clone the repo into your `~/quicklisp/local-projects` directory,
+then:
 
 ```lisp
 (ql:quickload :cl-kraken)
@@ -46,11 +47,11 @@ To use, git clone the repo into your `~/quicklisp/local-projects` directory, the
 
 All API calls accept the following optional boolean keyword parameters:
 
-- RAW (T or default NIL) for the JSON response be returned as a raw string
-  rather than parsed and converted to a list data structure
+- RAW (T or default NIL) to return the JSON response as a raw string instead of
+  parsed and converted to a list data structure.
 
 - VERBOSE (T or default NIL) to output the HTTP request headers for verifying
-  and debugging
+  and debugging.
 
 ### Public market data API calls
 

src/main.lisp

@@ -27,12 +27,17 @@
 (declaim (optimize (speed 0) (safety 3) (debug 3)))
 
 ;;; API
-
-;;; All API calls accept a VERBOSE boolean keyword parameter (T or default NIL)
-;;; to output the HTTP request headers for verifying and debugging.
-
+;;;
+;;; All API calls accept the following optional boolean keyword parameters:
+;;;
+;;; - RAW     (T or default NIL) to return the JSON response as a raw string
+;;;                              instead of parsed to a list data structure.
+;;;
+;;; - VERBOSE (T or default NIL) to output the HTTP request headers for
+;;;                              verifying and debugging.
+;;;
 ;;; Kraken Public API
-
+;;;
 (defun asset-pairs (&key pair raw verbose)
   "Get tradeable asset pairs.
   URL: https://api.kraken.com/0/public/AssetPairs
@@ -201,8 +206,9 @@
     (when (integerp since) (push `("since" . ,since) (cdr params)))
     (request "Trades" :params params :raw raw :verbose verbose)))
 
+;;;
 ;;; Kraken Private API requiring authentication
-
+;;;
 (defun balance (&key raw verbose)
   (declare (type boolean raw verbose))
   (request "Balance" :post t :raw raw :verbose verbose))