Server is overloaded (overload)

HTTP 503Orion /v3 ProblemCode: overload

Type URI: https://orion.stellarchain.io/problems/overload

The node's concurrent request limiter rejected the request due to high load. Retry with backoff.

How to Resolve overload

1. Inspect the status (503), code (overload), and detail fields in the JSON response.
2. For 400 validation errors (invalid_*), verify query parameters against the Endpoints Reference or Statistics Catalog (GET /v3/statistics).
3. For 404 errors (*_not_found), confirm the resource exists on Stellar Pubnet.
4. For 409, 429, 503, or 504 transient states, retry with exponential backoff.

Example Response & Client Handling

application/problem+json

{
  "type": "https://orion.stellarchain.io/problems/overload",
  "title": "Server is overloaded",
  "status": 503,
  "detail": "Server is overloaded",
  "code": "overload"
}

TypeScript / Fetch

const res = await fetch('https://pubnet.stellarchain.io/v3/statistics');
if (!res.ok) {
  const problem = await res.json();
  if (problem.code === 'overload') {
    console.error('Orion /v3 Problem [overload]:', problem.detail);
  }
}

cURL

curl -i -s "https://pubnet.stellarchain.io/v3/statistics" \
  -H "Accept: application/json"

---

← Back to All 53 Orion /v3 Problem Codes