Check Astar NFT data freshness and coverage

Freshness and completeness answer different questions. Indexer status says how recently Aradia observed the chain. Each list response also carries coverage, which says whether the indexed historical window is known to be complete.

cURL

curl -sS \
  -H "Authorization: Bearer $ARADIA_API_TOKEN" \
  "https://api.aradia.app/v1/indexer/status?network=astar"

JavaScript

async function dataConfidence(token) {
  const response = await fetch("https://api.aradia.app/v1/indexer/status?network=astar", {
    headers: { Authorization: `Bearer ${token}` },
  });
  if (!response.ok) return { usable: false, reason: `status ${response.status}` };
  const { data } = await response.json();
  const observed = BigInt(data.last_seen_block);
  const confirmed = BigInt(data.last_confirmed_block);
  return {
    usable: true,
    confirmationsBehindHead: observed - confirmed,
    coverage: data.coverage_status,
    checkedAt: data.updated_at,
  };
}

Python

import requests

def data_confidence(token):
    response = requests.get(
        "https://api.aradia.app/v1/indexer/status",
        params={"network": "astar"},
        headers={"Authorization": f"Bearer {token}"},
        timeout=30,
    )
    response.raise_for_status()
    status = response.json()["data"]
    return {
        "confirmations_behind_head": int(status["last_seen_block"]) - int(status["last_confirmed_block"]),
        "coverage": status["coverage_status"],
        "checked_at": status["updated_at"],
    }

Product language for uncertain coverage

• complete: the API claims the documented window is covered.
• partial: show the result, but label it as incomplete.
• unknown: avoid claims such as “all NFTs” or “complete history”.

Large block values are decimal strings. Parse them with BigInt in JavaScript, not Number.