인증

CoinBoss API는 공개 API입니다. 어떤 데이터 엔드포인트를 호출하든 계정이나 API 키가 필요하지 않습니다.

키 불필요

카탈로그의 모든 엔드포인트는 일반 HTTPS GET으로 호출할 수 있습니다. 익명 요청은 IP 주소당 분당 1200회로 제한됩니다.

curl -s "https://www.coinboss.com/api/sd/oi?coin=BTC"

선택 사항인 API 키

여러 서비스가 하나의 IP 주소를 공유하거나 주소가 바뀌는 네트워크에서 호출하는 경우, 계정에서 키를 생성해 CB-API-KEY 헤더로 보낼 수 있습니다. 유효한 키가 포함된 요청은 IP 주소가 아니라 키를 기준으로 집계됩니다.

• 키는 계정의 API 키 페이지에서 생성하고 폐기합니다. 인증된 이메일 주소가 필요합니다.
• 키 전체는 생성 시 한 번만 표시됩니다. 해시만 저장되므로 다시 표시할 수 없습니다.
• 계정당 활성 키를 최대 5개까지 보유할 수 있습니다.
• 알 수 없거나 폐기된 키는 무시됩니다. 이 경우 요청은 익명으로 처리되어 IP 주소를 기준으로 집계됩니다.

API 키 관리

키를 사용한 요청

curl -s "https://www.coinboss.com/api/sd/oi?coin=BTC" \
  -H "CB-API-KEY: $COINBOSS_API_KEY"

요청 한도 등급

모든 등급에서 동일한 데이터를 반환합니다. 현재 무료 기간에는 익명 트래픽과 모든 키에 최고 등급이 적용됩니다.

키 안전하게 보관하기

• 키는 비밀번호처럼 다루십시오. 소스 코드가 아니라 환경 변수나 시크릿 저장소에 보관하십시오.
• 웹 페이지, 브라우저 확장 프로그램, 모바일 앱에 키를 넣지 마십시오. 클라이언트로 배포되는 것은 무엇이든 사용자가 읽을 수 있습니다. API는 서버에서 호출하거나, 브라우저에서는 익명으로 호출하십시오.
• 키 유출이 의심되면 즉시 폐기하고 새 키를 생성하십시오.
• CoinBoss는 거래소 API 키를 절대 요구하지 않습니다. 데이터는 거래소 공개 엔드포인트에서 수집하며, 이 API는 거래소 인증 정보를 필요로 하지도 받지도 않습니다.

브라우저에서 호출하기

응답에 Access-Control-Allow-Origin: *가 포함되므로 어떤 웹 오리진에서든 데이터 엔드포인트를 호출할 수 있습니다. X-Request-Id, X-Cache, X-RateLimit-* 헤더는 스크립트에 노출됩니다.

계정 엔드포인트

/api/user 및 /api/auth 아래의 엔드포인트는 로그인한 웹사이트 기능(관심 목록, 환경설정, 키 관리)에 속합니다. 사이트 세션을 사용하고 공개 데이터 API에 포함되지 않으며 카탈로그에도 나오지 않습니다.