Cursor bundle is no longer retained (stale_cursor)

HTTP 409Orion /v3 ProblemCode: stale_cursor

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

The state snapshot referenced by the cursor has been superseded by a newer ledger snapshot.

How to Resolve stale_cursor

1. Inspect the status (409), code (stale_cursor), 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/stale_cursor",
  "title": "Cursor bundle is no longer retained",
  "status": 409,
  "detail": "Cursor bundle is no longer retained",
  "code": "stale_cursor"
}

TypeScript / Fetch

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

cURL

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

---

← Back to All 53 Orion /v3 Problem Codes