Why do I get 401 on a valid token?

The token may have been rotated. Copy the current one from the strategy's Integration tab.

Can I put the token in the URL?

No. The REST API takes it only in the Authorization header.

What is the REST rate limit?

30 requests a minute for each token.

What do I do after a 500?

Check recent orders first, because the alert may not have gone through.

Guide

What do Nyria REST API errors 401, 409 and 429 mean?

Nyria's REST API answers 401 when the bearer token is missing, mistyped or rotated, 409 when the same alert went out in the last two minutes, and 429 when a token passes 30 requests a minute or sends too many alerts in a burst. Wait as long as Retry-After says on a 429. On a 500 the alert may not have gone through, so check recent orders before you send again.

Start free

Official documentation

Work through a REST API error

1
Read the status code
The body carries an error message.
2
Check the header
Send Authorization: Bearer with the strategy token, never in the URL.
3
Slow down on 429
Wait as long as Retry-After says.
4
Change the message on 409
The same alert within two minutes goes out once.
5
Check recent orders on 500
Do this before you send again.

The status codes

400: limit must be a whole number from 1 to 100, or the alert body is empty or has no message.
401: the token is missing, mistyped or rotated.
404: no order with that id on this strategy.
405: the route takes the method named in the Allow header.
409: the same alert went out in the last two minutes.
413: the body is over 16 KB.
422: Nyria could not use the alert, for example unreadable text or an unknown symbol.
429: over 30 requests a minute, or too many alerts in a burst.
500: the alert may not have gone through.

Rate and size limits

Each token allows 30 requests a minute.
A message holds up to 2000 characters.
The request body can be up to 16 KB.

Scaling into a position

Make the message differ from the last one, so Nyria treats it as a new alert.
Reads of positions and orders use the same token and the same limit.

Questions

Why do I get 401 on a valid token?: The token may have been rotated. Copy the current one from the strategy's Integration tab.
Can I put the token in the URL?: No. The REST API takes it only in the Authorization header.
Why does a repeat answer 409?: The same alert went out in the last two minutes.
What is the REST rate limit?: 30 requests a minute for each token.
What do I do after a 500?: Check recent orders first, because the alert may not have gone through.

All questions