메인 콘텐츠로 건너뛰기
Helius는 Solana에서 AI 에이전트를 구축하기 위한 최상의 지원을 제공합니다. 프로그래밍 방식의 계정 생성부터 실시간 데이터 스트리밍까지, 에이전트는 수동 개입 없이 Helius의 모든 기능에 접근할 수 있습니다.
  • Helius MCP — 블록체인 쿼리, 트랜잭션 전송, 스트리밍 등을 다루는 10개의 라우팅된 도구
  • Claude Code Plugin — 암호화폐 회사에서 제공하는 최초이자 현재 유일한 공식 Claude Code 플러그인. 한 번의 설치: MCP 서버 + 스킬 + 참조 파일
  • Skills — Claude를 위한 전문가 지침 세트: Build, Phantom, Jupiter, DFlow, OKX, SVM
  • TypeScript SDK — 모든 Helius API에 대한 타입 안전 메소드
  • Rust SDK — Helius API를 위한 고성능 Rust SDK
  • Helius CLI — 계정 관리 및 셸 스크립팅
이 섹션의 기계 판독용 버전은 AI 에이전트 소비를 위해 agents/llms.txt에서 제공됩니다.

MCP vs CLI

Helius MCP 서버는 AI 에이전트가 Helius와 상호작용하는 권장 방법입니다. 이는 AI에게 Solana에 대한 직접적이고 구조적인 접근을 제공하는 10개의 라우팅된 도구를 제공합니다 — 셸 명령 없음, 출력 파싱 없음, 수동 API 호출 없음.
MCP로 시작하세요. AI 도구가 MCP(Claude Code, Cursor, Claude Desktop 등)를 지원하는 경우 MCP 서버나 Claude Code Plugin을 사용하세요. CLI는 셸 스크립팅 및 CI/CD에 유용하지만, AI 중심 워크플로우에는 MCP가 더 원활한 경험을 제공합니다 — AI가 셸 명령 생성을 대신해 도구를 직접 호출합니다.

빠른 시작: 에이전트 가입

에이전트는 Helius CLI를 사용하여 Helius 계정을 만들고 API 키를 받을 수 있습니다.
Agent 요금제를 포함한 모든 신규 가입에는 이메일 주소, 이름, 성이 필요합니다. 지갑은 결제에만 사용됩니다.
성공하면(--resume 또는 --pay) 에이전트가 API 키, RPC 엔드포인트, 1,000,000크레딧을 받습니다. 자세한 내용은 전체 CLI 가이드를 참조하세요.

인증

모든 Helius API 요청에는 쿼리 매개변수로 전달되는 API 키가 필요합니다.
이를 RPC 또는 API 엔드포인트에 추가하세요. 예: https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY Helius 대시보드에서 API 키를 받거나 Helius CLI를 통해 프로그래밍 방식으로 받으세요.
Gatekeeper로 지연 시간을 단축하세요 — Gatekeeper(베타)는 핵심 경로에서 Cloudflare를 제거하여 응답 시간을 수십~수백 밀리초 단축합니다. 동일한 API 키와 메서드를 사용하며 엔드포인트만 변경하면 됩니다.
모든 RPC, DAS, WebSocket, ZK 압축, 우선순위 수수료, 향상된 트랜잭션 메서드를 지원합니다. 자세한 내용은 마이그레이션 가이드를 참조하세요.

Helius 전용 API 지침

표준 Solana RPC 메서드를 연속으로 호출하는 대신 다음과 같이 Helius에 최적화된 API를 사용하세요.

권장 워크플로

포트폴리오 요약에 Wallet API 잔액을 사용할 때는 다음 사항에 유의하세요. 이 API는 베타입니다. 토큰은 페이지당 100개로 제한됩니다. showNfts=true을 사용하지 않으면 NFT는 제외되며, 사용하더라도 첫 페이지에 최대 100개의 NFT만 포함됩니다. pricePerToken 및 usdValue은 null일 수 있습니다. 가격은 시간별 추정치이며 실시간 시장 가격이 아닙니다. totalUsdValue은 페이지네이션된 전체 포트폴리오가 아니라 현재 페이지만 대상으로 합니다. 각 요청에는 100크레딧이 사용됩니다. 전체 NFT 인벤토리와 메타데이터에는 페이지네이션된 DAS를 사용하세요. Balances를 전체 NFT 인벤토리로 간주하지 마세요.

속도 제한 빠른 참조

속도 제한은 요금제에 따라 다릅니다. 에이전트는 1,000,000크레딧이 제공되는 Agent 등급에서 시작합니다. Agent 등급에는 $10 USDC 일회성 결제가 필요하며, 모든 신규 가입 시 이메일, 이름, 성을 입력해야 합니다.
달러로 표시된 모든 가격은 미국 달러(USD) 기준입니다.
API별 자세한 속도 제한은 속도 제한을 참조하세요.

API 호출당 크레딧

전체 세부 내역은 크레딧을 참조하세요.

재시도 및 오류 처리

HTTP 상태 코드

재시도 패턴

크레딧 사용량 모니터링

빠른 참조

  • 메인넷 RPC: https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • 메인넷 RPC(Gatekeeper 베타): https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
  • 개발넷 RPC: https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • 메인넷 WSS: wss://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • 메인넷 WSS(Gatekeeper 베타): wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY
  • 개발넷 WSS: wss://devnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • Sender 엔드포인트: https://sender.helius-rpc.com/fast
  • MCP 서버: https://www.helius.dev/docs/mcp
  • 대시보드: dashboard.helius.dev
  • 상태: helius.statuspage.io