Skip to main content
Users API를 사용하여 사용자를 검색하고, 프로필을 조회하거나 업데이트하고, 사용자가 계정, 상품 또는 경험에 액세스할 수 있는지 확인하세요.

엔드포인트

속성

string
필수
사용자 ID이며, 접두사는 user_입니다.
object | null
필수
사용자의 잔액: 개인 현금 + 기타 보유 자산 + 아직 처리 중인 입금, 그리고 사용자가 소유한 계정의 잔액. 잔액 읽기 범위가 있는 호출자에 대해 셀프 뷰(예약된 id me로 조회)에서만 계산되며, 그 외에는 null이고 include_balance=false인 경우에도 null입니다.

속성

object[]
필수
사용자가 소유한 계정의 잔액으로, 잔액이 높은 순서로 정렬됩니다. 잔액이 없는 계정은 제외됩니다.

속성

string
필수
계정 ID로, biz_************* 형태입니다.
string
필수
계정의 총 잔액(USD).
string | null
필수
계정의 로고 URL.
string | null
필수
계정의 표시 이름.
string
필수
사용자가 소유한 모든 계정의 USD 잔액 합계.
object[]
필수
통화별 법정화폐 현금 잔액.

속성

number
필수
기본 통화 기준 사용 가능 잔액.
number
필수
USD로 환산한 사용 가능 잔액.
string
필수
usd 또는 eur와 같은 소문자 ISO 통화 코드.
number
필수
사용자 자신의 지갑 또는 카드로 이동 중인 잔액(USD 환산).
number
필수
USD로 환산한 대기 중 잔액.
number | null
필수
기본 통화 단위당 USD 가격이며, 환율을 사용할 수 없는 경우 null입니다.
number
필수
USD로 환산한 예비 잔액.
number
필수
기본 통화 기준 인출 가능 금액.
string
필수
대기 중, 이동 중, 예비 금액을 포함한 USD 기준 법정화폐 현금.
object[]
필수
원장 자체 지갑에 있는 토큰별 암호화폐 보유 자산.

속성

string
필수
기본 토큰 단위로 보유한 금액(십진수 문자열).
object
필수
사용 가능, 대기 중, 이동 중, 예비 금액으로 나눈 잔액(기본 단위 십진수 문자열). 사용자 자신의 지갑과 카드 간 이체는 도착할 때까지 in_transit에 보고됩니다.

속성

string
필수
지금 사용, 송금 또는 인출할 수 있는 금액(기본 단위, 십진수 문자열).
string
필수
이미 정산되어 계정의 암호화폐 지갑 또는 Whop Card로 이동하기를 기다리는 pending의 일부로, 이동 후 available이 됩니다. 이동은 보통 1시간 이내에 시작되며, 진행되는 동안에는 해당 금액이 대신 in_transit에 보고됩니다. 계정의 유지 최소 잔액을 보충하기 위해서만 이동한 금액은 포함되지 않습니다. 기본 단위, 십진수 문자열.
string
필수
카드 충전과 같이 계정 자체의 목적지 간에 이동 중인 금액. 기본 단위, 십진수 문자열.
string
필수
아직 정산 중인 최근 결제의 금액(기본 단위, 십진수 문자열).
object[]
필수
대기 중 금액이 정산될 것으로 예상되는 시기로, 하루에 하나의 항목이 가장 이른 날짜부터 나열됩니다. finishing_settlement를 포함하여 예정된 정산일이 없는 금액은 제외되므로, 이 항목들과 finishing_settlement의 합은 pending보다 작을 수는 있지만 클 수는 없습니다.

속성

string
필수
해당 날짜에 예상되는 금액(기본 단위, 십진수 문자열).
string
필수
이 금액의 정산이 완료될 것으로 예상되는 날짜(ISO 8601 날짜).
string
필수
보류된 금액(기본 단위, 십진수 문자열). 보류 사유와 해제 시점은 계정의 예비금을 조회하여 확인하세요.
string | null
필수
토큰 아이콘 URL.
string | null
필수
토큰의 표시 이름.
number | null
필수
토큰당 USD 가격이며, 알 수 없는 경우 null입니다.
string
필수
USDT, XAUT, cbBTC와 같은 토큰 표시 심볼.
number
필수
보유 자산의 USD 가치.
string
필수
USD 기준 암호화폐 보유 자산.
string
필수
법정화폐 대기 중 및 이동 중 잔액과 처리 중인 트레저리 입금(USD).
string
필수
사용자의 개인 잔액(USD): 현금(사용 가능 + 대기 중 + 이동 중 + 예비) + 기타 보유 자산 + 아직 처리 중인 입금. 계정 잔액은 제외됩니다(businesses_total_usd 참조).
string
필수
아직 처리 중인 사용자 지갑으로의 잔액 이동(USD).
object | null
필수
잔액 차트를 위한 시간에 따른 사용자의 누적 지갑 잔액(USD \{ t, v } 포인트와 last/min/max). 예약된 id me로 자신을 조회할 때 include_balance_history=true로 옵트인하세요. 잔액 읽기 범위가 있는 호출자에 대해서만 채워지며 그 외에는 null입니다. 지갑 활동이 없는 사용자는 빈 시리즈를 반환합니다.

속성

object[]
필수
요청한 기간 동안의 누적 잔액 포인트로, 오래된 순서로 정렬됩니다.

속성

integer
필수
포인트 타임스탬프(Unix 초).
number
필수
이 시점의 누적 지갑 잔액(USD).
number
필수
가장 최근 포인트의 값(USD).
number
필수
기간 내 최댓값(USD).
number
필수
기간 내 최솟값(USD).
object[]
필수
사용자의 개인 보유 자산으로, 각각 USD 가치와 내역을 포함하며 계정의 balances와 같은 형태입니다. total_usd가 null이면 비어 있습니다.

속성

string
필수
보유한 총 금액(기본 단위, 십진수 문자열).
object
필수
사용 가능, 대기 중, 예비 금액으로 나눈 잔액(기본 단위 십진수 문자열)과 대기 중 금액이 정산될 것으로 예상되는 날짜.

속성

string
필수
지금 사용, 송금 또는 인출할 수 있는 금액(기본 단위, 십진수 문자열).
string
필수
이미 정산되어 계정의 암호화폐 지갑 또는 Whop Card로 이동하기를 기다리는 pending의 일부로, 이동 후 available이 됩니다. 이동은 보통 1시간 이내에 시작되며, 진행되는 동안에는 해당 금액이 대신 in_transit에 보고됩니다. 계정의 유지 최소 잔액을 보충하기 위해서만 이동한 금액은 포함되지 않습니다. 기본 단위, 십진수 문자열.
string
필수
카드 충전과 같이 계정 자체의 목적지 간에 이동 중인 금액. 기본 단위, 십진수 문자열.
string
필수
아직 정산 중인 최근 결제의 금액(기본 단위, 십진수 문자열).
object[]
필수
대기 중 금액이 정산될 것으로 예상되는 시기로, 하루에 하나의 항목이 가장 이른 날짜부터 나열됩니다. finishing_settlement를 포함하여 예정된 정산일이 없는 금액은 제외되므로, 이 항목들과 finishing_settlement의 합은 pending보다 작을 수는 있지만 클 수는 없습니다.

속성

string
필수
해당 날짜에 예상되는 금액(기본 단위, 십진수 문자열).
string
필수
이 금액의 정산이 완료될 것으로 예상되는 날짜(ISO 8601 날짜).
string
필수
보류된 금액(기본 단위, 십진수 문자열). 보류 사유와 해제 시점은 계정의 예비금을 조회하여 확인하세요.
string | null
필수
보유 자산 아이콘 URL.
string
필수
보유 자산의 표시 이름
number | null
필수
단위당 USD 가격. 환율을 사용할 수 없는 경우 null입니다.
string
필수
USDT, cbBTC, EUR과 같은 보유 자산 표시 기호.
string | null
필수
보유 자산의 USD 가치. 환율을 사용할 수 없는 경우 null입니다.
object | null
필수
사용자의 프로필 배너 래퍼. 사용자에게 배너가 없으면 null입니다.

속성

string
필수
프로필 배너 이미지 URL.
string | null
필수
사용자의 자기소개
object | null
필수
사용자의 개인 카드 신청 진행 상태. 잔액 읽기 범위가 있는 호출자에 대해 셀프 뷰(예약된 id me로 조회)에서만 채워지며, 그 외에는 null이고 사용자가 카드를 신청한 적이 없는 경우에도 null입니다.

속성

string | null
필수
카드 발급사가 신청을 거절한 사유. 미국 내 인증된 개인 또는 비즈니스의 경우 unsupported_state가 unsupported_region을 대체합니다. compliance는 제재, 정치적 주요 인물 및 부정적 미디어 검사를 포함합니다. other는 이 목록에 없는 사유를 포함합니다. status가 denied가 아니거나 발급사가 신청을 거절하지 않은 경우 null입니다.사용 가능한 옵션: compromised_identity, duplicate, unsupported_region, compliance, fraud, verification_failed, unsupported_state, other
string | null
필수
카드 신청이 비즈니스(business, KYB)를 인증하는지 개인(individual, 소비자 신원)을 인증하는지 여부. 신청이 아직 인증에 연결되지 않은 경우 null입니다.사용 가능한 옵션: individual, business
string
필수
카드 신청의 현재 상태. approved는 카드를 발급할 수 있음을 의미합니다. needs_verification은 신청자가 아직 신원 인증을 완료하지 않았음을 의미하고, needs_information은 인증을 완료했지만 수정 가능한 사유로 서류가 거부되어 다시 제출해야 함을 의미합니다. pending과 manual_review는 진행 중입니다. denied, locked, canceled는 최종 상태입니다.사용 가능한 옵션: approved, pending, manual_review, denied, locked, canceled, needs_verification, needs_information
string | null
필수
IP 주소에서 파생된 사용자의 도시입니다. 알 수 없거나 사용자가 위치 공유를 끈 경우 null입니다.
string | null
필수
IP 주소에서 파생된 ISO 3166-1 alpha-2 코드 형식의 사용자 국가. 알 수 없거나 사용자가 위치 공유를 끈 경우 null입니다.
string
필수
사용자가 생성된 시점(ISO 8601 타임스탬프)
string | null
필수
1998-04-23과 같은 ISO 8601 날짜 형식의 사용자 생년월일. 이메일 읽기 범위가 있는 호출자에 대해 셀프 뷰(예약된 id me로 조회)에서만 채워지며, 그 외에는 null이고 사용자가 설정하지 않은 경우에도 null입니다.
object | null
필수
파트너 커미션 내역을 포함한 시간에 따른 사용자의 총 USD 수입. 잔액 읽기 범위가 있는 호출자의 단일 사용자 셀프 조회에서만 채워지며, 그 외에는 null입니다.

속성

string | null
필수
사용자가 처음으로 총수입을 얻은 시점(ISO 8601 타임스탬프).
object
필수
사용자가 소유하거나 소유자 권한을 가진 계정에서 발생한 총수입.

속성

string
필수
최근 24시간 동안의 총수입(USD)입니다.
string
필수
최근 30일 동안의 총수입(USD)입니다.
string
필수
최근 7일 동안의 총수입(USD)입니다.
string
필수
전체 기간 총수입(USD)입니다.
object
필수
사용자 지갑에 입금된 파트너 커미션. 대기 중인 파트너 지급은 입금될 때까지 제외되며, 이후의 취소는 총수입을 줄이지 않습니다.

속성

string
필수
최근 24시간 동안의 총수입(USD)입니다.
string
필수
최근 30일 동안의 총수입(USD)입니다.
string
필수
최근 7일 동안의 총수입(USD)입니다.
string
필수
전체 기간 총수입(USD)입니다.
object
필수
사용자 개인 지갑에서 발생한 총수입.

속성

string
필수
최근 24시간 동안의 총수입(USD)입니다.
string
필수
최근 30일 동안의 총수입(USD)입니다.
string
필수
최근 7일 동안의 총수입(USD)입니다.
string
필수
전체 기간 총수입(USD)입니다.
object
필수
사용자 개인 지갑과 사용자가 소유하거나 소유자 권한을 가진 계정에서 발생한 총수입.

속성

string
필수
최근 24시간 동안의 총수입(USD)입니다.
string
필수
최근 30일 동안의 총수입(USD)입니다.
string
필수
최근 7일 동안의 총수입(USD)입니다.
string
필수
전체 기간 총수입(USD)입니다.
string | null
필수
사용자의 이메일 주소. 이메일 읽기 범위가 있는 호출자에 대해 셀프 뷰(예약된 id me로 조회)에서만 채워지며, 그 외에는 null이고 계정에 아직 확인된 이메일이 없는 동안에도 null입니다.
integer
필수
이 사용자를 팔로우하는 사용자 수.
object | null
필수
사용자가 소유한 모든 계정에 걸쳐 집계된 사용자의 Whop Level. current는 공개됩니다. 포인트 및 지출 필드는 예약된 id me로 자신을 조회하고 잔액 읽기 범위가 있는 경우에만 채워집니다. 목록에서는 null이며, 사용자의 계정 중 Whop Levels에 포함된 것이 없는 경우에도 null입니다.

속성

integer
필수
적용되는 레벨: 이번 달 또는 이전 5개월 동안 사용자가 도달한 가장 높은 레벨로, 0부터 10까지입니다. 공개됩니다.
integer | null
필수
사용자가 소유한 모든 계정에서 이번 달에 얻은 포인트와 파트너 포인트의 합계(내림). 월 순합계가 0 미만인 계정은 0으로 계산됩니다. 예약된 id me로 자신을 조회하고 잔액 읽기 범위가 있는 경우가 아니면 null입니다.
object | null
필수
획득처별로 나눈 이번 달 포인트. 각 출처는 환불을 차감한 값이므로 음수일 수 있습니다. 예약된 id me로 자신을 조회하고 잔액 읽기 범위가 있는 경우가 아니면 null입니다.

속성

integer
필수
환불을 차감한 결제된 Whop Ads 청구액에서 얻은 포인트: 1달러당 10포인트, 0 방향으로 반올림.
integer
필수
환불을 차감한 확정된 Whop Card 지출에서 얻은 포인트: 1달러당 10포인트, 0 방향으로 반올림.
integer
필수
소유자가 파트너로서 추천한 계정에서 얻은 포인트: 해당 계정이 3포인트를 얻을 때마다 1포인트, 0 방향으로 반올림.
integer
필수
Whop을 통해 체결된 무기한 선물 거래량에서 얻은 포인트: 거래 1달러당 1포인트, 0 방향으로 반올림.
string | null
필수
이번 달 포인트가 0으로 초기화되는 시점(ISO 8601 타임스탬프). 예약된 id me로 자신을 조회하고 잔액 읽기 범위가 있는 경우가 아니면 null입니다.
string | null
필수
사용자의 표시 이름
object
필수
아바타 래퍼입니다. url은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 자리 표시자입니다.

속성

string
필수
아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 자리 표시자입니다.
사용자의 공개 프로필에 있는 소셜 계정과 웹사이트. 없으면 비어 있습니다.

속성

string
필수
링크의 URL.
string | null
필수
입력되었거나 연결된 계정에서 보고된 플랫폼상의 사용자 핸들. 개인 사이트처럼 핸들이 없는 링크의 경우 null입니다.
boolean
필수
사용자가 해당 계정을 소유하고 있음을 Whop이 인증했는지 여부.
string
필수
링크가 가리키는 플랫폼. website는 소셜 플랫폼이 아닌 개인 사이트입니다.사용 가능한 옵션: x, instagram, facebook, tiktok, youtube, linkedin, twitch, website
string | null
필수
IP 주소에서 파생된 사용자의 주 또는 지역. 알 수 없거나 사용자가 위치 공유를 끈 경우 null입니다.
string | null
필수
환율을 알 수 있는 항목에 대한 balances 내 사용자 개인 보유 자산의 총 USD 가치. 잔액 읽기 범위가 있는 호출자에 대해 셀프 뷰(예약된 id me로 조회)에서만 계산되며, 그 외, include_balance=false인 경우, 또는 잔액 소스를 사용할 수 없는 경우 null입니다.
trading_account | null
필수
트레이딩 계정 주소, 증거금 및 미결제 포지션의 스냅샷, WebSocket 구독. me를 조회할 때 include_trading=true로 옵트인하세요. 그 외, 트레이딩 권한이 없는 경우, 또는 Ethereum 지갑이 없는 경우 null입니다.

속성

string
필수
이 트레이딩 계정을 지원하는 Whop 지갑 ID로, cwal_ 접두사가 붙습니다.
string | null
필수
이 트레이딩 계정을 소유한 계정으로, biz_ 접두사가 붙습니다. 사용자가 소유한 경우 null입니다.
object | null
필수
Hyperliquid 전용 상태. provider가 hyperliquid인 경우 존재하며, 그 외에는 null입니다.

속성

string
필수
Hyperliquid 계정을 보유한 소문자 지갑 주소.
string | null
필수
deposit 거래로 이 계정에 옮길 수 있는 Plasma 상 Whop 지갑의 USDT0(십진수 문자열). 체인을 읽을 수 없는 경우 null입니다.
object | null
필수
메인 거래소와 xyz 마켓 전반의 계정 가치 및 증거금으로, Hyperliquid에서 최대 초당 한 번 읽어 옵니다. Hyperliquid를 읽을 수 없는 경우 null입니다. 실시간 업데이트에는 websocket_subscriptions를 사용하세요.

속성

object
필수
미실현 손익을 포함한 총 계정 가치(USD).

속성

string
필수
주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 자리 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object
필수
미결제 포지션 전반에 할당된 증거금(USD).

속성

string
필수
주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 자리 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object
필수
미결제 포지션의 합산 명목 가치(USD).

속성

string
필수
주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 자리 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object
필수
포지션을 청산하지 않고 지금 인출할 수 있는 USD.

속성

string
필수
주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 자리 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
trading_position[] | null
필수
메인 거래소와 xyz 마켓 전반의 미결제 무기한 선물 포지션으로, Hyperliquid에서 최대 초당 한 번 읽어 옵니다. Hyperliquid를 읽을 수 없는 경우 null입니다. 실시간 업데이트에는 websocket_subscriptions를 사용하세요.

속성

string
필수
trdpos_ 접두사가 붙은 트레이딩 포지션 ID. 하나의 트레이딩 계정 내에서 마켓별로 고정됩니다.
object | null
필수
평균 진입 가격(USD). 제공자가 생략한 경우 null입니다.

속성

string
필수
주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 자리 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object | null
필수
Hyperliquid 무기한 선물 세부 정보. Hyperliquid 포지션에 존재하며, 그 외에는 null입니다.

속성

object
필수
여러 기간에 걸쳐 포지션에 지불된 펀딩(USD).

속성

object | null
필수
계정 기록 전체에서 이 마켓에 지불된 펀딩(USD). 사용할 수 없는 경우 null입니다.

속성

string
필수
주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 자리 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object | null
필수
포지션 크기가 마지막으로 변경된 이후 지불된 펀딩(USD). 사용할 수 없는 경우 null입니다.

속성

string
필수
주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 자리 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object | null
필수
포지션이 열린 이후 지불된 펀딩(USD). 사용할 수 없는 경우 null입니다.

속성

string
필수
주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 자리 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object
필수
포지션의 증거금 모드와 배수.

속성

string
필수
cross는 포지션 간에 증거금을 공유합니다. isolated는 증거금을 이 포지션으로 제한합니다.사용 가능한 옵션: cross, isolated
integer
필수
포지션 증거금에 적용되는 배수(예: 10배의 경우 10).
object | null
필수
예상 청산 가격(USD). Hyperliquid가 보고하지 않는 경우 null입니다.

속성

string
필수
주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 자리 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object
필수
포지션에 할당된 증거금(USD).

속성

string
필수
주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 자리 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
string
필수
십진수 비율 문자열로 표현한 자기자본이익률(예: 10%의 경우 0.1).
string
필수
제공자의 마켓 기호(예: ETH).
string
필수
object
필수
현재 포지션 가치(USD).

속성

string
필수
주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 자리 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
string
필수
사용 가능한 옵션: long, short
string
필수
십진수 문자열로 표현한 절대 포지션 크기.
object
필수
미실현 손익(USD). 손실인 경우 음수입니다.

속성

string
필수
주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 자리 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object[]
필수
실시간 계정 업데이트를 위한 구독. websocket_url에 연결한 후 각 message를 변경 없이 전송하세요.

속성

string
필수
이 구독이 여는 실시간 업데이트 스트림.사용 가능한 옵션: clearinghouse_state, open_orders, order_updates, user_fills, user_events
string
필수
Hyperliquid WebSocket을 통해 변경 없이 전송할 JSON 구독 메시지.
string
필수
실시간 업데이트를 위해 직접 연결할 Hyperliquid WebSocket URL.
string
필수
string
필수
포지션과 주문을 보유하는 거래 장소.사용 가능한 옵션: hyperliquid
object | null
필수
진입 가격과 손익이 포함된 Whop 지갑의 현물 보유 자산. 읽을 수 없는 경우 null입니다.

속성

object[]
필수
지갑이 아직 보유하고 있는 각 현물 자산과 평균 진입 가격 및 손익. 취득 원가는 가장 오래된 단위를 먼저 판매한 것으로 계산하며, Whop 외부에서 들어온 자산도 포함합니다.

속성

object | null
필수
아직 보유 중인 단위당 평균 지불 가격(USD)으로, 가장 오래된 단위를 먼저 판매한 것으로 계산합니다. 알 수 없는 경우 null입니다.

속성

string
필수
주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 자리 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object
필수
아직 보유 중인 단위에 대해 지불한 USD 금액.

속성

string
필수
주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 자리 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
string
필수
GET /trades/markets의 현물 마켓 id(예: BTC, XAUT 또는 AAPL과 같은 토큰화된 주식의 티커).
object
필수
매도를 통해 이미 확정된 손익(USD).

속성

string
필수
주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 자리 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object
필수
아직 보유 중인 단위의 가치에서 cost_basis를 뺀 값(USD).

속성

string
필수
주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 자리 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
number | null
필수
cost_basis 대비 unrealized_pnl의 백분율로, 2는 2% 상승을 의미합니다. 알 수 없는 경우 null입니다.
string | null
필수
이 트레이딩 계정을 소유한 사용자로, user_ 접두사가 붙습니다. 계정이 소유한 경우 null입니다.
string
필수
사용자의 고유한 사용자 이름
object
필수
사용자의 individual(KYC) 및 business(KYB) 프로필에 대한 신원 인증 상태. 각각 생성되기 전까지는 null이며, 그 외에는 not_started, pending, approved 또는 rejected 중 하나의 status입니다.
string | null
필수
사용자가 인증 배지를 받은 시점(ISO 8601 타임스탬프). 사용자가 인증되지 않은 경우 null입니다.
string | null
필수
사용자가 Whop Partner로 등록된 시점(ISO 8601 타임스탬프). 등록한 적이 없으면 null입니다.
integer | null
필수
사용자가 Whop Partner로서 Whop에 추천한 계정 중 사용자에게 귀속된 거래액이 $1를 초과한 계정 수. Verified Whop Partner인 단일 사용자를 조회할 때만 채워지며, 그 외에는 null입니다.
string | null
필수
사용자가 Verified Whop Partner가 된 시점(ISO 8601 타임스탬프). 프로그램을 떠난 파트너와 정지된 사용자를 포함하여 Verified Whop Partner가 아닌 사용자의 경우 null입니다.
User