빠른 비교
| REST API | GraphQL API | WebSocket | MCP Tools | CLI | |
|---|---|---|---|---|---|
| 최적 용도 | 간단한 쿼리, 시스템 통합 | 유연한 분석, 커스텀 집계 | 실시간 가격 및 거래 스트림 | AI 에이전트 통합 | 스크립트, CI/CD, 터미널 워크플로우 |
| 엔드포인트 | 56개 /v2/* 경로 | 단일 엔드포인트 | wss://realtime-dex.chainstream.io/... | MCP 프로토콜 통해 | npx @chainstream-io/cli |
| 인증 | X-API-KEY 헤더 | X-API-KEY 헤더 | URL ?token= 파라미터 | Bearer Token | cli login / API Key |
| 응답 | 고정 JSON 스키마 | 클라이언트 선택 필드 | 실시간 푸시 | 구조화된 도구 결과 | JSON / 테이블 출력 |
| 집계 | 사전 정의 엔드포인트 | count / sum / avg / min / max / uniq | 없음 | 기본 API에 따라 다름 | 없음 |
| 체인 | sol / eth / bsc | sol / eth / bsc | sol / eth / bsc | sol / eth / bsc | sol / eth / bsc |
| SDK | TS / Python / Go / Rust | 모든 GraphQL 클라이언트 | TS SDK 내장 | MCP 클라이언트 | N/A |
각 방식의 사용 시점
REST API
사용 시점: 토큰 가격, 지갑 잔액, 거래 목록 등 빠르고 구체적인 데이터 조회가 필요하고 예측 가능한 응답 스키마를 원할 때.예시: dApp에서 토큰 정보 표시, 지갑 PnL 확인, 랭킹 목록 가져오기.REST API 레퍼런스
GraphQL API
사용 시점: 유연한 분석 쿼리가 필요할 때 — 거래 집계, 다차원 필터링, 필요한 필드만 선택.예시: 거래량 기준 상위 트레이더, OHLC 캔들스틱 데이터, 토큰 홀더 분포 분석.GraphQL 개요
WebSocket
사용 시점: 애플리케이션에 실시간 데이터 푸시가 필요할 때 — 가격 틱, 새로운 거래, 지갑 활동 변화.예시: 실시간 가격 피드, 거래 활동 스트림, 새 토큰 생성 알림.실시간 스트리밍
MCP Tools
사용 시점: 자연어 또는 구조화된 도구 호출을 통해 온체인 데이터를 조회하는 AI 에이전트를 구축할 때.예시: Claude / GPT의 토큰 보안 분석, AI 어시스턴트의 스마트 머니 추적, 자동화 리서치 워크플로우.MCP 서버 소개
인터페이스별 데이터 범위
모든 인터페이스는 동일한 기본 데이터 파이프라인을 공유하며 3개 체인(Solana, Ethereum, BSC)을 모두 지원합니다.| 데이터 유형 | REST | GraphQL | WebSocket | MCP |
|---|---|---|---|---|
| 토큰 메타데이터 및 가격 | 예 | 예 (DEXTrades, TokenSearch) | 예 (Token 시리즈) | 예 (token_get_price) |
| 거래 내역 | 예 | 예 (DEXTrades) | 예 (Trade 시리즈) | 예 (trade_get) |
| 지갑 잔액 및 PnL | 예 | 예 (BalanceUpdates, WalletTokenPnL) | 예 (Wallet 시리즈) | 예 (wallet_get_balance) |
| OHLCV / K-line | 예 | 예 (OHLC) | 예 (Candle 시리즈) | 예 (token_get_candles) |
| 토큰 홀더 | 예 | 예 (TokenHolders) | 아니오 | 예 (token_get_holders) |
| DEX 풀 유동성 | 예 | 예 (DEXPools, PoolLiquiditySnapshots) | 예 (DexPool 시리즈) | 예 (dexpool_get) |
| 랭킹 (핫, 신규) | 예 | 아니오 | 예 (Ranking 시리즈) | 예 (ranking_get_hot_tokens) |
| DeFi 스왑 / 생성 | 예 | 아니오 | 아니오 | 예 (dex_swap, pumpfun_create) |
| KYT / 컴플라이언스 | 예 | 아니오 | 아니오 | 아니오 |
| Webhook 관리 | 예 | 아니오 | 아니오 | 예 (webhook_*) |
다음 단계
빠른 시작
5분 만에 첫 번째 API 호출하기.
GraphQL 첫 번째 쿼리
첫 번째 GraphQL 쿼리 실행하기.
지원 체인
지원되는 모든 체인과 DEX 확인하기.