---
title: "BNB Smart Chain RPC 엔드포인트 문서"
description: "ERPC를 BNB Smart Chain (BSC) RPC 엔드포인트로 사용하여 HTTP JSON-RPC 요청을 처리하는 방법을 안내합니다."
canonical: "https://erpc.global/ko/doc/bsc-rpc/general/"
locale: "ko"
---

# BNB Smart Chain RPC 엔드포인트 문서

## BNB Smart Chain RPC 엔드포인트 문서

ERPC를 BNB Smart Chain RPC 엔드포인트로 사용하여 HTTP JSON-RPC 요청을 처리할 수 있습니다. BNB Smart Chain RPC는 Global Edge Blockchain Infrastructure 내에 있는 ERPC의 RPC API 중 하나이며, API key는 ERPC Web Dashboard에서 관리할 수 있습니다.

Solana, Ethereum, Avalanche와 동일한 RPC key를 그대로 사용할 수 있습니다.

API key는 `api-key` 쿼리 매개변수로 전달하거나 `Authorization: Bearer <YOUR_API_KEY>`로 보내세요. 둘 다 있으면 쿼리 매개변수가 사용됩니다.

### 엔드포인트

JSON-RPC 2.0 요청은 다음 주소로 HTTP POST로 전송합니다.

```text
https://edge.erpc.global/bsc?api-key=<YOUR_API_KEY>
```

또는 다음 전용 호스트로 전송합니다.

```text
https://bsc.erpc.global?api-key=<YOUR_API_KEY>
```

`/` 경로에서만 요청을 받습니다.

### 예시

다음은 API key를 쿼리 매개변수에 넣은 HTTP 요청 예시입니다.

```bash
curl 'https://edge.erpc.global/bsc?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'
```

다음은 API key를 `Authorization` 헤더에 넣어 같은 요청을 보내는 예시입니다.

```bash
curl 'https://edge.erpc.global/bsc' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'
```

API key는 [ERPC Web Dashboard](https://dashboard.erpc.global/ko)에서 발급받고 확인할 수 있습니다.

### 배치 요청

HTTP 요청당 1~100개 호출의 JSON-RPC 배치를 지원합니다. 각 호출에는 고유한 `id`가 필요하며, 배치 내에서 `id` 값이 중복되면 안 됩니다. 배치 내 각 호출은 개별 호출로 계량됩니다. 요청 본문은 최대 1 MiB까지 보낼 수 있습니다.

### 사용량 측정

사용량은 token 단위로 계량되며, token 요금은 메서드에 따라 다를 수 있습니다. HTTP 배치 내 각 호출은 개별적으로 계량됩니다.

### Free 요금제 제한

Free 요금제에서는 사용자의 계정이 10초당 요청 한 건을 보낼 수 있습니다. 이 제한은 엔드포인트별이 아니라 계정별로 집계되므로, 다른 체인으로 보낸 요청도 집계에 포함될 수 있습니다. 그보다 빨리 보낸 요청에는 HTTP `429`로 응답하며, `retry-after` 헤더가 대기할 시간(초)을 알려 줍니다.

Free 요금제에서는 JSON-RPC 호출을 두 개 이상 담은 요청에 HTTP `429`로 응답하며, 그 요청의 호출은 하나도 전송되지 않습니다. 각 호출은 코드 `-32041`의 JSON-RPC 오류를 받습니다. 대신 이 호출들을 하나씩 보내세요.

### 지원 메서드

이 엔드포인트는 다음 38개의 메서드를 네임스페이스별로 제공합니다.

- `eth_*` (24): `eth_blockNumber`, `eth_call`, `eth_chainId`, `eth_estimateGas`, `eth_feeHistory`, `eth_gasPrice`, `eth_getBalance`, `eth_getBlockByHash`, `eth_getBlockByNumber`, `eth_getBlockReceipts`, `eth_getBlockTransactionCountByHash`, `eth_getBlockTransactionCountByNumber`, `eth_getCode`, `eth_getLogs`, `eth_getProof`, `eth_getStorageAt`, `eth_getTransactionByBlockHashAndIndex`, `eth_getTransactionByBlockNumberAndIndex`, `eth_getTransactionByHash`, `eth_getTransactionCount`, `eth_getTransactionReceipt`, `eth_maxPriorityFeePerGas`, `eth_sendRawTransaction`, `eth_syncing`
- `net_*` (3): `net_listening`, `net_peerCount`, `net_version`
- `web3_*` (2): `web3_clientVersion`, `web3_sha3`
- `txpool_*` (3): `txpool_content`, `txpool_inspect`, `txpool_status`
- `debug_*` (4): `debug_traceBlockByHash`, `debug_traceBlockByNumber`, `debug_traceCall`, `debug_traceTransaction`
- `trace_*` (2): `trace_block`, `trace_transaction`

목록에 없는 메서드 또는 경로에는 HTTP `400`으로 응답합니다.

### 응답 상태 코드

| HTTP 상태 | 의미 |
| --- | --- |
| 200 | 업스트림 JSON-RPC 응답. JSON-RPC 오류도 HTTP `200`으로 반환됨. 요청의 `id`와 `error.code`는 유지되고, `error.message`는 `ERPC upstream error`이며, `error.data`는 반환되지 않음 |
| 400 | 지원 메서드 목록에 없는 메서드 또는 경로, 잘못된 JSON-RPC 요청, 빈 배치 또는 100개를 초과하는 배치, 배치 내 중복된 `id`, 1 MiB를 초과하는 본문 |
| 401 | API key가 없거나 유효하지 않거나, key에 설정된 IP 또는 Origin 제한을 충족하지 않음 |
| 405 | POST 이외의 요청 메서드 |
| 426 | WebSocket Upgrade가 요청됨. 이 엔드포인트는 HTTP만 지원함 |
| 429 | 속도 제한됨. 위의 Free 요금제 제한(10초당 요청 한 건 초과, 또는 한 요청에 호출 두 개 이상)도 포함됨. `retry-after` 헤더가 있으면 표시된 시간(초)만큼 대기 |
| 502 | 업스트림 요청을 완료할 수 없음: 업스트림 응답 실패, 8 MiB를 초과하는 응답, 또는 30초 이내 무응답 |
| 503 | 서비스를 일시적으로 사용할 수 없음 |

### BNB Smart Chain RPC 메서드 및 문서

표준 메서드, 매개변수, 사양의 전체 목록은 공식 문서를 참고하세요.

[https://docs.bnbchain.org/bnb-smart-chain/developers/json_rpc/json-rpc-endpoint/](https://docs.bnbchain.org/bnb-smart-chain/developers/json_rpc/json-rpc-endpoint/)
