Rate limits - Cotality developer portal

Specific rate limit values depend on your entitlement tier and are defined in your service agreement. Contact your Cotality account representative for the limits applicable to your token.

General guidance

Scenario	Recommended approach
Sustained high-volume queries	Batch CLIP inputs where tools accept `array[string]`
Burst spikes	Implement exponential backoff with jitter
Portfolio-scale ingestion	Use batch endpoints or request a bulk data entitlement

HTTP 429 — Too many requests

When you exceed your rate limit, the API returns 429. The response includes a Retry-After header (in seconds) when available.

{
  "success": false,
  "count": 0,
  "data": [],
  "messages": [{ "code": "RATE_LIMIT_EXCEEDED", "message": "Too many requests. Retry after 30s." }]
}

Back-off pattern for agents

On 429:
  wait = min(base * (2 ^ attempt) + random_jitter, max_wait)
  retry up to 3 times
  if still 429 after 3 attempts: stop and surface to user

Error handling — full HTTP status code reference
Response envelope — envelope shape on errors

⌘I

​General guidance

​HTTP 429 — Too many requests

​Back-off pattern for agents

​Related

General guidance

HTTP 429 — Too many requests

Back-off pattern for agents

Related