curl --request GET \
  --url https://web-backend.scale3production.com/node_updates \
  --header 'x-api-key: <api-key>' \
  --header 'x-user-agent: s3l-web-client'

{
  "result": [
    {
      "_id": "64caad9ff235e4337cabb497",
      "name": "mainnet-v1.6.3",
      "chain": "sui",
      "category": "optional",
      "description": "The upgrade includes new linter warnings for custom transfer/share/freeze functions, support for selective suppression of linter warnings, changes in unit tests handling, a new TransactionKindIn filter for querying transaction blocks, and linter warnings for object transfers.",
      "repo_name": "sui",
      "tag": "mainnet-v1.6.3",
      "network": "mainnet",
      "client": "sui",
      "release_date": 1690959709,
      "release_notes_url": "https://github.com/MystenLabs/sui/releases/tag/mainnet-v1.6.3",
      "build_artifacts": [],
      "createdAt": 1691004319,
      "updatedAt": 1691004319,
      "version": "1.6.3",
      "commit_hash": "abc123",
      "priority": "High",
      "prerequisites": ["Previous version installed"],
      "breaking_changes": false,
      "breaking_change_summary": "No breaking changes",
      "upcoming_network_upgrade": "None",
      "required_for_upcoming_upgrade": false
    }
  ],
  "metadata": {
    "page": 1,
    "page_size": 10000,
    "total_pages": 1
  }
}

​
Using Query Parameters with GET Node Updates

To enhance your experience with our ‘GET Node Updates’ endpoint, you can use various query parameters provided by the api-query-params library. These parameters allow for advanced filtering, sorting, and pagination, helping you tailor the response to your specific needs. Below are examples demonstrating how to effectively utilize these features.

​
Examples of Query Parameters

  1. Filtering by Chain and Category with Sorting: Fetch updates for Ethereum mainnet in the, sorted by the release date and priority. 
    GET /node-updates?chain=eth&network=mainnet&breaking_changes=true&sort=priority,-release_date
  2. Pagination and Selective Fields:: Retrieve the second page of updates, showing 10 records per page, displaying only name, version, and release date. 
    GET /node-updates?page=2&page_size=10&fields=name,version,release_date
Check out the api-query-params documentation for more information on how to use these query parameters. For any questions or feedback regarding the use of query parameters with our API, feel free to reach out to our support team at support@scale3labs.com. The complete list of query parameters supported by the ‘GET Node Updates’ endpoint is provided below.
​
category
string
Node update category
​
chain
string
required
Network feed chain. Currently supported chains values are (“aptos”, “algo”, “aptos”, “arb”, “avax”, “base”, “bnb”, “link”, “btc”, “bch”, “ada”, “tia”, “celo”, “atom”, “cro”, “dash”, “doge”, “eos”, “eth”, “etc”, “ftm”, “fil”, “flr”, “flow”, “harmony”, “hbar”, “hnt”, “icp”, “inj”, “kava”, “ksm”, “ltc”, “mina”, “near”, “op”, “dot”, “polygon”, “xrp”, “sei”, “sol”, “stx”, “xlm”, “sui”, “xtz”, “trx”, “ton”, “vet”, “zec”)
​
repo_name
string
Name of repository that contains the update code
​
tag
string
Node update tag. The Tag contains the update version
​
network
string
Node update network (mainnet, testnet, devnet)
​
client
string
Node update client depending on the chain. For chains with no client the default value is the chain itself. Supported clients include: ( “cardanonode”, “goalgorand”, “aptos”, “nitro”, “avalanchego”, “base”, “besu”, “bsc”, “bitcoincore”, “bchd”, “bitcoincashnode”, “bor”, “celestia”, “celo”, “chainlink”, “gaia”, “cronos”, “dashd”, “dogecoincore”, “eos”, “erigon”, “coregeth”, “goopera”, “fireeth”, “flow”, “forest”, “geth”, “goflare”, “gosongbird”, “harmony”, “hedera”, “heimdall”, “horizon”, “icp”, “injectived”, “jito”, “kava”, “kusama”, “lighthouse”, “lighthouse_vc”, “lighthouse_bc”, “litecoincore”, “lodestar”, “lotus”, “mina”, “nethermind”, “nearcore”, “nimbus”, “op”, “optimism”, “polkadot”, “prysm”, “reth”, “rippled”, “rocketpool”, “sei”, “solana”, “stacks”, “stellarcore”, “teku”, “tezos”, “javatron”, “ton”, “testclient”, “thor”, “zcashd”)
​
version
string
Version of the node update
​
priority
string
Priority/Severity level of the node update
​
breaking_changes
boolean
Boolean indicating if the update has breaking changes
​
required_for_upcoming_upgrade
boolean
Boolean indicating if the update is required for an upcoming network upgrade
​
page_size
integer
Size of a single page i.e how many records to send back in the response
​
page
integer
Page number
  curl --request GET \
  --url https://web-backend.scale3production.com/node_updates \
  --header 'x-api-key: <api-key>' \
  --header 'x-user-agent: s3l-web-client'

{
  "result": [
    {
      "_id": "64caad9ff235e4337cabb497",
      "name": "mainnet-v1.6.3",
      "chain": "sui",
      "category": "optional",
      "description": "The upgrade includes new linter warnings for custom transfer/share/freeze functions, support for selective suppression of linter warnings, changes in unit tests handling, a new TransactionKindIn filter for querying transaction blocks, and linter warnings for object transfers.",
      "repo_name": "sui",
      "tag": "mainnet-v1.6.3",
      "network": "mainnet",
      "client": "sui",
      "release_date": 1690959709,
      "release_notes_url": "https://github.com/MystenLabs/sui/releases/tag/mainnet-v1.6.3",
      "build_artifacts": [],
      "createdAt": 1691004319,
      "updatedAt": 1691004319,
      "version": "1.6.3",
      "commit_hash": "abc123",
      "priority": "High",
      "prerequisites": ["Previous version installed"],
      "breaking_changes": false,
      "breaking_change_summary": "No breaking changes",
      "upcoming_network_upgrade": "None",
      "required_for_upcoming_upgrade": false
    }
  ],
  "metadata": {
    "page": 1,
    "page_size": 10000,
    "total_pages": 1
  }
}