# Taiko RPC documentation

## Taiko RPC plans and rate limits

- **Free plan:** 20 responses per second, up to 100,000 responses a day.
- **Plans:** $49/mo, $299/mo, $999/mo with 25M, 150M, and 500M included responses. Overages billed at $5/$3/$2 per million responses respectively.
- **Paid rate limits:** 100 to 5,000 responses per second (bursts from 500 to 10,000), no daily limit.
- **Billing:** 1 response = 1 API credit on every shared plan, over HTTPS or WebSocket (WSS) where Taiko supports it.

Details: [Pricing](https://www.dwellir.com/docs/getting-started/pricing) · [Rate limits](https://www.dwellir.com/docs/getting-started/rate-limits) · [Authentication](https://www.dwellir.com/docs/getting-started/authentication) · [Archive nodes](https://www.dwellir.com/docs/getting-started/archive-nodes)

## Build on Taiko

Taiko is an Ethereum-equivalent based rollup. Its JSON-RPC interface works with Ethereum libraries and tools. Dwellir provides archive access for historical state queries.

## Connect to Taiko mainnet

Replace `YOUR_API_KEY` with your Dwellir API key. Both transports use the root path after the key.

### Check the chain ID

cURL
Ethers.js v6

```bash
curl -X POST 'https://api-taiko-mainnet.n.dwellir.com/YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'
```

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

const provider = new JsonRpcProvider(
  'https://api-taiko-mainnet.n.dwellir.com/YOUR_API_KEY'
);
const network = await provider.getNetwork();
console.log(network.chainId === 167000n);
```

The `eth_chainId` result is `0x28c58`, or **167000** in decimal.

### Subscribe to new blocks

Connect to `wss://api-taiko-mainnet.n.dwellir.com/YOUR_API_KEY`. Send this JSON-RPC request:

```json
{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}
```

The response contains a subscription ID. Subsequent `eth_subscription` messages contain new block headers.

## Network specifications

| Parameter     | Value              |
| ------------- | ------------------ |
| Chain ID      | 167000 (`0x28c58`) |
| Network       | Taiko mainnet      |
| Node client   | Reth               |
| Node type     | Archive            |
| RPC transport | HTTPS and WSS      |

## API reference

The reference lists standard EVM methods for Taiko. The endpoint also returned results for historical balances, transaction receipts, event logs, `debug_traceTransaction`, and `trace_transaction` in direct checks.

## Resources

- [Taiko network](https://www.dwellir.com/networks/taiko)
- [Top Taiko RPC providers compared](https://www.dwellir.com/blog/top-taiko-rpc-providers)
- [Authentication](https://www.dwellir.com/docs/getting-started/authentication)
- [Archive nodes](https://www.dwellir.com/docs/getting-started/archive-nodes)
- [Taiko documentation](https://docs.taiko.xyz/)