Rate limits

Every call to the Navexa API is metered. Go over a limit and the call is refused with
429 Too Many Requests. Nothing is created, changed or deleted when that happens, so a
429 is always safe to retry.

Each portfolio — usually the one you hit

Counted separately per portfolio, so a busy portfolio does not hold back the others.

Endpoints	Burst	Per hour	Per day
Reports and performance	60	60	1,500
Other reads	120	120	3,000
Writes	60	300	7,260

These are the tightest limits and they bind first. Working through one portfolio, you
reach its limit well before your account limit — five times sooner on reports. Spread work
across portfolios rather than driving one hard.

This applies where the path names a portfolio, and where it names a holding — reading a
holding counts against the portfolio that holds it. Everything else counts against your
account limit alone.

Everyone reading the same portfolio shares its limit, and your plan does not raise it.

Your account

Everything you send, whichever key and whichever portfolio.

Endpoints	Burst	Per hour	Per day
Reports and performance	300	1,200	29,100
Other reads	1,200	1,200	30,000
Writes	60	300	7,260

On an active Premium plan each of those rows is raised to 3,600 burst, 3,600 an hour,
90,000 a day.

Two API keys on the same account share these limits. They do not get a set each.

Burst and per hour

Burst is the most you may send back to back. It refills continuously at the per
hour rate and never goes above the burst. So a burst followed by a quiet period is
never refused, and per day is what one limit serves in 24 hours if you pace yourself.

When you are refused

HTTP/1.1 429 Too Many Requests
Retry-After: 30

Retry-After is whole seconds until you may send again. Wait that long and retry. If you
are refused again, double the wait and add a little randomness so a fleet of workers does
not return in lockstep.

Retry-After is only sent on the 429, so send your work and handle the refusal when it
arrives rather than trying to stay just under the limit.

These numbers can change. Treat the 429 and Retry-After as the contract, not the tables.

Each portfolio — usually the one you hit#

Your account#

Burst and per hour#

When you are refused#

Each portfolio — usually the one you hit

Your account

Burst and per hour

When you are refused