Skip to main content
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 키를 받을 수 있습니다.
성공 시 (--resume 또는 --pay), 에이전트는 API 키, RPC 엔드포인트, 1,000,000 크레딧을 받게 됩니다. 자세한 내용은 전체 CLI 가이드를 참조하세요.

인증

모든 Helius API 요청에는 쿼리 매개변수로 전달되는 API 키가 필요합니다:
이를 모든 RPC 또는 API 엔드포인트에 추가하십시오. 예를 들어: https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY Helius Dashboard에서 또는 Helius CLI를 통해 프로그래밍 방식으로 API 키를 얻으십시오.
더 낮은 대기 시간을 위해 Gatekeeper를 사용하세요Gatekeeper (Beta)는 중요한 경로에서 Cloudflare를 제거하여 응답 시간을 수십에서 수백 밀리초로 줄입니다. 동일한 API 키, 동일한 메서드 — 단순히 엔드포인트를 교체하세요:
모든 RPC, DAS, WebSocket, ZK Compression, Priority Fee 및 Enhanced Transaction 메서드를 지원합니다. 자세한 내용은 마이그레이션 가이드를 참조하세요.

Helius 전용 API 가이드

표준 Solana RPC 메서드를 체인으로 연결하는 대신 다음의 Helius 최적화 API를 사용하십시오:

권장 워크플로우

포트폴리오 요약을 위해 Wallet API Balances 사용 시: API는 베타이며; 토큰은 페이지당 100개로 제한됨; NFTs는 showNfts=true (첫 페이지에 최대 100개 NFT만) 없이 제외됨; pricePerTokenusdValue는 null일 수 있음; 가격은 실시간 시장 가격이 아닌 시간별 추정치임; totalUsdValue는 현재 페이지를 다루며, 전체 페이지네이션된 포트폴리오는 아님; 각 요청은 100 크레딧이 소요됨. 전체 NFT 인벤토리 및 메타데이터를 위해 페이지네이션된 DAS를 사용하고 Balances를 전체 NFT 인벤토리로 간주하지 마십시오.

속도 제한 빠른 참조

속도 제한은 계획에 따라 다릅니다. 에이전트는 1,000,000 크레딧으로 에이전트 계층에서 시작합니다. 에이전트 계층은 남용 방지를 위해 $1 지불이 필요합니다. API별 자세한 속도 제한은 속도 제한을 참조하세요.

API 호출당 크레딧

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

재시도 및 오류 처리

HTTP 상태 코드

재시도 패턴

크레딧 사용량 모니터링

빠른 참조

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