메인 콘텐츠로 건너뛰기
REST API는 ChainStream에서 데이터를 가져오는 가장 간단한 방법입니다. 모든 데이터 제품이 JSON 엔드포인트로 노출되며, 인증과 오류 봉투는 공통입니다.

​
Base URL

https://api.chainstream.io

​
인증

-H "Authorization: Bearer $CHAINSTREAM_API_KEY"
-H "Authorization: Bearer $OAUTH_TOKEN"
-H "X-PAYMENT: <signed payload>"
자세한 내용은 인증.

​
첫 요청

curl -H "Authorization: Bearer $CHAINSTREAM_API_KEY" \
  "https://api.chainstream.io/v2/token/search?chain=sol&keyword=USDC&limit=5"

​
언제 사용할까

  • 단일 조회, 스냅샷, SSR
  • 서브초 지연이 중요하지 않은 워크로드
  • WebSocket과 함께 사용 (이력=REST, 실시간=WS)
  • Agent 도구 호출
부적합: 고빈도 스트리밍 (WebSocket/Kafka), 다중 제품 JOIN (GraphQL).

​
관례

  • 페이징: limit + cursor
  • 속도 제한: 플랜별. X-RateLimit-Remaining, X-RateLimit-Reset
  • 오류: code, message, requestId의 RFC 7807 스타일 JSON

​
다음 단계

API Reference

모든 REST 엔드포인트.

SDK

TS / Py / Go / Rust 타입 래퍼.