Docs
요금GitHub대시보드

문서

시작하기

대시보드에서 엔드포인트를 만들고 관리형 풀 노드에 JSON-RPC를 보내 보세요.

첫 웹훅 받기

테스트넷 주소를 감시하고 입금 시 서명된 알림을 받아 보세요.

테스트넷 전송으로 시작하기

1. 엔드포인트 만들기

RpcNode에 회원가입한 뒤 네트워크와 환경을 선택하면 엔드포인트 UUID가 발급됩니다.

대시보드 열기

2. 엔드포인트 URL

HTTPS JSON-RPC URL은 네트워크 슬러그, 환경, 엔드포인트 UUID로 구성되며 대시보드와 같은 값을 사용합니다(예: ethereum + mainnet).

형식

https://{prefix}-{network}-{environment}.rpcnode.dev/{endpoint-uuid}

예시

https://holy-burned-sky-ethereum-mainnet.rpcnode.dev/7c9e6679-7425-40de-944b-e07fc1f90ae7

3. 첫 요청

Content-Type: application/json 헤더와 함께 표준 JSON-RPC 2.0 POST 요청을 보내세요.

curl 예시

curl https://holy-burned-sky-ethereum-mainnet.rpcnode.dev/7c9e6679-7425-40de-944b-e07fc1f90ae7 \
  -X POST \
  -H 'content-type: application/json' \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_blockNumber",
  "params": []
}'

요청 제한 (RPS)

각 엔드포인트에는 요금제에 따른 초당 요청 수(RPS) 제한이 있습니다. 제한을 초과하면 게이트웨이가 HTTP 429와 JSON-RPC 오류 코드 -32005를 반환합니다.

카운터는 엔드포인트별로 집계되며 Unix 초마다 초기화됩니다(1초 고정 구간). 내 제한은 대시보드와 요금 페이지에서 확인할 수 있습니다.

RPS 초과로 거부된 요청은 크레딧을 소모하지 않으며 사용량 통계에도 포함되지 않습니다.

응답 예시

HTTP/1.1 429 Too Many Requests
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": null,
  "error": {
    "code": -32005,
    "message": "rps limit exceeded"
  }
}

가이드 — RpcNode 풀 노드에서 최신 블록, 블록과 트랜잭션, 잔액을 조회하는 복사해서 쓸 수 있는 예제 모음입니다. 문서 카탈로그의 모든 주요 네트워크 계열을 다룹니다.

오류 — 문서 카탈로그의 모든 네트워크 계열에서 나타나는 RpcNode 게이트웨이의 주요 응답으로, HTTP 상태 코드와 JSON-RPC 오류 코드를 정리했습니다.

Public API — 결제, 요금제와 사용량, 네트워크와 가격, RPC 엔드포인트, 주소 및 트랜잭션 감시, 웹훅, 블록 이벤트, WebSocket을 위한 서명 기반 HTTP API입니다.

네트워크와 메서드

왼쪽 메뉴에서 네트워크와 RPC 메서드를 찾을 수 있습니다. 크레딧은 결제 API에서, 매개변수 문서는 콘텐츠 카탈로그에서 가져옵니다.

상태와 지연 시간

RpcNode 사이트에서 공개하는 최신 블록 확인 기반의 상태 및 지연 시간 표로, 네트워크가 정상 응답하는지 확인할 때 유용합니다.