Bitculator · 임베드 · v1

임베드 위젯

<iframe> 하나로 Bitculator의 실시간 크립토 도구를 내 사이트에 그대로 올릴 수 있습니다 - 실시간 가격 차트, 변환기, 시가총액 Flipper, 그리고 계산기 6종. SDK도 빌드 과정도 필요 없습니다.

9개 위젯 임베드 키 + 도메인 익명 모드

모든 위젯은 /{locale}/embed/… 아래에 있는 독립 실행형 페이지이며, <iframe>으로 사이트에 바로 넣을 수 있습니다. 앱이 사용하는 것과 동일한 피드인 Bitculator의 실시간 마켓 데이터를 그대로 렌더링하며, 사이트 쪽에는 JavaScript가 전혀 필요 없습니다.

어디든 붙여 넣기만 하면 됩니다 - 스크립트 태그는 필요 없습니다:

<iframe src="https://bitculator.com/ko/embed/converter/bitcoin/usd?embed_key=YOUR_EMBED_KEY"
        title="Bitculator converter" loading="lazy"
        width="100%" height="470" style="border:0;border-radius:12px"></iframe>

임베드 키를 쿼리 파라미터로 추가하고 임베드할 도메인을 등록하세요(둘 다 개발자 콘솔에서 설정합니다). 키 없는 임베드도 익명 모드로 동작해 빠르게 시험해 볼 때 편리하지만, 방문자 IP별로 제한됩니다. 모든 위젯은 URL의 {locale} 값을 따르고 theme 쿠키(또는 ?theme=dark)를 반영합니다.

Content-Security-Policy

사이트에 Content-Security-Policy 헤더를 적용하고 있나요? 위젯이 로드되도록 frame-src(구형 브라우저에서는 child-src)에 https://bitculator.com 주소를 추가하세요. 저희 쪽에서 바꿀 것은 없습니다 - Bitculator는 이미 모든 도메인에서의 임베드를 허용합니다.

Content-Security-Policy: frame-src https://bitculator.com

스니펫 빌더

위젯과 옵션을 고르면 임베드 스니펫이 바로 갱신됩니다. 스니펫을 복사하거나 새 탭에서 실시간 미리보기를 열어 보세요.

위젯

compact

테마 임베드 키

임베드 스니펫 예시 열기

익명 모드로 실시간 렌더링됩니다.

인증

임베드 키는 api 권한을 가진 토큰이며 개발자 콘솔에서 발급합니다. Data API 키와 달리 헤더가 아니라 iframe URL의 쿼리 파라미터로 전달되므로 설계상 공개되는 값입니다. api 권한만 가지며, Bearer 전용인 data-api 키는 여기서 거부됩니다. 그래야 키가 리퍼러나 로그로 새지 않습니다.

?embed_key=… 형태로 전달하세요(별칭 ?api_key=…도 됩니다). 키를 사용하는 요청은 허용 목록에 등록된 도메인에서 와야 합니다(아래 참고). 같은 브라우저에서 Bitculator에 로그인되어 있다면 본인 세션에 한해 키 검사를 건너뜁니다.

도메인

키를 사용하는 임베드는 등록한 도메인에서만 렌더링됩니다. Bitculator는 임베드된 페이지의 Referer 값을 읽고(읽을 수 없으면 Origin), 이를 정규화한 다음(소문자로 바꾸고 www. 접두사와 끝의 마침표를 제거) 허용 목록과 정확히 일치하는지 대조합니다. 등록되지 않았거나 읽을 수 없는 호스트에는 403을 반환합니다.

도메인은 개발자 콘솔에서 관리하며, 요금제마다 등록할 수 있는 개수가 정해져 있습니다(아래 표 참고). Referer/Origin 헤더는 방문자의 브라우저가 설정하는 값이라 위조될 수 있으므로, 허용 목록은 가벼운 키 도용을 막는 장치일 뿐 암호학적 증명은 아닙니다 - 어느 쪽이든 키는 공개된 값으로 취급하세요. 익명(키 없는) 임베드에는 도메인 제한이 없고, 대신 IP별로 제한됩니다.

쿼터 및 한도

임베드는 Data API와 완전히 분리된 월간 풀에서 차감됩니다. 요금제도 카운터도 별개입니다. 익명 로드는 방문자 IP별로 집계되고(월 1,000회), 키를 사용하는 로드는 요금제의 월 한도에서 차감됩니다. 무료 요금제은 달력 기준 월마다 초기화되고, 유료 요금제은 결제일에 초기화됩니다.

*임베드 응답에는 `X-Quota-헤더가 없습니다** - 쿼터 수치가 방문자 페이지로 새어 나가지 않도록 일부러 제외했습니다. 사용량은 [개발자 콘솔](/user/developer/api)에서 확인하세요. (어디선가 보셨을X-Quota-*` 헤더는 Data API에만 있습니다.)

한도 초과

위젯이 쿼터를 초과하면 429를 반환합니다. 브라우저 iframe에서는 "사용 한도 도달" 안내가 담긴 작은 페이지가 표시되므로 레이아웃이 깨지지 않고, JSON으로 호출하면 {"message", "limit", "used"}를 받습니다. 한도를 늘리려면 키를 추가하거나 요금제을 업그레이드하세요.

요금제

임베드 요금제은 Data API 요금제과 별개입니다. 모든 계정은 무료 요금제에서 시작하고, 키 없이 접속한 방문자에게는 익명 등급이 적용됩니다.

요금제	월 로드 수	도메인	키
무료	10,000	1	2
Starter	50,000	3	5
Pro	500,000	10	10
익명	1,000 IP당	-	-

익명은 키가 없는 등급입니다 - 도메인도 키도 없고 방문자 IP별로 제한됩니다. 업그레이드는 개발자 콘솔에서 할 수 있습니다.

위젯

바로 쓸 수 있는 위젯 9종입니다. 스니펫을 복사하고 키를 넣고 도메인을 등록하면 끝입니다. 경로 세그먼트(예: 코인 슬러그)는 자산의 슬러그로 해석되며 활성 마켓이어야 합니다. 모든 위젯은 아래의 공통 쿼리 파라미터도 함께 지원합니다.

GET

통화 변환기

/{locale}/embed/converter/bitcoin/usd

크립토와 법정화폐를 가리지 않고 두 자산 사이의 금액을 실시간 시세로 변환하며, 비교 표를 함께 표시할 수도 있습니다.

임베드 스니펫 예시 열기

<iframe src="https://bitculator.com/ko/embed/converter/bitcoin/usd?embed_key=YOUR_EMBED_KEY"
        title="Bitculator converter" loading="lazy"
        width="100%" height="470" style="border:0;border-radius:12px"></iframe>

파라미터	위치	기본값
from변환 전 자산을 슬러그로 지정합니다(활성 마켓이어야 합니다).	경로	-
to변환 후 자산을 슬러그로 지정합니다(활성 마켓이어야 합니다).	경로	-
hideTable비교 표를 숨기고 변환기만 표시합니다.	쿼리	false
compact여백을 좁힌 압축 레이아웃으로 표시합니다 - 폭이 좁은 컬럼에 적합합니다.	쿼리	false

실시간 미리보기

GET

가격 이력 차트

/{locale}/embed/zoom/bitcoin

코인의 전체 가격 이력을 인터랙티브 차트로 보여 주며, 시가총액 상위 마켓을 고를 수 있는 선택기가 함께 제공됩니다.

임베드 스니펫 예시 열기

<iframe src="https://bitculator.com/ko/embed/zoom/bitcoin?embed_key=YOUR_EMBED_KEY"
        title="Bitculator price chart" loading="lazy"
        width="100%" height="460" style="border:0;border-radius:12px"></iframe>

파라미터	위치	기본값
slug차트로 표시할 코인 또는 토큰을 슬러그로 지정합니다(활성 마켓이어야 합니다).	경로	-
compact여백을 좁힌 압축 레이아웃으로 표시합니다 - 폭이 좁은 컬럼에 적합합니다.	쿼리	false

실시간 미리보기

GET

시가총액 Flipper

/{locale}/embed/flip/bitcoin/ethereum

이른바 "플리프닝"입니다 - 한 자산이 다른 자산의 시가총액에 도달하면 가격이 얼마가 되는지, 그리고 그 배수를 보여 줍니다.

임베드 스니펫 예시 열기

<iframe src="https://bitculator.com/ko/embed/flip/bitcoin/ethereum?embed_key=YOUR_EMBED_KEY"
        title="Bitculator marketcap flipper" loading="lazy"
        width="100%" height="460" style="border:0;border-radius:12px"></iframe>

파라미터	위치	기본값
entity1가격을 다시 계산할 자산을 슬러그로 지정합니다(활성 마켓이어야 합니다).	경로	-
entity2시가총액을 적용할 자산을 슬러그로 지정합니다(활성 마켓이어야 합니다).	경로	-
compact여백을 좁힌 압축 레이아웃으로 표시합니다 - 폭이 좁은 컬럼에 적합합니다.	쿼리	false

실시간 미리보기

GET

DCA 시뮬레이터

/{locale}/embed/dca

지난 5년 동안 매주 반복해서 코인을 매수했다면 얼마나 모이고 수익은 어땠을지 보여 줍니다.

임베드 스니펫 예시 열기

<iframe src="https://bitculator.com/ko/embed/dca?embed_key=YOUR_EMBED_KEY"
        title="Bitculator DCA simulator" loading="lazy"
        width="100%" height="560" style="border:0;border-radius:12px"></iframe>

파라미터	위치	기본값
compact여백을 좁힌 압축 레이아웃으로 표시합니다 - 폭이 좁은 컬럼에 적합합니다.	쿼리	false

실시간 미리보기

GET

손익 계산기

/{locale}/embed/profit

매수 가격과 매도 가격, 수량, 수수료로 순이익과 손실, ROI를 계산합니다.

임베드 스니펫 예시 열기

<iframe src="https://bitculator.com/ko/embed/profit?embed_key=YOUR_EMBED_KEY"
        title="Bitculator profit calculator" loading="lazy"
        width="100%" height="560" style="border:0;border-radius:12px"></iframe>

파라미터	위치	기본값
compact여백을 좁힌 압축 레이아웃으로 표시합니다 - 폭이 좁은 컬럼에 적합합니다.	쿼리	false

실시간 미리보기

GET

이자 계산기

/{locale}/embed/interest

초기 원금과 이율, 복리 주기로 보유 자산의 미래 가치를 예측합니다.

임베드 스니펫 예시 열기

<iframe src="https://bitculator.com/ko/embed/interest?embed_key=YOUR_EMBED_KEY"
        title="Bitculator interest calculator" loading="lazy"
        width="100%" height="560" style="border:0;border-radius:12px"></iframe>

파라미터	위치	기본값
compact여백을 좁힌 압축 레이아웃으로 표시합니다 - 폭이 좁은 컬럼에 적합합니다.	쿼리	false

실시간 미리보기

GET

세금 계산기

/{locale}/embed/tax

거래 이익과 채굴, 스테이킹, 에어드롭, 이자 수익에 대한 과세 대상 금액과 납부할 세금을 추산합니다.

임베드 스니펫 예시 열기

<iframe src="https://bitculator.com/ko/embed/tax?embed_key=YOUR_EMBED_KEY"
        title="Bitculator tax calculator" loading="lazy"
        width="100%" height="580" style="border:0;border-radius:12px"></iframe>

파라미터	위치	기본값
compact여백을 좁힌 압축 레이아웃으로 표시합니다 - 폭이 좁은 컬럼에 적합합니다.	쿼리	false

실시간 미리보기

GET

대출 계산기

/{locale}/embed/loan

크립토 대출을 시뮬레이션합니다 - 상환액과 총 이자, 상환 스케줄 내역을 보여 줍니다.

임베드 스니펫 예시 열기

<iframe src="https://bitculator.com/ko/embed/loan?embed_key=YOUR_EMBED_KEY"
        title="Bitculator loan calculator" loading="lazy"
        width="100%" height="580" style="border:0;border-radius:12px"></iframe>

파라미터	위치	기본값
compact여백을 좁힌 압축 레이아웃으로 표시합니다 - 폭이 좁은 컬럼에 적합합니다.	쿼리	false

실시간 미리보기

GET

스테이킹 계산기

/{locale}/embed/staking

스테이킹 금액과 APR/APY, 기간으로 스테이킹 보상을 추산합니다.

임베드 스니펫 예시 열기

<iframe src="https://bitculator.com/ko/embed/staking?embed_key=YOUR_EMBED_KEY"
        title="Bitculator staking calculator" loading="lazy"
        width="100%" height="520" style="border:0;border-radius:12px"></iframe>

파라미터	위치	기본값
compact여백을 좁힌 압축 레이아웃으로 표시합니다 - 폭이 좁은 컬럼에 적합합니다.	쿼리	false

실시간 미리보기