[Standard] Polkadot Mainnet - Upgrade REST API to v0.2.0

Scheduled for Aug 26, 14:00 - 22:00 UTC

Scheduled

We are upgrading our Polkadot REST API infrastructure to v0.2.0.

This release introduces important breaking changes to account balance, locks, proxy, and vesting query endpoints.

These endpoints now properly distinguish between transient upstream failures and missing data, returning HTTP 503 (Service Temporarily Unavailable) instead of HTTP 200 with fabricated zero/empty values when the node is unreachable.

During the maintenance window, brief interruptions to REST API availability may occur.

RPC Changes:
- GET /accounts/{id}/balance-info — Now returns HTTP 503 on transient upstream failures instead of HTTP 200 with free: 0; clients should retry on 503. Unrecognized storage layouts return HTTP 500.
- GET /accounts/{id}/balance-info (get_account_data) — Now returns a Result type; callers must handle potential AccountDataError on fetch or decode failures.
- GET /accounts/{id}/balance-info (get_account_data_or_default) — Now returns a Result type; callers must handle potential AccountDataError.
- GET /accounts/{id}/balance-info (get_balance_locks) — Now returns a Result type; callers must handle potential BalanceQueryError.
- GET /accounts/{id}/balance-info (get_proxy_definitions) — Now returns a Result type; callers must handle potential AccountDataError.
- GET /accounts/{id}/balance-info (get_vesting_schedules) — Now returns a Result type; callers must handle potential AccountDataError.

https://github.com/paritytech/polkadot-rest-api/releases/tag/v0.2.0
Posted Aug 18, 2026 - 22:59 UTC
This scheduled maintenance affects: Polkadot (Mainnet - JSON RPC API, Mainnet - Websockets API, Mainnet - substrate-api-sidecar).