Skip to main content

GraphQL 엔드포인트

모든 GraphQL 쿼리는 단일 엔드포인트로 전송됩니다:
POSTGET 메서드 모두 지원됩니다.
프로덕션 워크로드에는 POST를 사용하세요. GET 요청은 쿼리를 URL에 인코딩하므로 길이 제한이 있고 복잡한 쿼리가 다루기 어려워집니다.

인증

X-API-KEY 헤더에 API Key를 전달하여 인증합니다. REST Data API와 동일한 API Key를 사용하므로 별도의 자격 증명이 필요하지 않습니다.
ChainStream DashboardApplicationsCreate New App에서 API Key를 발급받으세요. 키는 cs_live_...로 시작합니다.

필수 헤더


요청 형식

GraphQL 요청 본문은 두 개의 필드를 가진 JSON 객체입니다:

POST 예제

GET 예제


지원 네트워크

Cube 쿼리를 적절한 Chain Group으로 감싸서 네트워크를 선택합니다:

응답 형식

모든 응답은 다음 구조의 JSON입니다:
extensions.credits 필드는 크레딧이 소비될 때 포함됩니다. 크레딧 계산 방법에 대한 자세한 내용은 빌링 & 크레딧을 참조하세요.

오류 응답

쿼리가 잘못되었거나 실패하면 응답에 errors 배열이 포함됩니다:
애플리케이션에 통합하기 전에 GraphQL IDE를 사용하여 쿼리를 인터랙티브하게 검증하세요. IDE는 자동 완성과 인라인 오류 강조 기능을 제공합니다.

다음 단계

첫 번째 쿼리 실행

IDE 또는 cURL에서 실제 쿼리를 실행하는 단계별 튜토리얼을 따라해 보세요.

스키마 탐색

25개 Cube, 필드 타입, 필터링 연산자, 집계 함수를 살펴보세요.