> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goldsky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get your first Edge RPC call working in under 2 minutes

## Prerequisites

* A [Goldsky account](https://app.goldsky.com) (free to create)

<Tip>
  Don't want an account? Pay per request with [x402 nanopayments](/edge-rpc/capabilities/x402) — fund a Circle Gateway USDC balance once and call Edge directly with no API key.
</Tip>

<Steps>
  <Step title="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.

    <Tip>
      See the full list of [supported networks](/chains/supported-networks#edge-rpc), or hit [`edge.goldsky.com`](https://edge.goldsky.com) directly for a programmatic JSON list of every chain (id, alias, block time, health status).
    </Tip>
  </Step>

  <Step title="Make your first request">
    <Tabs>
      <Tab title="curl">
        ```bash theme={null}
        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
          }'
        ```

        Response:

        ```json theme={null}
        {
          "jsonrpc": "2.0",
          "id": 1,
          "result": "0x134a1b0"
        }
        ```
      </Tab>

      <Tab title="viem">
        ```typescript theme={null}
        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=YOUR_SECRET')
        })

        const blockNumber = await client.getBlockNumber()
        console.log('Block number:', blockNumber)
        ```
      </Tab>

      <Tab title="ethers.js">
        ```typescript theme={null}
        import { JsonRpcProvider } from 'ethers'

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

        const blockNumber = await provider.getBlockNumber()
        console.log('Block number:', blockNumber)
        ```
      </Tab>

      <Tab title="web3.js">
        ```typescript theme={null}
        import Web3 from 'web3'

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

        const blockNumber = await web3.eth.getBlockNumber()
        console.log('Block number:', blockNumber)
        ```
      </Tab>
    </Tabs>
  </Step>
</Steps>

## Getting help

Can't find what you're looking for? Reach out to us at [support@goldsky.com](mailto:support@goldsky.com) for help.