waves_logo Docs
  • Node Owner Guide
    Node Owner Guide
  • Install Waves Node
    • Deploy Node in Docker
      Deploy Node in Docker
    • Install Node on Ubuntu
      Install Node on Ubuntu
    • Install Node on macOS
      Install Node on macOS
    • Install Node on Windows
      Install Node on Windows
    • Install from Source (Building SBT)
      Install from Source (Building SBT)
    Install Waves Node
  • Synchronize Waves Blockchain
    • Import/Export Blockchain
      Import/Export Blockchain
    • Download the Latest Blockchain
      Download the Latest Blockchain
    • Rollback Waves Node
      Rollback Waves Node
    Synchronize Waves Blockchain
  • Generate Blocks
    Generate Blocks
  • Upgrade Waves Node
    Upgrade Waves Node
  • Node Configuration
    Node Configuration
  • Logging Configuration
    Logging Configuration
  • Node Wallet
    Node Wallet
  • Features
    • Activation protocol
      Activation protocol
    Features
  • Custom Blockchain
    Custom Blockchain
  • Node REST API
    • API Key
      API Key
    • Working with Transactions
      Working with Transactions
    • Numeric Fields Format
      Numeric Fields Format
    • Pagination
      Pagination
    • CORS
      CORS
    • API Limitations of Pool of Public Nodes
      API Limitations of Pool of Public Nodes
    • Slow Requests
      Slow Requests
    • Response Codes and Errors
      Response Codes and Errors
    Node REST API
  • Extensions
    • gRPC Server
      gRPC Server
    • Blockchain Updates
      Blockchain Updates
    Extensions
  • Troubleshooting
    • Block Generation FAQ
      Block Generation FAQ
    Troubleshooting
  • Node Go
    Node Go
      • English
      • Русский
      On this page
        • Limitations on Mainnet Pool
        • Limitations on Testnet Pool
      waves_logo Docs

          # API Limitations of Pool of Public Nodes

          Pool of public nodes is a set of public nodes which provide data via REST API. You can use our public nodes to retreive the information from the Waves blockchain, but we recommend to use your own nodes, because our pool has some limitations listed below.

          There is Nginx web server in front of each node in the pool, which limits:

          • The maximum number of simultaneous connections per IP address. If limit is exceeded, HTTP Status 503 is returned.
          • The maximum number of the requests per second (r/s) or requests per minute (r/m) from IP-address. If the requests rate exceeds the defined value, all the exceeding requests are put in the queue. The burst is the size of that queue. If the number of the exceeding requests begins to surpass the burst value, the new exceeding requests are not put in the queue and HTTP Status 429 is returned. Read more in the documentation.

          In addition, the web server caches node responses, so the data may be out of date.

          In the tables below regular expressions are used to define paths, for example, \d+.

          # Limitations on Mainnet Pool

          Path Connections Request rate Caching time
          / 15 20 r/s (burst 50) 1 s
          /blocks/seq/\d+/\d+ 1 1 r/s 5 s
          /blocks/at/.+ 1 1 r/s 30 s
          /blocks/last
          /transactions/address/.+/limit/.+
          /addresses/validate/.+
          /blocks/delay/.+/.+
          /peers/connected
          /peers/all
          /node/version
          /node/status
          /addresses/effectiveBalance/.+
          /alias/.+
          100 20 r/s (burst 50) 1 s
          /transactions/broadcast/.+ – 2 r/s (burst 2) –
          /transactions/info/.+ 15 20 r/s (burst 50) 1 m
          /blocks/height
          /transactions/unconfirmed
          15 20 r/s (burst 50) 15 s
          /addresses/balance/.+
          /assets/balance/.+
          15 100 r/s (burst 100) 3 s
          ^/transactions/address/.*
          ^/addresses/data/[^/]+$
          ^/assets/balance/[^/]+$
          ^/assets/[^/]/distribution.*
          – 17 r/m (burst 17) 1 s
          /utils/script/evaluate – 10 r/m 1 s

          # Limitations on Testnet Pool

          Path Connections Request rate Caching time
          / 15 20 r/s (burst 50) 1 s
          /blocks/seq/\d+/\d+ 1 1 r/s 5 s
          /blocks/at/.+ 1 1 r/s 30 s
          /blocks/last
          /consensus/algo
          /consensus/basetarget
          /transactions/address/.+/limit/.+
          /addresses/validate/.+
          /blocks/delay/.+/.+
          /consensus/generatingbalance/.+
          /peers/connected
          /peers/all
          /node/version
          /node/status
          /addresses/effectiveBalance/.+
          /alias/.+
          100 20 r/s (burst 50) 1 s
          /transactions/info/.+ 15 20 r/s (burst 50) 1 m
          /blocks/height
          /transactions/unconfirmed
          15 20 r/s (burst 50) 15 s
          /addresses/balance/.+
          /assets/balance/.+
          15 100 r/s (burst 100) 3 s
          /utils/script/evaluate – 10 r/m 1 s
          CORS
          Slow Requests
          CORS
          Slow Requests