Whales

고래 체결 / 청산. whales 수집기가 Binance/Bybit WS 로 수집해 whale RDS 에 적재. 기존 marginking-backend 와 동일 경로·계약.

raw 응답

이 그룹은 공통 envelope 를 쓰지 않습니다. { tx, hasNext, nextPage } 형태로 바로 반환합니다.

---

GET /api/v1/whaletx

고래 체결 목록.

파라미터	위치	필수	기본
symbol	query	✅	예: BTCUSDT
page	query	-	1
limit	query	-	20
low	query	-	최소 금액(KRW) 필터
max	query	-	최대 금액(KRW) 필터

symbol 누락 시 400 BAD_REQUEST.

응답

{
  "tx": [
    { "id": 23004635, "ts": "2026-06-30T11:18:56.081Z", "price": "59277.1", "size": 2,
      "sell": 0, "isSell": 0, "exchange": "바이낸스 선물", "krw": 211459199, "priceUsd": 136337, "symbol": "BTCUSDT" }
  ],
  "hasNext": true,
  "nextPage": 2
}

예시

curl "https://data-api.mgking.io/api/v1/whaletx?symbol=BTCUSDT&page=1&limit=20"
curl "https://data-api.mgking.io/api/v1/whaletx?symbol=BTCUSDT&low=100000000"

---

GET /api/v1/whaletx/internal

whaletx 와 동일 + 시간범위 필터(내부용).

추가 파라미터	위치	설명
startTxTime	query	시작 시각(epoch ms)
endTxTime	query	종료 시각(epoch ms)

나머지 파라미터·응답 형태는 /api/v1/whaletx 와 동일.

---

GET /api/v1/liquidation

고래 청산 목록.

파라미터	위치	필수	기본
page	query	-	1
limit	query	-	20
low	query	-	최소 금액(KRW)
max	query	-	최대 금액(KRW)

응답

{
  "tx": [
    { "id": 589693, "ts": "2026-06-30T11:18:28.352Z", "price": "386.43", "size": "50.056",
      "side": "Long", "exchange": "바이낸스", "krw": 30001210, "symbol": "ZEC" }
  ],
  "hasNext": true,
  "nextPage": 2
}