메인 콘텐츠로 건너뛰기

속도 제한이란?

속도 제한은 초당 요청할 수 있는 횟수를 제어합니다. 속도 제한을 초과하면 HTTP 429 응답을 받게 됩니다. 429 또는 기타 일시적 오류가 발생했을 때 취할 조치에 대한 지침은 아래의 재시도 및 오류 처리를 참조하십시오.

표준 속도 제한

귀하의 계획에는 RPC 요청과 DAS API 요청을 위한 두 가지 표준 속도 제한 그룹이 있습니다. 각 Helius 계획에 대한 기본 속도 제한은 다음과 같습니다.
계획RPC 속도 제한DAS 및 향상된 API
무료10 요청/s2 요청/s
개발자50 요청/s10 요청/s
기업200 요청/s50 요청/s
전문가500 요청/s100 요청/s
엔터프라이즈맞춤형맞춤형

속도 제한 상향

Professional 요금제를 사용하는 팀은 월 $100 USD에 100 RPS를 추가로 구매할 수 있습니다. 출시 전에 맞춤형 속도 제한이 필요하시면 영업팀에 연락하십시오. 개발자 또는 비즈니스 등급에 있는 경우 계획을 업그레이드하여 속도 제한을 증가시키십시오.

특별 속도 제한

일부 엔드포인트 및 전문 Helius 제품은 계산 요구 사항으로 인해 특별 속도 제한이 적용됩니다.

거래 전송

엔드포인트무료개발자기업전문가
Sender50/sec50/sec50/sec50/sec
sendTransaction1/sec5/sec50/sec100/sec
sendBundle——5/sec5/sec
simulateBundle10/sec50/sec200/sec500/sec
Sender의 키 없는 /fast 요청은 리전별 송신 IP당 초당 1개로 제한됩니다. 동일한 NAT 뒤에 있는 호출자는 이 제한을 공유합니다. 거부된 429 요청도 제한에 포함되지만 /ping은 포함되지 않습니다. 기존 Helius 프로젝트 API 키를 추가하면 키별, 리전별 초당 50개 제한이 적용됩니다.
Professional 요금제를 사용 중이며 sendTransaction 속도 제한을 상향해야 한다면 영업팀에 문의하세요. Professional 요금제 사용자는 처리량이 더 높은 트레이딩 앱을 지원하도록 Sender의 속도 제한 상향과 사용자 지정 팁 구성을 요청할 수도 있습니다.

복잡한 RPC 호출

엔드포인트무료DeveloperBusinessProfessional
getProgramAccounts초당 5개초당 25개초당 50개초당 75개

과거 데이터

과거 데이터 메서드를 일괄 요청할 때는 다음 제한이 적용됩니다.
메서드최대 배치 크기
getTransaction요청당 100개 항목
getTransactionsForAddress일괄 요청 허용 안 됨
getTransfersByAddress일괄 요청 허용 안 됨
기타 모든 과거 데이터 메서드요청당 10개 항목
배치 제한을 초과하면 오류 응답이 반환됩니다. getTransactionsForAddress 및 getTransfersByAddress의 경우 각 주소를 별도의 요청으로 조회해야 합니다.

LaserStream

리소스무료DeveloperBusinessProfessional
네트워크—DevnetDevnet, MainnetDevnet, Mainnet
최대 공개 키 수—10M10M10M
활성 연결——10100

Wallet API

Wallet API는 DAS 및 Enhanced API와 동일한 속도 제한을 따릅니다. 모든 엔드포인트가 다음 제한을 공유합니다.
엔드포인트무료DeveloperBusinessProfessional
모든 Wallet API 엔드포인트초당 2개초당 10개초당 50개초당 100개
여기에는 ID 조회, 잔액, 내역, 전송 및 자금 출처 엔드포인트가 포함됩니다. 자세한 내용은 Wallet API 문서를 참조하세요.

파싱된 스트림

리소스무료DeveloperBusinessProfessional
동시 연결5105050
연결당 구독 수25252525
연결 수는 프로젝트의 모든 API 키를 통틀어 프로젝트별로 계산됩니다. 연결 한도에 도달한 프로젝트에는 HTTP 429가 반환됩니다. 필터별 제한과 메시지 제한은 파싱된 스트림 제한을 참조하세요.

LaserStream WebSocket

리소스무료DeveloperBusinessProfessional
동시 연결51502501,000
연결당 구독 수1,0001,0001,0001,000
WebSocket 유형표준표준, 향상표준, 향상표준, 향상

웹훅

리소스무료DeveloperBusinessProfessional
최대 웹훅 수5505050
웹훅당 주소 수100k100k100k100k

ZK 압축

서비스무료DeveloperBusinessProfessional
Photon API초당 2개초당 10개초당 50개초당 100개
getValidityProof초당 1개초당 5개초당 10개초당 20개

재시도 및 오류 처리

애플리케이션이 429 Too Many Requests, 503 Service Unavailable 또는 일시적인 5xx 응답을 받으면 잠시 기다린 후 재시도하세요. 즉시 재시도하지 마세요. 즉시 재시도하면 요청이 누적되어 속도 제한에서 복구되는 속도가 빨라지는 대신 느려집니다.

권장 전략

  • 첫 번째 재시도 전에 약 1초 기다리세요.
  • 재시도할 때마다 대기 시간을 두 배로 늘리되 최대 30초까지만 늘리세요.
  • 여러 애플리케이션이 모두 같은 순간에 재시도하지 않도록 각 대기 시간에 **±25%**의 작은 무작위 변동을 추가하세요.
  • 5번 시도한 후에는 중단하고 호출한 코드에 오류를 반환하세요.

재시도할 오류

예시

오류 응답 형식

모든 Helius API는 오류 발생 시 구조화된 JSON 본문을 반환합니다. JSON-RPC 엔드포인트(Solana RPC, DAS, Sender, Priority Fee, ZK 압축)는 표준 JSON-RPC 2.0 엔벌로프를 반환합니다.
REST 엔드포인트(Wallet API, Admin API)는 다음을 반환합니다.
전체 오류 코드 목록과 각 코드의 의미는 일반적인 오류 코드를 참조하세요.