Append query parameters to your endpoint URL to control upstream routing and caching behavior.
Parameter
Values
Description
use-upstream
nanoreth / hlnode
Force a specific backend instead of auto-routing
skip-cache-read
true
Bypass cache and get a fresh response from the node
By default, HypeRPC routes each request to the optimal backend. Use use-upstream to override:
Force Nanoreth (archive data)
curl -X POST "<URL> \
-H " Content-Type: application/json" \
-d '{" jsonrpc":" 2 .0"," method":" eth_getBlockByNumber"," params":[" 0x1", true]," id":1}'
curl -X POST "<URL> \
-H " Content-Type: application/json" \
-d '{" jsonrpc":" 2 .0"," method":" eth_getBlockByNumber"," params":[" 0x1", true]," id":1}'
curl -X POST "<URL> \
-H " Content-Type: application/json" \
-d '{" jsonrpc":" 2 .0"," method":" eth_getBlockByNumber"," params":[" 0x1", true]," id":1}'
Force HLNode (lowest latency)
curl -X POST "<URL> \
-H " Content-Type: application/json" \
-d '{" jsonrpc":" 2 .0"," method":" eth_blockNumber"," params":[]," id":1}'
curl -X POST "<URL> \
-H " Content-Type: application/json" \
-d '{" jsonrpc":" 2 .0"," method":" eth_blockNumber"," params":[]," id":1}'
curl -X POST "<URL> \
-H " Content-Type: application/json" \
-d '{" jsonrpc":" 2 .0"," method":" eth_blockNumber"," params":[]," id":1}'
HypeRPC caches immutable data (past blocks, receipts) aggressively and mutable data (latest block, balances) with short TTLs. Use skip-cache-read=true to force a fresh response:
Skip Cache
curl -X POST "<URL> \
-H " Content-Type: application/json" \
-d '{" jsonrpc":" 2 .0"," method":" eth_blockNumber"," params":[]," id":1}'
curl -X POST "<URL> \
-H " Content-Type: application/json" \
-d '{" jsonrpc":" 2 .0"," method":" eth_blockNumber"," params":[]," id":1}'
curl -X POST "<URL> \
-H " Content-Type: application/json" \
-d '{" jsonrpc":" 2 .0"," method":" eth_blockNumber"," params":[]," id":1}'
You can combine multiple parameters in a single request:
Nanoreth + Skip Cache
curl -X POST "<URL> \
-H " Content-Type: application/json" \
-d '{" jsonrpc":" 2 .0"," method":" eth_getBalance"," params":[" 0xADDRESS"," latest"]," id":1}'
curl -X POST "<URL> \
-H " Content-Type: application/json" \
-d '{" jsonrpc":" 2 .0"," method":" eth_getBalance"," params":[" 0xADDRESS"," latest"]," id":1}'
curl -X POST "<URL> \
-H " Content-Type: application/json" \
-d '{" jsonrpc":" 2 .0"," method":" eth_getBalance"," params":[" 0xADDRESS"," latest"]," id":1}'
Most applications don't need to bypass cache or select an upstream manually. The default behavior is optimized for both correctness and performance.