Skip to main content

Spot REST Introduction

API Organisation​

The Spot REST API is organised by function, covering a wide range of services:

Requests, Responses and Errors​

Requests​

Request payloads are form-encoded (Content-Type: application/x-www-form-urlencoded), and all requests must specify a User-Agent in their headers.

Responses​

Responses are JSON encoded and contain one or two top-level keys (result and error for successful requests or those with warnings, or only error for failed or rejected requests)

Example​

Request:

GET <https://api.kraken.com/0/public/SystemStatus>

Successful response:

{
    "error": [],
    "result": {
        "status": "online",
        "timestamp": "2021-03-22T17:18:03Z"
    }
}

Error response:

{
    "error": [
        "EGeneral:Invalid arguments:ordertype"
    ]
}

Error Details​

HTTP status codes are generally not used by our API to convey information about the state of requests and any errors or warnings are denoted in the error field of the response as described above. Status codes other than 200 indicate that there was an issue with the request reaching our servers.

error messages follow the general format <severity><category>:<error msg>

  • severity can be either E for error or W for warning
  • category can be one of General, Auth, API, Query, Order, Trade, Funding, or Service
  • error msg can be any text string that describes the reason for the error

Additional information can be found on our support center.