---
title: "Create Your First Endpoint"
description: "Set up your first RPC endpoint on BlockReq"
url: "https://blockreq.com/docs/getting-started/create-endpoint/"
---

# Create Your First Endpoint

An **endpoint** is your gateway to a blockchain network. Each endpoint includes:

- An **HTTPS** RPC URL for standard calls
- A **WSS** URL for WebSocket subscriptions
- A unique **API Key**

## Steps

### 1. Navigate to Endpoints

From the Dashboard, click **Endpoints** in the left sidebar (or visit `/dashboard/endpoint`).

### 2. Click "Add Endpoint"

Click the **+ Add Endpoint** button in the top right corner.

### 3. Select a Blockchain

Choose from the available networks:

| Network      | Chain ID | Slug               | Features                                  |
| ------------ | -------- | ------------------ | ----------------------------------------- |
| Ethereum     | 1        | `ethereum-rpc`     | Full; archive verification varies         |
| Base         | 8453     | `base-rpc`         | Full; archive verification varies         |
| BSC          | 56       | `bsc-rpc`          | Full; archive verification varies         |
| Arbitrum One | 42161    | `arbitrum-one-rpc` | Full; archive verification varies         |
| Polygon      | 137      | `polygon-bor-rpc`  | Keyed archive; public trial is restricted |

### 4. Name Your Endpoint (Optional)

Give your endpoint a descriptive name, e.g., "My DeFi Bot" or "Production Backend".

### 5. Start Using Your Endpoint

After creation, you'll see your RPC URLs:

```
HTTPS: https://ethereum-rpc.blockreq.com/v1/rpc/BRQ1P0000000000000000000000000000000000000000000000000000000
WSS:   wss://ethereum-rpc.blockreq.com/v1/rpc/BRQ1P0000000000000000000000000000000000000000000000000000000
```

### Example Usage

**cURL**

```bash
curl -X POST https://ethereum-rpc.blockreq.com/v1/rpc/BRQ1P0000000000000000000000000000000000000000000000000000000 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```

**ethers.js**

```javascript
import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://ethereum-rpc.blockreq.com/v1/rpc/BRQ1P0000000000000000000000000000000000000000000000000000000");
const blockNumber = await provider.getBlockNumber();
console.log("Latest block:", blockNumber);
```

**viem**

```typescript
import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://ethereum-rpc.blockreq.com/v1/rpc/BRQ1P0000000000000000000000000000000000000000000000000000000"),
});
const blockNumber = await client.getBlockNumber();
console.log(blockNumber);
```

**web3.py**

```python
from web3 import Web3

w3 = Web3(Web3.HTTPProvider("https://ethereum-rpc.blockreq.com/v1/rpc/BRQ1P0000000000000000000000000000000000000000000000000000000"))
print("Latest block:", w3.eth.block_number)

```

**Foundry**

```bash
cast rpc --rpc-url https://ethereum-rpc.blockreq.com/v1/rpc/BRQ1P0000000000000000000000000000000000000000000000000000000 eth_blockNumber
```

**Hardhat**

```javascript
const { ethers } = require("hardhat");

async function main() {
  const provider = new ethers.JsonRpcProvider("https://ethereum-rpc.blockreq.com/v1/rpc/BRQ1P0000000000000000000000000000000000000000000000000000000");
  console.log(await provider.send("eth_blockNumber", []));
}

main();
```

## Built-in RPC Tester

Each endpoint includes a built-in RPC tester. Click the **Test** button to open it, select an RPC method, and run it directly from your browser.

```

```