Free rate-limited JSON-RPC access to a Nimiq Proof-of-Stake History node
Connect to the server at this very URL! https://rpc.nimiqwatch.com
Websocket connections are not (yet) supported, you need to use individual POST
requests.
Access is rate-limited by IP. Each IP has an allowance of 20 tokens
per 10 seconds
(subject to change).
Requests consume tokens based on the length of their result. Single results consume 1 token, list results consume 1 token per started 100 items.
Requesting the current head block produces a single result and consumes 1 token. Requesting a list of transactions for an account consumes 1 token per started 100 items, so if you limit your result to max: 100
, it still only consumes 1 token. Not specifying the max
parameter can consume up to 5 tokens, as the default for that parameter is 500. If the request returns 305 items, it consumes 4 tokens.
Each server response contains headers that tell you how many tokens you have left and when the rate limit resets:
x-ratelimit-remaining
: number of tokens remaining until resetx-ratelimit-reset
: the UNIX timestamp of when the tokens resetWhen you have no more tokens remaining in the current time window, the server responds with a 429 Too Many Requests
status code and a properly formatted error response.
Uptime is not guaranteed. The server may be restarted or be taken offline at any time without notice.
Not all RPC methods are available. Methods that can upload, manage, or sign with stored private keys are disabled.
See nimiqhub.com/docs/rpc for documentation of these methods.
getBlockNumber
getBatchNumber
getEpochNumber
getBlockByHash
getBlockByNumber
getLatestBlock
getSlotAt
getTransactionByHash
getTransactionsByBlockNumber
getInherentsByBlockNumber
getTransactionsByBatchNumber
getInherentsByBatchNumber
getTransactionHashesByAddress
getTransactionsByAddress
getAccountByAddress
getActiveValidators
getCurrentPenalizedSlots
getPreviousPenalizedSlots
getValidatorByAddress
getStakerByAddress
isConsensusEstablished
getRawTransactionInfo
sendRawTransaction
pushTransaction
mempoolContent
mempool
getMinFeePerByte
getTransactionFromMempool
getPeerCount
getPolicyConstants
getEpochAt
getEpochIndexAt
getBatchAt
getBatchIndexAt
getElectionBlockAfter
getElectionBlockBefore
getLastElectionBlock
isElectionBlockAt
getMacroBlockAfter
getMacroBlockBefore
getLastMacroBlock
isMacroBlockAt
isMicroBlockAt
getFirstBlockOf
getFirstBlockOfBatch
getElectionBlockOf
getMacroBlockOf
getFirstBatchOfEpoch
getBlockAfterReportingWindow
getBlockAfterJail
getSupplyAt
verifySignature
getZkpState