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

IntroductionBlockchain Intelligence APIs: GET Network Feed