{
"jsonrpc": "2.0",
"error": {
"code": 429,
"message": "The requests per second (RPS) of your requests are higher than your plan allows."
},
"id": 1
}
Bitcoin RPC Error Codes
Let's look at the common Bitcoin RPC Error Codes you can encounter, what they mean and what you can do to prevent them.
-32700解析错误
Invalid JSON was received by the server; check JSON syntax and formatting
-32600Invalid Request
The JSON sent is not a valid Request object; verify the request structure matches JSON-RPC 2.0 specification
-32601方法未找到
The method does not exist or is not available; verify method name spelling or check if the method requires a specific marketplace add-on (e.g., Blockbook methods like bb_gettx require the Blockbook add-on to be enabled)
-32602Invalid params
Invalid method parameter(s); double check parameter types, values, and order against Bitcoin Core documentation
-32603Internal error
Internal JSON-RPC error; this typically indicates an issue with the Bitcoin node itself
-1Miscellaneous error
General error that doesn't fit other categories; check error message for specific details
-2Forbidden by safe mode
Server is in safe mode, and command is not allowed in safe mode
-3Type error
Unexpected type was passed as parameter; ensure parameter types match expected values
-4Wallet error
Unspecified problem with wallet (key not found etc.)
-5Invalid address or key
Invalid Bitcoin address or key format; verify address/key format and network (mainnet vs testnet)
-6Insufficient funds
Not enough funds in wallet or account
-7Out of memory
Ran out of memory during operation
-8Invalid parameter
Invalid, missing or duplicate parameter
-9Client not connected
Bitcoin is not connected
-10Client in initial download
Still downloading initial blocks
-11Invalid account name
Invalid account name
-12Keypool ran out
Keypool ran out, call keypoolrefill first
-13Wallet unlock needed
Enter the wallet passphrase with walletpassphrase first
-14Wallet passphrase incorrect
The wallet passphrase entered was incorrect
-15Wrong encryption state
Command given in wrong wallet encryption state (encrypting an encrypted wallet etc.)
-16Wallet encryption failed
Failed to encrypt the wallet
-17Wallet already unlocked
Wallet is already unlocked
-18Wallet not found
Invalid wallet specified
-19Wallet not specified
No wallet specified (error when there are multiple wallets loaded)
-20Database error
Database read/write error; this may indicate corruption or disk issues
-22Deserialization error
Error parsing or validating structure in raw format; verify the raw transaction or block hex is properly formatted
-23Node already added
Node is already added
-24Node not added
Node has not been added before
-25Verify error
General error during transaction or block submission
-26Verify rejected
Transaction or block was rejected by network rules