Edge RPC Quickstart - Goldsky Docs

Prerequisites

A Goldsky account (free to create)

Don’t want an account? Pay per request with x402 nanopayments — fund a Circle Gateway USDC balance once and call Edge directly with no API key.

Get your endpoint

Edge RPC endpoints follow a simple URL format:

https://edge.goldsky.com/standard/evm/{chainId}?secret={your-secret}

Replace {chainId} with the chain ID (e.g., 1 for Ethereum, 42161 for Arbitrum, 8453 for Base) and {your-secret} with your API secret from the dashboard.

No account? Use secret=demo. Every example in these docs uses it, so you can paste and run any of them right now. It is a shared public key, rate limited and intended for demo and testing purposes only. Use your own secret from the dashboard for anything real.

See the full list of supported networks, or hit edge.goldsky.com directly for a programmatic JSON list of every chain (id, alias, block time, health status).

Make your first request

curl
viem
ethers.js
web3.js

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

Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x134a1b0"
}

import { createPublicClient, http } from 'viem'
import { mainnet } from 'viem/chains'

const client = createPublicClient({
  chain: mainnet,
  transport: http('https://edge.goldsky.com/standard/evm/1?secret=demo')
})

const blockNumber = await client.getBlockNumber()
console.log('Block number:', blockNumber)

import { JsonRpcProvider } from 'ethers'

const provider = new JsonRpcProvider(
  'https://edge.goldsky.com/standard/evm/1?secret=demo'
)

const blockNumber = await provider.getBlockNumber()
console.log('Block number:', blockNumber)

import Web3 from 'web3'

const web3 = new Web3(
  'https://edge.goldsky.com/standard/evm/1?secret=demo'
)

const blockNumber = await web3.eth.getBlockNumber()
console.log('Block number:', blockNumber)

Getting help

Can’t find what you’re looking for? Reach out to us at support@goldsky.com for help.

​Prerequisites

​Getting help

Prerequisites

Getting help