diff --git a/docs/sdk-and-tools/rest-api/gateway-overview.md b/docs/sdk-and-tools/rest-api/gateway-overview.md index 47cc1f219..4eb3e8757 100644 --- a/docs/sdk-and-tools/rest-api/gateway-overview.md +++ b/docs/sdk-and-tools/rest-api/gateway-overview.md @@ -30,6 +30,15 @@ Currently, authentication is not needed to access the API. [comment]: # (mx-context-auto) +## **Rate Limits** + +The public Gateway endpoints use a rate-limiting mechanism to ensure infrastructure stability and fair resource distribution. The limitations are as follows: + +* **gateway.multiversx.com (_Mainnet_):** Maximum of **50 requests / IP / second**. +* **devnet-gateway.multiversx.com (_Devnet_):** Maximum of **50 requests / IP / second**. + +[comment]: # (mx-context-auto) + ## **HTTP Response format** Each request against the MultiversX API will resolve to a JSON response having the following structure: @@ -76,3 +85,4 @@ In the case of an **error**, the `data` field is unset, the `error` field contai :::important When describing each HTTP endpoint on the following pages, the basic structure of the response is **simplified for brevity,** and, in general, only the actual payload of the response is depicted. ::: +``` diff --git a/docs/sdk-and-tools/rest-api/multiversx-api.md b/docs/sdk-and-tools/rest-api/multiversx-api.md index 74e982f70..3b696f7b7 100644 --- a/docs/sdk-and-tools/rest-api/multiversx-api.md +++ b/docs/sdk-and-tools/rest-api/multiversx-api.md @@ -99,12 +99,18 @@ An API instance can be started with the following behavior: - subscription: used to manage subscriptions, fetch and broadcast data to subscribers [comment]: # (mx-context-auto) -## Rate limiting +### Rate Limits -Public MultiversX APIs have a rate limit mechanism that brings the following limitations: +Public MultiversX APIs utilize a protective rate-limiting mechanism to ensure network stability. The following limitations apply: -- api.multiversx.com (_mainnet_): 2 requests / IP / second -- devnet-api.multiversx.com (_devnet_): 5 requests / IP / second +#### HTTP Requests (REST API) +* **api.multiversx.com (_Mainnet_):** Maximum of **2 requests / IP / second**. +* **devnet-api.multiversx.com (_Devnet_):** Maximum of **5 requests / IP / second**. + +--- + +#### WebSocket Subscriptions +* **Subscription Limit:** A single client can create a maximum of **10 different subscription variants** (active parallel subscriptions). [comment]: # (mx-context-auto)