Bitculator 데이터 API 소개

Bitculator의 모든 차트, 표, 지표는 하나의 데이터 엔진으로 구동됩니다: 약 1분마다 갱신되는 실시간 가격, 여러 거래소의 수천 개 마켓, 심리 지표, 기술적 지표, 청산 데이터, 글로벌 시장 이력까지 제공합니다.

오늘 이 엔진을 공개합니다. Bitculator Data API가 출시되었습니다 - 15개 그룹에 걸친 85개 엔드포인트, 무료 요금제, 19개 언어로 제공되는 문서를 갖춘 Bearer 인증 방식의 JSON API입니다.

첫 호출은 한 줄이면 됩니다:

curl "https://bitculator.com/api/v1/coins?per_page=5" \ -H “Authorization: Bearer YOUR_API_KEY”
{ "data": [ { "rank": 1, "name": "Bitcoin", "symbol": "BTC", "price": "67412.83451201", "..." : "..." } ], "meta": { "current_page": 1, "per_page": 5, "..." : “...”} }

개발자 콘솔에서 키를 생성하면 지금 바로 이 호출을 실행할 수 있습니다. 

API는 15개 리소스 그룹으로 구성되어 있으며, 플랫폼에 표시되는 모든 데이터가 담겨 있습니다:

• 코인 & 가격 - 전체 자산 목록, 실시간 시세, 과거 가격, OHLC, 공급량 데이터.
• 마켓 & 거래소 - 추적 대상 거래소의 거래쌍, 티커, 거래량 및 거래소 상세 정보.
• 지갑 - 사양과 지원 자산이 포함된 지갑 목록.
• 글로벌 시장 - 과거 시계열을 포함한 총 시가총액, 거래량 및 도미넌스.
• 심리 & 지표 - 공포 & 탐욕, 강세/약세 국면 신호, 자산별 기술적 지표(RSI, 이동평균 등).
• 청산 - 롱/숏 청산 데이터.
• 환산 & 계산기 - 실시간 환율을 적용한 암호화폐↔법정화폐 환산 및 플랫폼의 계산기 엔드포인트.
• 콘텐츠 - 기사 및 용어집 콘텐츠.
• 알림 & 웹훅 - API로 가격 알림을 생성하고, 알림이 발동하면 서명된 웹훅을 수신.
• 메타 - 사용량, 요금제 및 기계 판독 가능한 명세.

모든 엔드포인트의 실행 가능한 예제를 포함한 전체 레퍼런스는 API 문서에서 확인할 수 있습니다.

설계 과정에서 타협하지 않은 몇 가지 원칙입니다:

• 소수 문자열의 정밀도. 가격, 환율, 공급량은 부동소수점이 아닌 문자열로 반환됩니다. 부동소수점은 0.00000001842를 정확히 표현할 수 없으므로 사용하지 않습니다. 파서가 시장에서 생성된 모든 자릿수를 그대로 보존합니다.
• 어디서나 동일한 응답 구조. 성공 응답은 { data, meta }이며, 4xx 또는 5xx 등 모든 오류는 { "error": { "code", "message", "details" } }입니다. error.code를 기준으로 처리하세요: 메시지 문구는 바뀔 수 있지만 코드는 일정하게 유지됩니다.
• 모든 응답에 할당량 정보 포함. 호출할 때마다 X-Quota-Limit, X-Quota-Used, X-Quota-Reset 헤더가 반환되므로 현재 사용 현황을 추측할 필요가 없습니다—GET /usage로 직접 조회할 수도 있습니다. 
• 예측 가능한 한도. per_page 상한은 요금제에 따라 정해지며, 상한을 초과하면 명확하게 422를 반환합니다. API가 요청을 임의로 축소하여 요청한 것보다 적은 데이터를 반환하는 일은 없습니다.
• 서명된 웹훅. 알림 전송에는 Stripe 방식의 X-Bitculator-Signature 헤더가 포함되므로 페이로드를 신뢰하기 전에 진위를 검증할 수 있습니다.
• 공개 명세. 전체 API 인터페이스는 OpenAPI 명세에 기술되어 있으며, 문서에서는 바로 사용할 수 있는 Postman 컬렉션을 제공합니다.

Data API에는 Bitculator의 임베드 가능한 위젯과 별개로 자체 월간 할당량이 적용됩니다. 무료 요금제에는 카드가 필요 없습니다 - 키를 발급받고 개발을 시작하세요. 유료 요금제는 월간 호출 허용량과 per_page 상한을 높여줍니다; 자세한 내용과 현재 가격은 Data API 페이지에서 확인할 수 있습니다.

API와 함께 MIT 라이선스가 적용된 공식 SDK 8종을 제공합니다 - TypeScript, Python, PHP, Go, Rust, Java, C#, C++ - 각각 85개 엔드포인트 전체를 지원하며 자동 페이지네이션, 타입이 지정된 오류, 스마트 재시도, 소수 문자열 보장 기능을 기본으로 갖추고 있습니다. 8종 모두의 설치 명령어, 로고, 저장소 링크는 API 페이지의 SDK 섹션에 있으며, 소스는 github.com/bitculator에 공개되어 있습니다. 다만 분명히 말씀드리면: SDK가 반드시 필요한 것은 아닙니다. Bearer 헤더를 사용하는 일반 HTTP이므로 - curl, fetch, requests, Guzzle 모두 예상대로 작동합니다.

1. Data API 페이지에서 요금제, 할당량, 빠른 시작 가이드를 살펴보세요.
2. 개발자 콘솔에서 키를 생성하세요
3. 첫 호출을 실행하고 - 함께 반환되는 X-Quota-* 헤더를 확인하세요.

이런 API가 있기를 바랐기에 직접 만들었습니다. 이 API로 무언가를 만드신다면, 꼭 이야기를 들려주세요.