# Quickstart (/docs/rpc/quickstart)

<Callout type="warn" title="Preview: Swop RPC is not generally available">
The gateway at `rpc.swopme.co` is running, but it routes to third-party node providers today: Swop's own node fleet is still being built. Projects are created for preview partners only, and limits and pricing can change. [Request access](/docs/rpc/request-access).
</Callout>

You need a **project ID** and, if your project requires one, a **project secret**. Both come with preview access.

## 1. Call an EVM network [#1-call-an-evm-network]

<Tabs items={['curl', 'viem', 'ethers']}>
<Tab value="curl">
```bash
curl https://rpc.swopme.co/base-mainnet/v3/YOUR_PROJECT_ID \
  -H 'content-type: application/json' \
  -H 'x-project-secret: YOUR_PROJECT_SECRET' \
  --data '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'
```
</Tab>
<Tab value="viem">
```ts
import { createPublicClient, http } from 'viem';
import { base } from 'viem/chains';

const client = createPublicClient({
  chain: base,
  transport: http('https://rpc.swopme.co/base-mainnet/v3/YOUR_PROJECT_ID', {
    fetchOptions: { headers: { 'x-project-secret': process.env.SWOP_RPC_SECRET! } },
  }),
});

console.log(await client.getBlockNumber());
```
</Tab>
<Tab value="ethers">
```ts
import { FetchRequest, JsonRpcProvider } from 'ethers';

const req = new FetchRequest('https://rpc.swopme.co/base-mainnet/v3/YOUR_PROJECT_ID');
req.setHeader('x-project-secret', process.env.SWOP_RPC_SECRET!);

const provider = new JsonRpcProvider(req);
console.log(await provider.getBlockNumber());
```
</Tab>
</Tabs>

## 2. Call Solana [#2-call-solana]

<Tabs items={['curl', 'web3.js']}>
<Tab value="curl">
```bash
curl https://rpc.swopme.co/solana-mainnet/v3/YOUR_PROJECT_ID \
  -H 'content-type: application/json' \
  -H 'x-project-secret: YOUR_PROJECT_SECRET' \
  --data '{"jsonrpc":"2.0","id":1,"method":"getVersion","params":[]}'
```
</Tab>
<Tab value="web3.js">
```ts
import { Connection } from '@solana/web3.js';

const connection = new Connection('https://rpc.swopme.co/solana-mainnet/v3/YOUR_PROJECT_ID', {
  commitment: 'confirmed',
  httpHeaders: { 'x-project-secret': process.env.SWOP_RPC_SECRET! },
});

console.log(await connection.getVersion());
```
</Tab>
</Tabs>

## 3. Subscribe over WebSocket [#3-subscribe-over-websocket]

Use the same path with `wss://`. WebSocket clients usually can't set headers, so pass the secret as a query parameter:

```text
wss://rpc.swopme.co/base-mainnet/v3/YOUR_PROJECT_ID?projectSecret=YOUR_PROJECT_SECRET
```

## Limits [#limits]

Each project has a request rate limit, a cap on open WebSocket connections and monthly request and message quotas. Archive and trace methods are separate entitlements. When you hit a limit the gateway rejects the request; back off and retry.
