Hmmm, what format is the return data? XML? JSON? I have no idea from looking at your docs.
Near the top of the doc it says, "Responses are JSON encoded in the form of:"
Separate the description of what is returned from the actual data returned. Do this by including actual example data returned from the API.
Suggestion noted. For now, at least, you can try it out to see the response.
Do you have any reference implementations?
http://krakenapi.everdot.org/API/There's a reference implementation there in python. But it's for an older doc that has changed. Still it might be helpful, and may get updated soon.
-D