Blockchain Data API 레퍼런스

개요

이 Blockchain Data API 레퍼런스를 참조하여 인덱싱된 블록, 트랜잭션, 주소, 토큰, NFT, DEX 활동, 토큰화 주식 및 데이터셋 최신성을 조회하는 REST 요청을 구성하세요. 데이터셋을 선택하고 체인 지원 여부를 확인하려면 데이터셋 디렉터리부터 살펴보세요. 지갑 토큰 잔액 및 전송 내역은 지갑 자산 가이드를 참고하세요.

• 기본 URL: https://api.blockvectra.com/v1/data — /chains를 제외한 모든 경로는 체인 식별자로 시작합니다(예: https://api.blockvectra.com/v1/data/{chain}/…)
• 프로토콜: HTTP GET(/{chain}/tokens:batch에서 일괄 토큰 조회를 위한 POST 포함), JSON 응답
• 인증: API 키 필요 — x-api-key 요청 헤더로 키를 전달하세요. 요청은 Compute Units (CU) 단위로 측정 및 청구되며, 2xx 성공 응답에 대해서만 과금됩니다
• Ethereum: 데이터 제공 범위는 GET /v1/data/chains의 coverage.from_block에 따라 결정되며, 더 적은 데이터셋을 지원합니다 — 지원 체인 → Ethereum을 확인하세요

Data API의 CU 가중치는 요금 페이지에 안내되어 있으며 GET /v1/plans로도 반환됩니다. 요청 예제 및 응답 형식은 빠른 시작 → Data API 호출을 참고하세요. 경로 버전 관리, 하위 호환성 규칙 및 SDK 권장 사항은 API 버전 관리 및 호환성을 확인하세요.

체인

Data API는 체인별로 범위가 지정된 인덱싱 데이터를 제공합니다: https://api.blockvectra.com/v1/data/{chain}/….

지원되는 데이터셋과 기능은 체인마다 다릅니다. 전체 지원 현황은 지원 체인에서 확인하세요. GET https://api.blockvectra.com/v1/data/chains는 각 체인의 features, coverage, finality 및 limits를 반환합니다. 데이터셋의 제공 범위를 벗어난 요청은 HTTP 422 no_coverage를 반환합니다(과금되지 않음). 알 수 없거나 비공개 상태인 체인은 error.code가 not_found인 HTTP 404를 반환합니다(과금되지 않음. 체인 이름은 소문자 slug로 정확히 일치해야 함).

오류

모든 오류 응답은 {"error":{"code","message"}} 형식입니다. 409 not_indexed_yet만 추가로 indexed_through(해당 체인에서 인덱싱된 최고 블록)를 포함할 수 있으며, 체인에 아직 인덱싱된 데이터가 없을 때는 생략됩니다. 사용자가 가장 자주 접하는 코드:

엔드포인트 목록