Skip to main content
Edge RPC provides authentication and rate limiting controls to secure your endpoints.

​
Authentication

Each Edge RPC endpoint requires a secret token for authentication. The secret is included in the URL: 
https://edge.goldsky.com/standard/evm/{chainId}?secret=YOUR_SECRET

​
Query Parameter

Pass the secret as a URL query parameter: 
curl "https://edge.goldsky.com/standard/evm/1?secret=YOUR_SECRET" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

​
Header-Based Authentication

Alternatively, pass the secret via the X-ERPC-Secret-Token header: 
curl "https://edge.goldsky.com/standard/evm/1" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "X-ERPC-Secret-Token: YOUR_SECRET" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

​
Rate Limiting

Rate limits can be configured per secret in the Goldsky Dashboard. The following options are available:
OptionTotal RPSPer-IP RPSDescription
None (Unlimited)UnlimitedUnlimitedNo rate limiting applied
edge-tier-6krpm-total-unlimited-per-ip~100UnlimitedLow volume, no per-IP restrictions
edge-tier-60krpm-total-unlimited-per-ip~1,000UnlimitedMedium volume, no per-IP restrictions
edge-tier-180krpm-total-unlimited-per-ip~3,000UnlimitedHigh volume, no per-IP restrictions
edge-tier-360krpm-total-unlimited-per-ip~6,000UnlimitedVery high volume, no per-IP restrictions
edge-tier-600krpm-total-unlimited-per-ip~10,000UnlimitedEnterprise volume, no per-IP restrictions
edge-tier-6krpm-total-500rpm-per-ip~100~8Low volume with per-IP protection
edge-tier-60krpm-total-500rpm-per-ip~1,000~8Medium volume with per-IP protection
edge-tier-180krpm-total-500rpm-per-ip~3,000~8High volume with per-IP protection
edge-tier-360krpm-total-500rpm-per-ip~6,000~8Very high volume with per-IP protection
edge-tier-600krpm-total-500rpm-per-ip~10,000~8Enterprise volume with per-IP protection
edge-tier-unlimited-total-100rpm-per-ipUnlimited~1.7Strict per-IP limiting only
edge-tier-unlimited-total-500rpm-per-ipUnlimited~8Moderate per-IP limiting only
  • Total RPS: Maximum requests per second across all IPs using this secret
  • Per-IP RPS: Maximum requests per second from a single IP address