Errors

An error comes back as an HTTP status code with a short plain-text message, not JSON. Read the status first, then the message.

Status	Meaning	What to do
`200`	It worked.
`400`	The request is wrong: a missing parameter, an unknown interval, an end before the start, a sub-minute interval, a tick range over 1 day, or no prices held for that instrument. The message says which.	Fix the request. Do not retry it unchanged.
`401`	The `x-c9t-key` header is missing, or the key is wrong or revoked.	Check the key in API Access. See Authentication and keys.
`404`	The path or the currency symbol does not exist.	Check the path against the reference.
`429`	Not enough credits left in your 24-hour or 30-day window.	Wait for credits to free up, or upgrade. See Credits and limits.
`500`	Something failed on the server.	Retry after a few seconds, backing off each time.

Retrying

Retry only 500, and only a few times, waiting longer each time (for example 2, 4 and 8 seconds). A 400, 401, 404 or 429 will fail the same way until you change the request, the key or your credits.

Examples

400 End cannot be before start
400 Max tick data period is 1 day
401 'x-c9t-key' is a required header. Please provide your API key.
401 API Key is incorrect
429 No 24h credits remaining. Please upgrade your subscription

Read next