The Etherscan Developer APIs offer the Ethereum community accessible and consistent Ethereum data. These APIs are free for the community, with the following rate limits per Etherscan account:
- 1,000 records per call
- 5 calls per second
- 100,000 calls per day
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/second 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