Stream history contains a gap (stream_gap)

HTTP 409Orion /v3 ProblemCode: stream_gap

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

The live SSE stream encountered a ledger gap and must be reconnected.

How to Resolve stream_gap

1. Inspect the status (409), code (stream_gap), 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/stream_gap",
  "title": "Stream history contains a gap",
  "status": 409,
  "detail": "Stream history contains a gap",
  "code": "stream_gap"
}

TypeScript / Fetch

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

cURL

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

---

← Back to All 53 Orion /v3 Problem Codes