Hyperliquid 펀딩비 데이터 연구: 과거 내역, 타임스탬프 및 부호 검증

펀딩비 데이터는 계약에 대해 공시된 펀딩비율을 설명할 수도 있고 특정 단일 계좌에 기록된 실제 지급액을 설명할 수도 있습니다. 이 둘은 서로 완전히 다른 질문에 답합니다. 본 실습은 2026년 9월 27일에 확인된 Hyperliquid의 공개 문서와 읽기 전용 BTC 과거 데이터 쿼리를 사용합니다. 엔드포인트 필드와 거래소 규칙은 변경될 수 있으며 본 예시들이 다른 거래소를 설명하지는 않습니다.

연구 질문에 맞는 올바른 엔드포인트 선택하기

Hyperliquid 문서는 특정 코인의 과거 펀딩비율 내역 조회를 위한 fundingHistory와 공개 계좌 지갑 주소에 연결된 펀딩 기록을 위한 userFunding을 기술하고 있습니다. 전자는 계약 조건을 연구하는 데 유용하고, 후자는 계좌에 기록된 실제 현금 흐름을 대조 검증하는 데 유용합니다. 단순 펀딩비율 시계열 하나만으로는 특정 계좌가 실제로 얼마를 지불하거나 수취했는지 규명할 수 없습니다.

두 요청 모두 https://api.hyperliquid.xyz/info. 요청 방식을 사용하며 JSON POST 형식으로 전송됩니다. 특정 UTC 하루 동안의 BTC 펀딩비율을 조회하기 위한 요청 본문은 다음과 같이 작성할 수 있습니다:

{
  "type": "fundingHistory",
  "coin": "BTC",
  "startTime": 1790208000000,
  "endTime": 1790294399999
}

이 밀리초 단위 타임스탬프는 2026년 9월 24일 UTC 하루를 감쌉니다. 문서화된 시작 시각과 종료 시각은 경계값을 포함(inclusive)하므로 마지막 값은 해당 UTC 날짜의 마지막 밀리초입니다. 코인 식별자는 쿼리 대상 시장과 정확히 일치해야 합니다. 현재 API 페이지는 일부 시장에 대해 무기한 선물 DEX 식별자로 네임스페이스가 지정된 코인도 표시합니다. Hyperliquid의 펀딩 문서에 따르면 HIP-3 무기한 선물은 서로 다른 프리미엄 공식을 사용하므로 첫 번째 무기한 선물 설정이 그대로 적용된다고 단정하지 말고 특정 계약의 시장 이름과 펀딩 규칙을 직접 확인하십시오.

2026년 9월 27일 기준 이 BTC 윈도우는 24개의 행을 반환했습니다. 첫 번째 행의 타임스탬프는 1790208000045였고 마지막 행은 1790290800038였으며, 둘 다 요청된 UTC 하루 범위 내에 약 1시간 간격으로 위치했습니다. 응답 데이터 일부에는 coin: BTC, fundingRate: 0.0000125, 프리미엄 필드 및 밀리초 time이 포함되어 있었습니다. 이는 단일 시장과 특정 날짜에 대한 재현 가능한 API 관측값일 뿐 미래 펀딩비, 전략 성과 또는 보편적인 응답 크기에 대한 증거가 아닙니다.

2026년 9월 27일 확인한 읽기 전용 BTC 펀딩비 이력 관측: 500행짜리 첫 페이지는 9월 21일 19:00:00.031 UTC에서 끝나고, 그 타임스탬프부터 이어서 조회하면 경계 행을 포함해 125행이 반환됩니다. 원시 625행을 보존하고, 겹침을 검증한 뒤 624개의 고유 코인-시각 관측값을 사용합니다. 설명용 교육 그래픽 · 실시간 시장 데이터 아님

경계를 유실하지 않고 긴 과거 데이터 페이지 나누기(페이지네이션)

Hyperliquid의 일반 info 엔드포인트 문서는 시간 범위 응답이 500개의 요소 또는 고유 블록으로 제한된다고 명시합니다. 더 긴 시간 범위를 조회할 경우 클라이언트는 마지막으로 반환된 타임스탬프를 다음 요청의 startTime으로 사용할 것을 안내합니다. 이것이 이 API에 대해 문서화된 연속 조회 규칙입니다. 페이지 경계가 2번 중복 포함될 수 있으므로 각 페이지의 정확한 요청과 응답을 보존하십시오.

2026년 9월 1일부터 9월 26일까지의 읽기 전용 BTC 쿼리는 첫 번째 요청에서 500개 행을 반환했습니다. 마지막 행은 2026-09-21T19:00:00.031Z였습니다. 해당 행의 밀리초 타임스탬프로 조회를 이어가자 동일한 타임스탬프에서 시작하여 125개 행이 추가로 반환되었습니다. 이 응답들 전반에서 625개의 원시 행은 1개의 중복된 (coin, time) 경계와 624개의 고유 관측치를 포함했습니다. 최종 고유 행은 2026-09-26T23:00:00.010Z에 위치했습니다. 관측된 시간은 해당 표본에서 대략 1시간 간격이었습니다. 본 예시는 9월 27일에 확인된 API 스냅샷이며 이후의 과거 데이터나 다른 시장에 대한 영구적 보장이 아닙니다.

먼저 원시 응답 바이트를 보존한 다음 페이지 순서, 요청된 코인, 시간 경계, 행 수 및 실제 중복 영역을 검증하십시오. 동일한 시장과 정확히 일치하는 타임스탬프가 인접한 페이지에 나타나면 아카이브에 두 원본 사본을 모두 유지하고 분석 뷰에서 확인된 경계를 중복 제거하십시오. 키에 시장 식별자를 포함하십시오. 서로 다른 계약의 동일한 타임스탬프는 중복이 아닙니다. 중복 경계가 누락되었거나 페이지 사이에 예상치 못한 결측 갭이 발생하거나 단일 페이지 내부에서 중복 키가 나타난다면 행을 조용히 삭제하거나 채워 넣지 말고 조사를 진행하십시오. 나중에 데이터를 새로고침할 때 기존 근거를 덮어쓰지 않도록 데이터 수집 타임스탬프와 모든 요청 본문을 출력 결과와 함께 보관하십시오.

공식 문서는 시간 범위 쿼리의 최대 응답 크기를 설명하지만 모든 실패 모드나 영구적인 서비스 수준 보증(SLA)을 약속하지는 않습니다. 수많은 페이지를 가져올 때에는 보수적인 요청 속도를 적용하고 최신 레이트 리밋 페이지를 준수하십시오. 500개로 상한선에 도달한 응답은 페이지네이션을 진행해야 함을 뜻할 뿐 나머지 시간 범위에 데이터가 없다는 의미가 아닙니다.

각 원본 페이지를 보관하고, 반환된 마지막 밀리초 타임스탬프부터 이어서 가져오며, 정확한 마켓과 경계 중복을 검증한 뒤, 확인된 동일 마켓 타임스탬프 반복만 분석용 사본에서 중복 제거합니다. 설명용 교육 그래픽 · 실시간 시장 데이터 아님

“출처 감사 워크플로우는 정확한 시장 요청 및 검색 시간을 기록하고, 원시 응답을 보존하며, 리서치를 위해 시리즈에 레이블을 지정하기 전에 UTC 경계, 주기, 중복 및 누락을 확인합니다. 누락된 관측치는 알 수 없는 상태로 유지되며, API 성공 응답만으로는 완전한 커버리지를 확립할 수 없습니다.” 설명용 교육 그래픽 · 실시간 시장 데이터 아님

단위, 정산 주기 및 부호 엄격히 보존하기

API는 예제에서 숫자 값을 문자열로 반환합니다. 0.0000125와 같은 요율을 0.0000125%로 잘못 변환하지 말고 소수점 숫자로 파싱하십시오. 100을 곱하면 해당 구간에 대해 0.00125%가 됩니다. Hyperliquid의 펀딩 페이지는 1시간 정산 주기, 양의 펀딩비율의 방향성 및 거래소 고유의 계산식을 설명합니다. 시점이 기록된 수치 예시를 발표하기 전에 해당 페이지를 다시 확인하십시오. 1시간 단위 관측값을 임의로 연율화하여 예측치로 제시해서는 안 됩니다.

규모 감각만을 위한 예로, 단순화된 선형 계산 하에서 $10,000 명목 가치에 0.0000125의 정산 요율을 가정하면 해당 구간의 펀딩 지급 규모는 $0.125가 됩니다. 어느 쪽이 지불하는지는 요율의 부호와 포지션 방향에 따라 달라집니다. 거래소의 공식 문서화된 계산식은 포지션 크기와 현물 오라클 가격을 사용합니다. 실제 계좌 기록과 세부 계약 사양이 최종 대조 검증을 지배합니다. 이 산술 계산은 가격 변동, 수수료 및 기타 모든 계좌 이벤트를 제외한 것입니다.

데이터 시계열을 사용하기 전에 검증하기

정확한 요청 본문, 시장 식별자, 데이터 수집 시각 및 수정되지 않은 원시 응답을 아카이브에 저장하십시오. 각 밀리초 타임스탬프를 UTC로 변환하고 시간 순으로 정렬하십시오. 관측된 정산 간격, 요청된 범위에 대한 예상 행 수, 중복 여부, 결측 구간, 예기치 않은 코인 명칭, null 값 및 숫자 파싱 실패 값을 꼼꼼히 점검하십시오. 반환된 첫 번째 및 마지막 시간을 요청된 범위와 대조하십시오. 장기 시계열의 경우 위의 문서화된 연속 조회 규칙을 따르고 각 페이지 경계를 대조하며 중복 제거된 분석 테이블에서 제외된 행들을 명확히 기록하십시오.

누락된 관측치는 알 수 없는 상태로 유지해야 합니다. 비어 있는 시간대를 0으로 채우거나 이전 요율을 그대로 이월하거나 라벨 표기 없이 가장 가까운 기록을 억지로 결합해서는 안 됩니다. 봉 단위 테스트의 경우 정산 타임스탬프에서 관찰된 요율이 해당 시점 이전과 이후 중 어디에 적용되는지 정의하고 이를 거래소의 펀딩 이벤트 및 포지션 스냅샷과 일치시키십시오. 차트가 나중에 현지 시간을 표시하더라도 원본 타임스탬프는 항상 UTC로 저장하십시오.

fundingHistory 엔드포인트는 명명된 코인 및 제한된 시간 간격에 대한 시장 펀딩비 시리즈를 제공합니다. userFunding 엔드포인트는 지정된 공개 계정에 대해 시간 간격 동안 펀딩 원장 이벤트를 제공합니다. 펀딩비는 시장 연구에 정보를 제공할 수 있습니다; 해당 계정의 기록된 현금 흐름을 조정하려면 계정 이벤트가 필요합니다. 한 소스를 다른 소스로 대체하지 마십시오. 설명용 교육 그래픽 · 실시간 시장 데이터 아님

계좌 지급 기록은 별도로 대조 검증하기

문서화된 userFunding 요청은 계좌 지갑 주소와 밀리초 단위의 시작 시각(경계 포함)을 입력받습니다. 종료 시각은 선택 사항이며 기본값은 현재 시간입니다. 응답 예시에는 coin, fundingRate, 포지션 크기, 부호 있는 USDC 금액 및 이벤트 시간과 같은 필드가 포함된 펀딩 변동 내역이 들어 있습니다. 어떤 금액이 실현되었다고 단정하기 전에 이러한 이벤트 기록을 계좌의 실제 포지션 및 거래소 원장과 교차 대조하십시오. 단순 날짜만으로 공개 시장 펀딩비율을 개별 계좌 지급액과 무턱대고 결합하거나 모든 계좌가 모든 정산 시점에 포지션을 보유하고 있었다고 가정해서는 안 됩니다.

이러한 과거 내역 요청이 비밀키를 요구하지 않더라도 계좌 주소는 트레이딩 활동을 외부에 노출할 수 있습니다. 명확한 이유와 사전 동의 없이 타인의 지갑 주소나 계좌 내역을 공개하지 마십시오. 읽기 전용 정보 쿼리에 개인키, 시드 구문 또는 서명 자격 증명을 절대 입력하지 마십시오.

SuperQuant는 사용자가 제공한 펀딩비 입력값을 수용하며 합성 샘플 데이터를 포함하고 있습니다. 완전하고 독립적으로 검증된 Hyperliquid 전체 과거 내역을 아카이브하고 있다고 주장하지 않습니다. 펀딩비 해설, 과거 데이터 점검, 수수료 및 펀딩비 워크시트 및 무기한 선물 펀딩 정산 감사 워크시트를 활용하여 이벤트별 거래소 규칙, 원시 요율 및 계좌 보고 지급액을 한데 묶어 관리하십시오. 본 워크시트는 기록 관리를 돕는 도구일 뿐 Hyperliquid로의 자동 연결기이거나 실제 정산을 증명하는 보증이 아닙니다. 본 문서는 데이터 소스 실습 가이드이며 투자 조언이나 거래소 추천이 아닙니다.

이 글은 교육용이며, 개인화된 금융 또는 투자 조언이 아닙니다. 거래에는 손실 위험이 따릅니다.