API Key Rate Limit & Errors
Note: Moonriver (MOVR) on Kusama is a companion network to Moonbeam and provides a permanently incentivized canary network. New code ships to Moonriver first, where it can be tested and verified under real economic conditions. Once proven, the same code ships to Moonbeam on Polkadot.
Polygon PoS (polygonscan.com) is an EVM-compatible environment optimized for high throughput and low transaction fees while Polygon zkEVM (zkevm.polygonscan.com) is an EVM-equivalent ZK rollup designed for security.
The BaseScan Developer APIs provide the Base community with accessible and consistent Base data. The APIs are free for the community with a maximum rate limit of up to 5 calls per sec/IP with a valid API key.
Developers will expect to receive error messages listed, indicating situations where an API key is not in use or has exceeded the rate limit.
- The 5 calls per sec/IP rate limit is exceeded:
{"status":"0","message":"NOTOK","result":"Max rate limit reached"}
- An API request with a blank API Key or the default "YourApiKeyToken":
{"status":"1","message":"OK-Missing/Invalid API Key, rate limit of 1/5sec applied","result":"595623370144773018344492"}
- An API request with Invalid API Key:
{"status":"0","message":"NOTOK","result":"Invalid API Key"}
- API requests with Invalid API Key exceeding limit:
{"status":"0","message":"NOTOK","result":"Too many invalid api key attempts, please try again later"}
Responses:
Status: 1 - Ok , 0 - Not ok
Message: Ok - Success , Notok - Failed
(Additional messages might be included based on scenarios.)
Result: Return the API results