API 레퍼런스

Blocklens API에 오신 것을 환영합니다! 저희 API는 210개 이상의 온체인 지표에 대한 프로그래밍 방식의 접근을 제공합니다 — 이는 저희 웹 대시보드를 구동하는 것과 동일한 고품질 데이터입니다. 모델, 리서치, 애플리케이션을 위해 신뢰할 수 있고 일관된 데이터가 필요한 전문 트레이더, 분석가, 펀드, 개발자를 위해 설계되었습니다.

시작하기

Blocklens API를 시작하려면 API Key가 필요합니다. API 접근은 유료 구독 플랜을 이용하는 사용자에게 제공됩니다.

1. 구독: 요금제 페이지에서 API 접근이 가능한 플랜으로 업그레이드하세요.
2. 키 생성: 계정 대시보드의 API Keys 섹션으로 이동하여 첫 번째 키를 생성하세요.
3. 인증: 요청의 Authorization 헤더에 API 키를 포함하세요.

자세한 내용은 인증 가이드를 참고하세요.

차트 스냅샷 API

Snapshot API를 사용하면 온체인 분석 차트를 PNG 이미지, SVG 벡터 그래픽, 또는 JSON 메타데이터로 렌더링할 수 있습니다 — 모두 단일 엔드포인트를 통해 가능합니다.

# Simple: render a BTC price chart
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.blocklens.co/v1/chart/snapshot?metric=price" -o chart.png

# Template: MVRV ratio with dark theme
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.blocklens.co/v1/chart/snapshot?template=mvrv_ratio&theme=dark" -o mvrv.png

일반적인 차트에는 사전 제작된 템플릿을 사용하거나, 전체 커스터마이징(지표별 스타일링, 수식, 사용자 정의 축, 히트맵, 사이클 성과 오버레이)을 위해 POST 엔드포인트를 사용하세요. MCP Server는 render_chart 도구를 위해 내부적으로 이 API를 사용합니다.

모든 파라미터, 템플릿, 예제는 전체 Snapshot API 문서를 참고하세요.

API 철학

저희 API는 다음 원칙을 염두에 두고 설계되었습니다.

• 일관성: 엔드포인트 구조와 데이터 스키마는 지원되는 모든 네트워크에서 예측 가능하고 일관되도록 설계되었습니다.
• 성능: 시간에 민감한 쿼리에 대해 저지연 응답을 제공하도록 인프라를 최적화합니다.
• 명확성: 문서와 데이터 필드는 별도 설명 없이도 의미를 알 수 있도록 명확하게 이름 붙였습니다.
• 신뢰성: 높은 가동률(uptime)을 목표로 구축하며, 모든 업데이트 내역을 변경 이력에 투명하게 공개합니다.