BryanLabsBryanLabs
Cosmos Upgrades API

Interactive upgrade data explorer

Try the public JSON endpoints, inspect responses, and copy curl or jq examples for validator automation.

OpenAPI explorer

The default server proxies through this site so the Execute button works from your browser. Select the public API server when copying endpoint URLs for external clients.

curl and jq examples

List chains with active upgrades

curl -s 'https://cosmos-upgrades.bryanlabs.net/chains?upgrade_found=true' \
  | jq '.[] | {
      type,
      network,
      version,
      upgrade_height: .upgrade_block_height,
      eta: .estimated_upgrade_time,
      source
    }'

Only mainnet upgrade records

curl -s 'https://cosmos-upgrades.bryanlabs.net/chains?type=mainnet&upgrade_found=true' \
  | jq '.[] | {network, upgrade: .upgrade_name, height: .upgrade_block_height}'

Inspect one chain

curl -s 'https://cosmos-upgrades.bryanlabs.net/chains?health=all&network=passage' | jq '.[0]'

Find unreachable registry entries

curl -s 'https://cosmos-upgrades.bryanlabs.net/chains?health=unreachable&limit=10' \
  | jq '.[] | {network, error, scan_status: .scan_status}'

Service health

curl -s 'https://cosmos-upgrades.bryanlabs.net/healthz' | jq