1. 위젯 — 블로그에 붙이기
아래 한 줄을 글에 넣으면 이렇게 뜹니다. 값은 30초마다 저절로 바뀝니다.
붙일 코드
<iframe src="https://kimpgo.com/widget"
width="320" height="190"
style="border:0" scrolling="no"
title="김프고 김치프리미엄"></iframe>고를 수 있는 것
| 기본 | /widget — 보는 사람의 밝기 설정을 따릅니다 |
|---|---|
| 밝게 고정 | /widget?theme=light |
| 어둡게 고정 | /widget?theme=dark |
지키는 것
- 광고를 넣지 않습니다. 위젯 안에는 앞으로도 광고가 들어가지 않습니다. 광고는 우리가 관리하는 화면에만 둡니다
- 로고와 링크는 지워 주지 마세요. 위젯을 무료로 내주는 대가가 그것뿐입니다
- 높이를 알려 드립니다. 붙인 쪽에서 받아 쓰면 아래가 잘리지 않습니다
(
postMessage로{ kimpgo: 'height', height: … })
2. 공개 API — 프로그램에서 읽기
지금 김프 봇을 만드는 분들은 거래소 API를 각각 붙이고 환율까지 따로 구해서 직접 계산합니다. 여기서는 계산된 값을 한 번에 가져갈 수 있습니다.
/api/v1 |
무엇이 있는지 |
|---|---|
/api/v1/premium |
요약 — 평균 김프, 테더 프리미엄, 코인 자체 차이, 환율 |
/api/v1/coins |
종목별 김프. ?limit= 로 개수 (기본 50, 최대 500) |
받는 모양 — /api/v1/premium
{
"at": "2026-08-28T00:00:00.000Z",
"base": "upbit",
"quote": "binance",
"usdKrw": 1382.5,
"usdKrwChangePct": -0.25,
"premiumPct": -0.08,
"tetherPremiumPct": -0.04,
"coinOnlyPct": -0.04,
"coinCount": 287
}
이 갈라짐이 다른 곳에는 없습니다. 김프 안에는 국내에서
달러가 비싼 몫(tetherPremiumPct)과 코인 자체가 비싼
몫(coinOnlyPct)이 섞여 있습니다.
왜 갈라 봐야 하는지에 적었습니다.
거래소 고르기
?base= 로 국내 거래소, ?quote= 로 해외
거래소를 고릅니다. 아는 값이 아니면 기본값으로 돌아갑니다.
https://kimpgo.com/api/v1/premium?base=bithumb"e=binance3. 출처 표기 — 그대로 복사해 쓰세요
쓰신 곳에 아래 한 줄만 붙여 주시면 됩니다. 직접 쓰실 필요 없이 복사만 하세요.
<a href="https://kimpgo.com/" target="_blank" rel="noopener">데이터: 김프고</a>데이터: [김프고](https://kimpgo.com/) — 김치프리미엄 실시간 시세데이터 출처: 김프고 (https://kimpgo.com)위젯에는 로고와 링크가 이미 들어 있습니다. 따로 붙이지 않으셔도 됩니다 — 대신 지우지만 말아 주세요. 위젯을 무료로 내주는 대가가 그것뿐입니다.
4. 부탁과 약속
| 요청 빈도 |
1초에 2번까지입니다(같은 IP 기준). 화면을
처음 열 때처럼 한꺼번에 몰릴 때를 위해 10번까지는
몰아쳐도 받아 줍니다. 넘으면 HTTP 429가 돌아옵니다. 차단이 아니라 그 순간만 거절하는 것이라, 조금 쉬었다 부르면 다시 됩니다. 값은 몇 초 단위로 바뀌므로 그보다 자주 부를 이유가 없습니다. 위젯은 30초에 한 번 부릅니다. |
|---|---|
| 출처 | 쓰신 곳에 김프고를 밝혀 주세요. 위젯은 로고가 이미 들어 있습니다 |
| 판 번호 | /api/v1 의 있던 칸은 이름도 뜻도
바꾸지 않습니다. 칸을 더할 수는 있습니다.
모양을 바꿔야 하면 v2 를 새로 냅니다 |
| 계산 방법 | 전부 공개합니다 — 계산 방법. 환율 출처, 이상값 거르는 법까지 적혀 있습니다 |
값을 보장하지 않습니다. 거래소나 환율 출처가 멈추면 값이 늦거나 빠질 수 있습니다. 서비스가 예고 없이 바뀌거나 멈출 수 있습니다. 돈이 오가는 판단에 이 값을 그대로 쓰지 마세요. 투자 권유가 아니며, 이 값으로 생긴 손해에 대해 책임지지 않습니다.
문제가 있거나 더 필요하면
필요한 값이 없거나 이상한 값이 나오면 알려 주세요. 어떤 값을 어떻게 쓰시는지 알면 다음에 무엇을 열지 정하는 데 도움이 됩니다.