KimchiPremium

김치프리미엄 API

업비트와 바이낸스의 실시간 가격차이(김프)를 JSON으로 제공하는 무료 API입니다. API 키 없이, CORS 허용, 1분마다 갱신됩니다.

무료입니다. API 키도, 가입도 필요 없고 모든 출처에서 호출할 수 있습니다.

기본 주소

https://gfreee.com/api/v1

1. 실시간 김프 — 전체 코인

GET /api/v1/kimchi-premium

추적 중인 모든 코인의 최신 김프입니다.

직접 호출해보기 →

{
  "result": "ok",
  "updated_at": "2026-08-19T11:00:00",
  "count": 10,
  "data": [
    {
      "symbol": "BTC",
      "name": "Bitcoin",
      "premium_pct": 0.035,
      "upbit_krw": 90447000,
      "binance_usdt": 64444.01,
      "usdt_krw": 1403,
      "snapshot_at": "2026-08-19T11:00:00"
    }
  ]
}

2. 일별 이력 — 코인 하나

GET /api/v1/kimchi-premium/{symbol}/daily

특정 코인의 날짜별 시가·고가·저가·종가·평균 김프입니다.

직접 호출해보기 (BTC) →

{
  "result": "ok",
  "symbol": "BTC",
  "name": "Bitcoin",
  "count": 5,
  "data": [
    { "date": "2026-08-19", "open_pct": -0.02, "high_pct": 0.10,
      "low_pct": -0.18, "close_pct": -0.01, "avg_pct": -0.03, "samples": 300 }
  ]
}

필드 설명

예제 — 자바스크립트

fetch('https://gfreee.com/api/v1/kimchi-premium')
  .then(r => r.json())
  .then(d => {
    d.data.forEach(c => console.log(c.symbol, c.premium_pct + '%'));
  });

예제 — 파이썬

import requests
r = requests.get('https://gfreee.com/api/v1/kimchi-premium')
for c in r.json()['data']:
    print(c['symbol'], c['premium_pct'], '%')

주의 · 제한