BitcoinVN API - 통합 가이드 및 사용 사례

BitcoinVN은 개발자가 자체 애플리케이션에 즉시 암호화폐 거래를 통합할 수 있는 REST API를 제공합니다. 전체 대화형 문서는 bitcoinvn.io/api/doc에서 확인할 수 있습니다.

시작하기

  1. API 키 발급: bitcoinvn.io에 등록하고 대시보드(bitcoinvn.io/api-keys)에서 API 키를 생성하세요
  2. 엔드포인트 탐색: bitcoinvn.io/api/doc의 대화형 Swagger UI를 탐색하거나 bitcoinvn.io/api/doc.json에서 OpenAPI 스펙을 다운로드하세요
  3. 라이브 시작: 견적 생성, 주문 제출, 웹훅 알림 수신

인증

공개 엔드포인트(환율, 자산 정보, 주문 조회)는 인증이 필요하지 않습니다. 개인 엔드포인트(주문 생성, 잔액, KYC, 스테이킹)의 경우 모든 요청의 X-API-KEY 헤더에 API 키를 포함하세요.

핵심 워크플로

  1. GET /api/info - 지원되는 자산 및 전송 방법 확인
  2. POST /api/quotes - 15분간 환율 고정
  3. POST /api/orders - 견적 ID와 결제 세부 정보로 주문 생성
  4. 고객이 주문 응답에 제공된 주소로 입금 전송
  5. GET /api/orders/{shortId} - 주문 상태 추적 또는 웹훅 콜백 수신

사용 사례

  • 스왑 집계기: 100개 이상의 자산에서 BitcoinVN을 거래소 제공자로 나열
  • 판매자 결제: 전 세계 고객으로부터 암호화폐 결제 수락
  • 지갑 및 앱: 지갑이나 앱에 거래 기능을 직접 내장
  • 자동화 거래: 티커 엔드포인트를 통해 환율을 모니터링하고 프로그래밍 방식으로 스왑 실행
  • 회계 및 보고: 잔액 및 원장 엔드포인트로 거래 내역 가져오기
  • 컴플라이언스 도구: 블랙리스트 관리 엔드포인트로 암호화폐 주소 스크리닝
  • 스테이킹 대시보드: 현재 스테이킹 오퍼 조회 및 자동 스테이킹 기본 설정 관리

주요 기능

  • 100개 이상의 지원 자산 (여러 네트워크)
  • 15분간 가격 보장하는 바인딩 견적
  • 실시간 주문 상태 업데이트를 위한 웹훅 알림
  • 개인 정보 불필요 (기본 암호화폐 간 스왑)
  • OpenAPI 3.0 스펙으로 쉬운 클라이언트 코드 생성

개발자 지원

통합 관련 문의는 개발자 Telegram 채팅에 참여하거나 [email protected]로 연락하세요.