빠른 시작

이 가이드를 끝내면 다음이 준비되어 있습니다:

API 키 (또는 OAuth 토큰)
ChainStream REST API에 대한 동작하는 호출
ChainStream SDK, CLI, MCP Server에 대한 동작하는 호출
다음 단계 — REST / GraphQL / WebSocket / Kafka / SDK / CLI / MCP 중 어떤 것이 당신의 워크로드에 가장 적합한지

예상 시간: 5분.

전제 조건

ChainStream 계정. 아직 없다면 여기에서 가입하세요.

1. API 키 받기

ChainStream Dashboard를 엽니다.
Applications로 이동합니다.
Create New App을 클릭합니다.
생성된 API Key (cs_live_…로 시작)를 복사합니다.

API 키는 가장 빠른 인증 방법입니다. 머신 간 (M2M) 시나리오에서는 OAuth 2.0 client-credentials 흐름을 사용하세요 — API 키 & OAuth 참고.

2. 첫 요청 보내기

다음 예제는 Solana의 Wrapped SOL 메타데이터를 가져옵니다. 통합 방식에 맞는 인터페이스를 선택하세요:

cURL
SDK (TypeScript)
CLI
MCP (AI 에이전트)
OAuth 2.0 (JWT)

curl "https://api.chainstream.io/v2/token/solana/So11111111111111111111111111111111111111112/metadata" \
  -H "X-API-KEY: your_api_key"

import { ChainStreamClient } from "@chainstream-io/sdk";

const cs = new ChainStreamClient({ apiKey: "your_api_key" });

const token = await cs.token.getToken(
  "So11111111111111111111111111111111111111112",
  "solana",
);

console.log(token.name, token.symbol, token.decimals);

Python, Go, Rust는 SDK 개요 참고.

# 설치 불필요 — npx가 최신 CLI를 받아옵니다.
npx @chainstream-io/cli token info \
  --chain solana \
  --address So11111111111111111111111111111111111111112

첫 실행 시 키 입력을 요구합니다. 명시적으로 설정할 수도 있습니다:

npx @chainstream-io/cli config set --key apiKey --value your_api_key

CHAINSTREAM_API_KEY=your_api_key npx @chainstream-io/mcp

그런 다음 AI 에이전트에게 “What is the SOL token on Solana?” 라고 물어보세요 — 올바른 도구를 호출합니다.Claude / Cursor / ChatGPT 설정은 MCP Server 셋업 참고.

OAuth 2.0 Client Credentials 흐름:

curl -X POST "https://dex.asia.auth.chainstream.io/oauth/token" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "audience": "https://api.dex.chainstream.io",
    "grant_type": "client_credentials"
  }'

curl "https://api.chainstream.io/v2/token/solana/So11111111111111111111111111111111111111112/metadata" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

응답

{
  "chain": "solana",
  "address": "So11111111111111111111111111111111111111112",
  "name": "Wrapped SOL",
  "symbol": "SOL",
  "decimals": 9,
  "imageUrl": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png",
  "tokenCreatedAt": 1710417600000
}

필드	타입	설명
`chain`	string	블록체인 식별자, 소문자.
`address`	string	토큰 컨트랙트 주소.
`name`	string	사람이 읽을 수 있는 토큰명.
`symbol`	string	티커 심볼.
`decimals`	integer	토큰 소수점.
`imageUrl`	string	공식 로고 URL (null 가능).
`tokenCreatedAt`	integer	생성 타임스탬프 (ms).

3. 적합한 접속 방법 선택

방금 하나의 요청-응답 호출을 했을 뿐입니다. 실제 통합은 보통 더 많은 것을 필요로 합니다:

REST API

온디맨드 조회 — 토큰, 지갑, 풀, 거래, 컴플라이언스.

GraphQL

전체 체인 데이터 cube에 대한 유연한 분석 쿼리.

WebSocket

라이브 UI와 브라우저 앱을 위한 서브초 푸시.

Kafka Streams

백엔드, 인덱서, 트레이딩 엔진을 위한 exactly-once 전달.

SDK

TypeScript, Python, Go, Rust — 인증이 내장된 타입드 클라이언트.

CLI

스크립팅, CI/CD, AI 에이전트를 위한 건별 과금 접근.

문제 해결

401 Unauthorized

X-API-KEY 또는 Authorization: Bearer … 헤더가 올바르게 있는지 확인하세요.
키가 로테이션되었다면 재생성하세요.
OAuth에서는 토큰이 만료되지 않았는지 확인하세요 (기본 TTL은 1시간).

429 Too Many Requests

플랜의 레이트 제한에 도달했습니다. 무료 플랜은 10 req/s부터입니다. 플랜 업그레이드 또는 지수 백오프를 사용하세요. 자세한 내용은 플랜 & 유닛.

다른 체인의 토큰은 어떻게 쿼리하나요?

URL의 체인 식별자를 바꾸세요: solana, ethereum, bsc, base, polygon, arbitrum, optimism, avalanche, zksync, tron. 전체 목록은 지원 체인.

다음 단계

데이터 카탈로그 살펴보기

저희가 게시하는 모든 데이터셋과 커버리지, 갱신 주기.

실시간 스트림 시작

라이브 거래, 가격, 전송, 풀 이벤트 구독.

컴플라이언스 체크 실행

전송, 출금, 카운터파티에 대한 KYT / KYA.

AI 에이전트 만들기

MCP + Agent Skills로 Claude, Cursor, ChatGPT 연결.

데이터 제품

접속 방법

AI Agents

컴플라이언스 (KYT/KYA)

튜토리얼

레시피

플랫폼

에코시스템

레퍼런스

전제 조건

1. API 키 받기

2. 첫 요청 보내기

응답

3. 적합한 접속 방법 선택

REST API

GraphQL

WebSocket

Kafka Streams

SDK

CLI

문제 해결

다음 단계

데이터 카탈로그 살펴보기

실시간 스트림 시작

컴플라이언스 체크 실행

AI 에이전트 만들기

데이터 제품

접속 방법

AI Agents

컴플라이언스 (KYT/KYA)

튜토리얼

레시피

플랫폼

에코시스템

레퍼런스

​전제 조건

​1. API 키 받기

​2. 첫 요청 보내기

​응답

​3. 적합한 접속 방법 선택

REST API

GraphQL

WebSocket

Kafka Streams

SDK

CLI

​문제 해결

​다음 단계

데이터 카탈로그 살펴보기

실시간 스트림 시작

컴플라이언스 체크 실행

AI 에이전트 만들기

전제 조건

1. API 키 받기

2. 첫 요청 보내기

응답

3. 적합한 접속 방법 선택

문제 해결

다음 단계