메인 콘텐츠로 건너뛰기
chainstream CLI는 모든 데이터 제품, GraphQL 큐브, DeFi 프리미티브를 단일 바이너리로 노출합니다. 이 페이지는 권위 있는 명령어 레퍼런스입니다 — 서술형 사용법과 설치는 접근 방식 → CLI를 참고하세요.

​
설치

# 전역 설치 (대화형 사용 권장)
npm install -g @chainstream-io/cli

# 설치 없이 항상 최신 버전 (에이전트 및 CI 권장)
npx @chainstream-io/cli <command>
아래의 모든 호출은 두 방식 모두 동작합니다. 이 레퍼런스 전반에서는 짧은 형태 chainstream <cmd>를 사용하며, 이는 npx @chainstream-io/cli <cmd>와 동일합니다.

​
전역 플래그

플래그용도
--versionCLI 버전을 출력하고 종료
--json한 줄 머신 판독 JSON 출력 (기본은 보기 좋게 포매팅된 JSON)
--help현재 명령 또는 그룹의 도움말 출력

​
환경 변수

변수용도기본값
CHAINSTREAM_API_KEYconfig.json 대신 사용할 API 키설정 안 됨
CHAINSTREAM_API_URLREST 베이스 URL 재정의https://api.chainstream.io
CHAINSTREAM_AUTH_URLAuth 서비스 URL 재정의프로덕션 기본값
CHAINSTREAM_GRAPHQL_URLGraphQL 엔드포인트 재정의https://graphql.chainstream.io/graphql
SOLANA_RPC_URL지갑 / 잔고 조회용 Solana RPC 재정의퍼블릭 RPC
BASE_RPC_URLBase RPC 재정의퍼블릭 RPC
설정은 ~/.config/chainstream/config.json에 저장되며, P-256 지갑 키는 ~/.config/chainstream/keys/에 있습니다. chainstream logout은 지갑 설정을 지우지만 키는 보존합니다.

​
인증 명령 (최상위)

이 명령들은 프로그램 루트(서브 그룹 없음)에 등록되어 있습니다.
명령용도인수 / 옵션
loginTEE 기반 지갑 생성(기본) 또는 이메일 OTP 플로우 시작. 최초 로그인 시 nano trial(50K CU, 30일)을 자동 지급[email]; --key; --email
verifylogin --email로 시작된 이메일 OTP 로그인 완료--otp-id; --code; --email
logout세션 삭제 (디스크의 키는 보존)—
bind-email기존 지갑에 이메일 바인딩[email]
bind-email-verify이메일 바인딩 OTP 플로우 완료 (비대화형)--otp-id; --code; --email

​
token — 토큰 정보 및 분석

서브명령용도옵션
search키워드로 토큰 검색--keyword(필수); --chain(필수); --limit
info토큰 전체 상세 조회--chain; --address
security보안 리포트 (honeypot, mint authority, freeze authority 등)--chain; --address
holders상위 토큰 홀더--chain; --address; --limit
candlesOHLCV 캔들스틱--chain; --address; --resolution; --from; --to; --limit
pools토큰의 유동성 풀--chain; --address

​
market — 시장 데이터 및 발견

서브명령용도옵션
trending시간 창별 핫 / 트렌딩 토큰--chain; --duration; --limit
new신규 생성된 토큰--chain; --limit
trades최근 거래, 선택적으로 토큰 필터--chain; --token; --limit

​
wallet — 지갑 분석, 관리, 서명

서브명령용도옵션
sign호스트 지갑으로 직렬화된 트랜잭션 서명--chain; --tx
profilePnL + 순자산 + 상위 보유 한 번의 호출로--chain; --address
pnlPnL 상세--chain; --address
holdings토큰 잔고--chain; --address; --limit
activity전송 내역--chain; --address; --limit
address현재 지갑 주소 표시—
balance네이티브 + USDC 잔고 (단일 요청)--chain (sol | base)
set-raw원시 프라이빗 키 가져오기 (개발 / 테스트 전용)--chain (base | sol)
link구독에 지갑 주소 연결--chain (evm | solana)
pricing사용 가능한 x402 플랜과 가격 조회—

​
dex — DEX 라우트, 스왑, 토큰 생성

모든 명령은 서버 측에서 구축된 서명되지 않은 트랜잭션을 반환합니다; 서명은 호스트 지갑에서 이루어집니다.
서브명령용도옵션
route집계된 라우트 + 서명되지 않은 스왑 트랜잭션--chain; --from; --input-token; --output-token; --amount; --slippage; --dex; --recipient; --anti-mev; --gas-price; --gas-limit; --max-fee-per-gas; --max-priority-fee-per-gas
swap서명되지 않은 스왑 트랜잭션 (직접, 집계 없음)--chain; --from; --input-token; --output-token; --amount; --slippage; --dex
create서명되지 않은 런치패드 토큰 생성 트랜잭션--chain; --from; --name; --symbol; --dex; --uri; --image

​
tx — 브로드캐스트 및 가스

서브명령용도옵션
send서명된 트랜잭션 브로드캐스트--chain; --signed-tx; --submit-type; --anti-mev
gas-price현재 가스 가격 (EVM만)--chain (eth | bsc)
estimate-gasEVM 호출의 가스 한도 추정--chain; --from; --to; --data; --value

​
job — 비동기 잡 폴링

서브명령용도옵션
status장시간 실행 잡의 상태 확인--id; --wait; --timeout

​
graphql — GraphQL 스키마 및 쿼리

전체 사용법 가이드는 접근 방식 → CLI → GraphQL 서브명령과 Agent Skill chainstream-graphql을 참고하세요.
서브명령용도옵션
schema스키마 탐색 (큐브, 타입, 필드)--summary; --type <cube>; --full; --refresh
queryGraphQL 쿼리 실행--query <gql>; --file <path>; --var <json>

​
plan — 구독 및 x402 자동 결제

서브명령용도옵션
status현재 플랜, 남은 쿼터, 사용량--chain; --address
purchasex402 / MPP로 플랜 구매 (반환된 API 키를 config.json에 자동 저장)--plan

​
config — 로컬 설정

서브명령용도옵션
set설정 값 지정--key (apiKey | baseUrl | walletChain); --value
get현재 설정 표시--key (선택)
auth현재 인증 상태 표시—

​
종료 동작

  • 0 — 성공 (또는 빈 결과)
  • 1 — 사용자 대면 오류, stdout에 JSON 페이로드 (--json이 꺼져 있지 않은 한, 꺼진 경우 포매팅된 오류 출력)
  • 인증 실패(401), 결제 필요(402), 네트워크 오류 시 0이 아닌 종료 코드
데이터 / GraphQL 명령에서 402가 발생하면 CLI는 wallet pricing과 plan purchase로의 포인터를 출력합니다. plan purchase 자체가 x402 자동 결제를 투명하게 처리합니다.

​
다음 단계

접근 방식 → CLI

서술형 사용법: 설치, 인증, 첫 명령, GraphQL 서브명령.

Agent Skills

AI 에이전트가 CLI를 구동하는 방법.

x402 결제

plan purchase와 실시간 402 처리 방식.

GraphQL

GraphQL 표면의 엔드포인트, 스키마, 인증.