Responses - Error Codes

The body of every response will include the following fields.

FieldDescription
descriptionDescription of the response.
payloadThe object containing the actual data requested.
statusThe status of the response.
titleThe human readable name associated with the HTTP status according to the HTTP Status Code Registry.

Historical Data

Some endpoints have startDate & endDate parameters, but no pagination parameter. These endpoints have a limit to how much historical data can be returned per query depending on the granularity. In order to get more than the max, you must use the startDate & endDate parameters to move the time frame window to get the next n minutes/days/months of data.

Errors

In an erroneous response, the description field will indicate the reason for the error.

Status CodeReason
200Successful Request
400Bad Request – Invalid request format or query results exceed 10 MB limit
401Unauthorized – Invalid API Key
403Forbidden – Access to endpoint is not authorized
404Not Found – Pair or address does not exist for example
429Too Many Requests – rate limit was exceeded
5xxInternal Server Error – We had a problem with our server

Success

A successful response will be indicated by a HTTP status code of 200 and the payload will include the desired data.