---
title: "Documentação do BNB Smart Chain RPC endpoint"
description: "Use a ERPC como seu BNB Smart Chain (BSC) RPC endpoint para requisições HTTP JSON-RPC."
canonical: "https://erpc.global/pt/doc/bsc-rpc/general/"
locale: "pt"
---

# Documentação do BNB Smart Chain RPC endpoint

## Documentação do BNB Smart Chain RPC endpoint

Use a ERPC como seu BNB Smart Chain RPC endpoint para requisições HTTP JSON-RPC. O BNB Smart Chain RPC faz parte das RPC APIs da ERPC dentro da nossa Global Edge Blockchain Infrastructure, e a API key pode ser gerenciada no ERPC Web Dashboard.

Você pode usar a mesma RPC key da Solana, do Ethereum e da Avalanche.

Passe sua API key no parâmetro de query `api-key` ou envie-a como `Authorization: Bearer <YOUR_API_KEY>`. Quando os dois estão presentes, o parâmetro de query é usado.

### Endpoints

Envie requisições JSON-RPC 2.0 como HTTP POST para:

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

ou para o host dedicado:

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

As requisições são aceitas apenas em `/`.

### Exemplos

Aqui está um exemplo de requisição HTTP com a API key no parâmetro de query.

```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"
}'
```

Aqui está a mesma requisição com a API key no cabeçalho `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"
}'
```

Você pode obter e verificar sua API key no ERPC Web Dashboard: [ERPC Web Dashboard](https://dashboard.erpc.global/pt)

### Requisições em lote

Lotes de JSON-RPC com 1 a 100 chamadas por requisição HTTP são suportados. Cada chamada precisa do seu próprio `id`, e os valores de `id` não podem se repetir dentro de um lote. Cada chamada em um lote é medida como uma chamada individual. O corpo da requisição pode ter até 1 MiB.

### Medição de uso

O uso é medido em tokens, e a taxa de tokens pode variar conforme o método. Cada chamada em um lote HTTP é medida separadamente.

### Limites do Plano Free

No Plano Free, sua conta pode enviar uma requisição a cada 10 segundos. O limite é contado por conta, e não por endpoint, então uma requisição a outra chain também pode contar para ele. Uma requisição enviada antes disso é respondida com HTTP `429`, e o cabeçalho `retry-after` informa a espera em segundos.

No Plano Free, uma requisição que contém duas ou mais chamadas JSON-RPC é respondida com HTTP `429`, e nenhuma de suas chamadas é enviada: cada chamada recebe um erro JSON-RPC com o código `-32041`. Envie essas chamadas uma de cada vez.

### Métodos suportados

O endpoint atende estes 38 métodos, agrupados por namespace.

- `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`

Um método ou caminho que não esteja listado é respondido com HTTP `400`.

### Códigos de status de resposta

| Status HTTP | Significado |
| --- | --- |
| 200 | Resposta JSON-RPC do upstream. Um erro JSON-RPC também é retornado com HTTP `200`: ele mantém o `id` da requisição e o `error.code`, seu `error.message` é `ERPC upstream error`, e `error.data` não é retornado. |
| 400 | Um método ou caminho fora da lista de métodos suportados, uma requisição JSON-RPC inválida, um lote vazio ou com mais de 100 chamadas, um `id` duplicado em um lote, ou um corpo acima de 1 MiB. |
| 401 | API key ausente ou inválida, ou uma restrição de IP ou de Origin definida na key não foi atendida. |
| 405 | Um método de requisição diferente de POST. |
| 426 | Foi solicitado um WebSocket Upgrade. O endpoint atende apenas HTTP. |
| 429 | Limitado por taxa, incluindo os limites do Plano Free acima: mais de uma requisição a cada 10 segundos, ou duas ou mais chamadas em uma requisição. Se houver um cabeçalho `retry-after`, aguarde o número de segundos indicado. |
| 502 | A requisição upstream não pôde ser concluída: uma resposta upstream com falha, uma resposta acima de 8 MiB, ou nenhuma resposta em até 30 segundos. |
| 503 | O serviço está temporariamente indisponível. |

### Métodos e Documentação BNB Smart Chain RPC

Para a lista completa de métodos padrão, parâmetros e especificações, consulte a documentação oficial.

[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/)
