빠른 시작

학습 내용

이 튜토리얼을 완료하면 다음을 할 수 있게 됩니다:

API Key 또는 OAuth 토큰을 사용하여 ChainStream 인증
API를 호출하여 토큰 메타데이터 가져오기
CLI와 SDK로 동일한 쿼리 수행
API 응답 구조 이해

예상 시간: 5분

사전 요구사항

등록된 ChainStream 계정 (여기서 등록)

1단계: API Key 발급

ChainStream 대시보드에 로그인
Applications으로 이동
Create New App 클릭
API Key를 복사 (cs_live_...로 시작)

API Key는 가장 빠른 인증 방법입니다. OAuth 2.0 JWT 플로우에 대해서는 인증을 참고하세요.

2단계: 첫 번째 요청 보내기

Solana의 SOL 토큰 메타데이터를 조회합니다. 선호하는 방법을 선택하세요:

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

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

# npx로 원라인 실행 (설치 불필요)
npx @chainstream-io/cli token info --chain sol \
  --address So11111111111111111111111111111111111111112

CLI는 첫 실행 시 인증을 요청합니다. 또는 사전에 키를 설정할 수 있습니다:

npx @chainstream-io/cli config set --key apiKey --value 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);

코드 없이 AI 에이전트를 ChainStream 데이터에 연결하세요:

CHAINSTREAM_API_KEY=your_api_key npx @chainstream-io/mcp

그런 다음 AI에게 물어보세요: “Solana의 SOL 토큰은 무엇인가요?”Claude/Cursor 설정은 MCP 서버 설정을 참고하세요.

OAuth 2.0 Client Credentials 플로우를 사용하는 앱의 경우:

# 1단계: 액세스 토큰 발급
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"
  }'

# 2단계: 토큰 사용
curl "https://api.chainstream.io/v2/token/sol/So11111111111111111111111111111111111111112" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

YOUR_ACCESS_TOKEN을 2단계에서 생성한 토큰으로 교체하세요.

응답 예시

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

4단계: 응답 이해하기

필드	타입	설명
`chain`	string	블록체인 네트워크 식별자
`decimals`	integer	토큰 소수점 자릿수
`name`	string	토큰 이름
`symbol`	string	토큰 심볼
`address`	string	토큰 컨트랙트 주소
`imageUrl`	string	토큰 로고 URL
`tokenCreatedAt`	integer	토큰 생성 타임스탬프 (밀리초)

전체 필드 설명은 토큰 메타데이터 API 레퍼런스를 참고하세요.

5단계: 더 많은 API 시도하기

첫 번째 호출을 성공적으로 완료했다면, 다음 API를 시도해 보세요:

토큰 가격 조회

실시간 토큰 가격 조회GET /v1/token/{chain}/{tokenAddress}/price

지갑 잔액 조회

지갑 토큰 보유량 조회GET /v1/wallet/{chain}/{walletAddress}/balance

자주 발생하는 문제

401 Unauthorized 오류

다음을 확인하세요:

Access Token이 올바르고 만료되지 않았는지?
Header 형식이 Authorization: Bearer YOUR_ACCESS_TOKEN인지?
Client ID와 Client Secret을 사용하여 새 토큰을 생성해 보세요

429 Too Many Requests 오류

요청 속도 제한에 도달했습니다. 무료 플랜은 10 요청/초로 제한됩니다. 플랜을 업그레이드하여 제한을 늘릴 수 있습니다.자세한 내용은 API 보안을 참고하세요.

다른 체인의 토큰은 어떻게 조회하나요?

URL의 체인 파라미터를 변경하세요. 예:GET /v1/token/eth/{address}/metadata (Ethereum)GET /v1/token/bsc/{address}/metadata (BSC)전체 목록은 실시간 스트리밍을 참고하세요.

다음 단계

사용 사례에 따라 다음 학습 경로를 선택하세요:

데이터 개발자

데이터 개념으로 이동하여 데이터 모델 이해하기

GraphQL API

유연한 온체인 쿼리를 위한 OLAP 분석 GraphQL API 탐색하기

컴플라이언스 사용자

보안 컴플라이언스로 이동하여 KYT/KYA 학습하기

AI 개발자

AI 인프라로 이동하여 MCP와 Agent Skills 학습하기

CLI

스크립팅, CI/CD 및 AI 에이전트 워크플로우에 CLI 사용하기

문제가 있으신가요? FAQ를 확인하거나 기술 지원팀에 문의하세요.

시작하기

데이터 개념

AI 인프라

CLI

보안 및 규정 준수

통합

리소스

법률 및 정책

학습 내용

사전 요구사항

1단계: API Key 발급

2단계: 첫 번째 요청 보내기

응답 예시

4단계: 응답 이해하기

5단계: 더 많은 API 시도하기

토큰 가격 조회

지갑 잔액 조회

자주 발생하는 문제

다음 단계

데이터 개발자

GraphQL API

컴플라이언스 사용자

AI 개발자

CLI

시작하기

데이터 개념

AI 인프라

CLI

보안 및 규정 준수

통합

리소스

법률 및 정책

​학습 내용

​사전 요구사항

​1단계: API Key 발급

​2단계: 첫 번째 요청 보내기

​응답 예시

​4단계: 응답 이해하기

​5단계: 더 많은 API 시도하기

토큰 가격 조회

지갑 잔액 조회

​자주 발생하는 문제

​다음 단계

데이터 개발자

GraphQL API

컴플라이언스 사용자

AI 개발자

CLI

학습 내용

사전 요구사항

1단계: API Key 발급

2단계: 첫 번째 요청 보내기

응답 예시

4단계: 응답 이해하기

5단계: 더 많은 API 시도하기

자주 발생하는 문제

다음 단계