> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Users API

> User는 Whop의 사람을 나타냅니다. 사용자는 공개 프로필을 가지며 상품을 구매하고, 계정에 참여하고, 경험에 액세스할 수 있습니다.

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

## 엔드포인트

| 엔드포인트 | 요청 |
| - | - |
| [사용자 목록 조회](https://docs.whop.com/ko/api-reference/users/list-users.md) | GET `/users` |
| [사용자 조회](https://docs.whop.com/ko/api-reference/users/retrieve-user.md) | GET `/users/{id}` |
| [사용자 액세스 확인](https://docs.whop.com/ko/api-reference/users/check-user-access.md) | GET `/users/{id}/access/{resource_id}` |
| [사용자 수수료 조회](https://docs.whop.com/ko/api-reference/users/retrieve-user-fees.md) | GET `/users/{user_id}/fees` |
| [추천 작업 목록 조회](https://docs.whop.com/ko/api-reference/users/list-recommended-actions.md) | GET `/users/{id}/recommend_actions` |
| [OAuth 권한 부여 목록 조회](https://docs.whop.com/ko/api-reference/users/list-oauth-grants.md) | GET `/users/me/oauth_grants` |
| [목록 조회](https://docs.whop.com/ko/api-reference/users/list.md) | GET `/users/me/passkeys` |
| [조회](https://docs.whop.com/ko/api-reference/users/retrieve.md) | GET `/users/me/preferences` |
| [경험 목록 조회](https://docs.whop.com/ko/api-reference/users/list-experiences.md) | GET `/users/me/preferences/notifications/experiences` |
| [토픽 목록 조회](https://docs.whop.com/ko/api-reference/users/list-topics.md) | GET `/users/me/preferences/notifications/topics` |
| [앱 승인](https://docs.whop.com/ko/api-reference/users/authorize-an-app.md) | POST `/users/me/oauth_grants` |
| [등록](https://docs.whop.com/ko/api-reference/users/register.md) | POST `/users/me/passkeys` |
| [챌린지 생성](https://docs.whop.com/ko/api-reference/users/create-challenge.md) | POST `/users/me/passkeys/challenge` |
| [사용자 업데이트](https://docs.whop.com/ko/api-reference/users/update-user.md) | PATCH `/users/{id}` |
| [업데이트](https://docs.whop.com/ko/api-reference/users/update.md) | PATCH `/users/me/preferences` |
| [설정](https://docs.whop.com/ko/api-reference/users/set.md) | PATCH `/users/me/preferences/notifications` |
| [삭제](https://docs.whop.com/ko/api-reference/users/delete.md) | DELETE `/users/me/passkeys/{id}` |

## 속성

**id** `string` *required*

사용자 ID이며, 접두사는 `user_`입니다.

**balance** `object | null` *required*

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

> [accordion] 속성
>
> **businesses** `object[]` *required*
>
> 사용자가 소유한 계정의 잔액으로, 잔액이 높은 순서로 정렬됩니다. 잔액이 없는 계정은 제외됩니다.
>
> > [accordion] 속성
> >
> > **id** `string` *required*
> >
> > 계정 ID로, biz\_\*\*\*\*\*\*\*\*\*\*\*\*\* 형태입니다.
> >
> > **balance\_usd** `string` *required*
> >
> > 계정의 총 잔액(USD).
> >
> > **logo\_url** `string | null` *required*
> >
> > 계정의 로고 URL.
> >
> > **name** `string | null` *required*
> >
> > 계정의 표시 이름.
>
> **businesses\_total\_usd** `string` *required*
>
> 사용자가 소유한 모든 계정의 USD 잔액 합계.
>
> **cash** `object[]` *required*
>
> 통화별 법정화폐 현금 잔액.
>
> > [accordion] 속성
> >
> > **balance** `number` *required*
> >
> > 기본 통화 기준 사용 가능 잔액.
> >
> > **balance\_usd** `number` *required*
> >
> > USD로 환산한 사용 가능 잔액.
> >
> > **currency** `string` *required*
> >
> > `usd` 또는 `eur`와 같은 소문자 ISO 통화 코드.
> >
> > **in\_transit\_balance\_usd** `number` *required*
> >
> > 사용자 자신의 지갑 또는 카드로 이동 중인 잔액(USD 환산).
> >
> > **pending\_balance\_usd** `number` *required*
> >
> > USD로 환산한 대기 중 잔액.
> >
> > **price\_usd** `number | null` *required*
> >
> > 기본 통화 단위당 USD 가격이며, 환율을 사용할 수 없는 경우 `null`입니다.
> >
> > **reserve\_balance\_usd** `number` *required*
> >
> > USD로 환산한 예비 잔액.
> >
> > **total\_withdrawable\_balance** `number` *required*
> >
> > 기본 통화 기준 인출 가능 금액.
>
> **cash\_usd** `string` *required*
>
> 대기 중, 이동 중, 예비 금액을 포함한 USD 기준 법정화폐 현금.
>
> **crypto** `object[]` *required*
>
> 원장 자체 지갑에 있는 토큰별 암호화폐 보유 자산.
>
> > [accordion] 속성
> >
> > **balance** `string` *required*
> >
> > 기본 토큰 단위로 보유한 금액(십진수 문자열).
> >
> > **breakdown** `object` *required*
> >
> > 사용 가능, 대기 중, 이동 중, 예비 금액으로 나눈 잔액(기본 단위 십진수 문자열). 사용자 자신의 지갑과 카드 간 이체는 도착할 때까지 `in_transit`에 보고됩니다.
> >
> > > [accordion] 속성
> > >
> > > **available** `string` *required*
> > >
> > > 지금 사용, 송금 또는 인출할 수 있는 금액(기본 단위, 십진수 문자열).
> > >
> > > **finishing\_settlement** `string` *required*
> > >
> > > 이미 정산되어 계정의 암호화폐 지갑 또는 Whop Card로 이동하기를 기다리는 `pending`의 일부로, 이동 후 `available`이 됩니다. 이동은 보통 1시간 이내에 시작되며, 진행되는 동안에는 해당 금액이 대신 `in_transit`에 보고됩니다. 계정의 유지 최소 잔액을 보충하기 위해서만 이동한 금액은 포함되지 않습니다. 기본 단위, 십진수 문자열.
> > >
> > > **in\_transit** `string` *required*
> > >
> > > 카드 충전과 같이 계정 자체의 목적지 간에 이동 중인 금액. 기본 단위, 십진수 문자열.
> > >
> > > **pending** `string` *required*
> > >
> > > 아직 정산 중인 최근 결제의 금액(기본 단위, 십진수 문자열).
> > >
> > > **pending\_settlements** `object[]` *required*
> > >
> > > 대기 중 금액이 정산될 것으로 예상되는 시기로, 하루에 하나의 항목이 가장 이른 날짜부터 나열됩니다. `finishing_settlement`를 포함하여 예정된 정산일이 없는 금액은 제외되므로, 이 항목들과 `finishing_settlement`의 합은 `pending`보다 작을 수는 있지만 클 수는 없습니다.
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 해당 날짜에 예상되는 금액(기본 단위, 십진수 문자열).
> > > >
> > > > **date** `string` *required*
> > > >
> > > > 이 금액의 정산이 완료될 것으로 예상되는 날짜(ISO 8601 날짜).
> > >
> > > **reserve** `string` *required*
> > >
> > > 보류된 금액(기본 단위, 십진수 문자열). 보류 사유와 해제 시점은 계정의 예비금을 조회하여 확인하세요.
> >
> > **icon\_url** `string | null` *required*
> >
> > 토큰 아이콘 URL.
> >
> > **name** `string | null` *required*
> >
> > 토큰의 표시 이름.
> >
> > **price\_usd** `number | null` *required*
> >
> > 토큰당 USD 가격이며, 알 수 없는 경우 `null`입니다.
> >
> > **symbol** `string` *required*
> >
> > `USDT`, `XAUT`, `cbBTC`와 같은 토큰 표시 심볼.
> >
> > **value\_usd** `number` *required*
> >
> > 보유 자산의 USD 가치.
>
> **crypto\_usd** `string` *required*
>
> USD 기준 암호화폐 보유 자산.
>
> **pending\_usd** `string` *required*
>
> 법정화폐 대기 중 및 이동 중 잔액과 처리 중인 트레저리 입금(USD).
>
> **total\_usd** `string` *required*
>
> 사용자의 개인 잔액(USD): 현금(사용 가능 + 대기 중 + 이동 중 + 예비) + 기타 보유 자산 + 아직 처리 중인 입금. 계정 잔액은 제외됩니다(businesses\_total\_usd 참조).
>
> **treasury\_pending\_usd** `string` *required*
>
> 아직 처리 중인 사용자 지갑으로의 잔액 이동(USD).

**balance\_history** `object | null` *required*

잔액 차트를 위한 시간에 따른 사용자의 누적 지갑 잔액(USD `\{ t, v }` 포인트와 last/min/max). 예약된 id `me`로 자신을 조회할 때 `include_balance_history=true`로 옵트인하세요. 잔액 읽기 범위가 있는 호출자에 대해서만 채워지며 그 외에는 `null`입니다. 지갑 활동이 없는 사용자는 빈 시리즈를 반환합니다.

> [accordion] 속성
>
> **data** `object[]` *required*
>
> 요청한 기간 동안의 누적 잔액 포인트로, 오래된 순서로 정렬됩니다.
>
> > [accordion] 속성
> >
> > **t** `integer` *required*
> >
> > 포인트 타임스탬프(Unix 초).
> >
> > **v** `number` *required*
> >
> > 이 시점의 누적 지갑 잔액(USD).
>
> **last** `number` *required*
>
> 가장 최근 포인트의 값(USD).
>
> **max** `number` *required*
>
> 기간 내 최댓값(USD).
>
> **min** `number` *required*
>
> 기간 내 최솟값(USD).

**balances** `object[]` *required*

사용자의 개인 보유 자산으로, 각각 USD 가치와 내역을 포함하며 계정의 `balances`와 같은 형태입니다. `total_usd`가 `null`이면 비어 있습니다.

> [accordion] 속성
>
> **balance** `string` *required*
>
> 보유한 총 금액(기본 단위, 십진수 문자열).
>
> **breakdown** `object` *required*
>
> 사용 가능, 대기 중, 예비 금액으로 나눈 잔액(기본 단위 십진수 문자열)과 대기 중 금액이 정산될 것으로 예상되는 날짜.
>
> > [accordion] 속성
> >
> > **available** `string` *required*
> >
> > 지금 사용, 송금 또는 인출할 수 있는 금액(기본 단위, 십진수 문자열).
> >
> > **finishing\_settlement** `string` *required*
> >
> > 이미 정산되어 계정의 암호화폐 지갑 또는 Whop Card로 이동하기를 기다리는 `pending`의 일부로, 이동 후 `available`이 됩니다. 이동은 보통 1시간 이내에 시작되며, 진행되는 동안에는 해당 금액이 대신 `in_transit`에 보고됩니다. 계정의 유지 최소 잔액을 보충하기 위해서만 이동한 금액은 포함되지 않습니다. 기본 단위, 십진수 문자열.
> >
> > **in\_transit** `string` *required*
> >
> > 카드 충전과 같이 계정 자체의 목적지 간에 이동 중인 금액. 기본 단위, 십진수 문자열.
> >
> > **pending** `string` *required*
> >
> > 아직 정산 중인 최근 결제의 금액(기본 단위, 십진수 문자열).
> >
> > **pending\_settlements** `object[]` *required*
> >
> > 대기 중 금액이 정산될 것으로 예상되는 시기로, 하루에 하나의 항목이 가장 이른 날짜부터 나열됩니다. `finishing_settlement`를 포함하여 예정된 정산일이 없는 금액은 제외되므로, 이 항목들과 `finishing_settlement`의 합은 `pending`보다 작을 수는 있지만 클 수는 없습니다.
> >
> > > [accordion] 속성
> > >
> > > **amount** `string` *required*
> > >
> > > 해당 날짜에 예상되는 금액(기본 단위, 십진수 문자열).
> > >
> > > **date** `string` *required*
> > >
> > > 이 금액의 정산이 완료될 것으로 예상되는 날짜(ISO 8601 날짜).
> >
> > **reserve** `string` *required*
> >
> > 보류된 금액(기본 단위, 십진수 문자열). 보류 사유와 해제 시점은 계정의 예비금을 조회하여 확인하세요.
>
> **icon\_url** `string | null` *required*
>
> 보유 자산 아이콘 URL.
>
> **name** `string` *required*
>
> 보유 자산의 표시 이름
>
> **price\_usd** `number | null` *required*
>
> 단위당 USD 가격. 환율을 사용할 수 없는 경우 `null`입니다.
>
> **symbol** `string` *required*
>
> `USDT`, `cbBTC`, `EUR`과 같은 보유 자산 표시 기호.
>
> **value\_usd** `string | null` *required*
>
> 보유 자산의 USD 가치. 환율을 사용할 수 없는 경우 `null`입니다.

**banner** `object | null` *required*

사용자의 프로필 배너 래퍼. 사용자에게 배너가 없으면 `null`입니다.

> [accordion] 속성
>
> **url** `string` *required*
>
> 프로필 배너 이미지 URL.

**bio** `string | null` *required*

사용자의 자기소개

**cards** `object | null` *required*

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

> [accordion] 속성
>
> **decline\_reason** `string | null` *required*
>
> 카드 발급사가 신청을 거절한 사유. 미국 내 인증된 개인 또는 비즈니스의 경우 `unsupported_state`가 `unsupported_region`을 대체합니다. `compliance`는 제재, 정치적 주요 인물 및 부정적 미디어 검사를 포함합니다. `other`는 이 목록에 없는 사유를 포함합니다. `status`가 `denied`가 아니거나 발급사가 신청을 거절하지 않은 경우 `null`입니다.
>
> 사용 가능한 옵션: `compromised_identity`, `duplicate`, `unsupported_region`, `compliance`, `fraud`, `verification_failed`, `unsupported_state`, `other`
>
> **kind** `string | null` *required*
>
> 카드 신청이 비즈니스(`business`, KYB)를 인증하는지 개인(`individual`, 소비자 신원)을 인증하는지 여부. 신청이 아직 인증에 연결되지 않은 경우 `null`입니다.
>
> 사용 가능한 옵션: `individual`, `business`
>
> **status** `string` *required*
>
> 카드 신청의 현재 상태. `approved`는 카드를 발급할 수 있음을 의미합니다. `needs_verification`은 신청자가 아직 신원 인증을 완료하지 않았음을 의미하고, `needs_information`은 인증을 완료했지만 수정 가능한 사유로 서류가 거부되어 다시 제출해야 함을 의미합니다. `pending`과 `manual_review`는 진행 중입니다. `denied`, `locked`, `canceled`는 최종 상태입니다.
>
> 사용 가능한 옵션: `approved`, `pending`, `manual_review`, `denied`, `locked`, `canceled`, `needs_verification`, `needs_information`

**city** `string | null` *required*

IP 주소에서 파생된 사용자의 도시입니다. 알 수 없거나 사용자가 위치 공유를 끈 경우 `null`입니다.

**country** `string | null` *required*

IP 주소에서 파생된 ISO 3166-1 alpha-2 코드 형식의 사용자 국가. 알 수 없거나 사용자가 위치 공유를 끈 경우 `null`입니다.

**created\_at** `string` *required*

사용자가 생성된 시점(ISO 8601 타임스탬프)

**date\_of\_birth** `string | null` *required*

`1998-04-23`과 같은 ISO 8601 날짜 형식의 사용자 생년월일. 이메일 읽기 범위가 있는 호출자에 대해 셀프 뷰(예약된 id `me`로 조회)에서만 채워지며, 그 외에는 `null`이고 사용자가 설정하지 않은 경우에도 `null`입니다.

**earnings\_usd** `object | null` *required*

파트너 커미션 내역을 포함한 시간에 따른 사용자의 총 USD 수입. 잔액 읽기 범위가 있는 호출자의 단일 사용자 셀프 조회에서만 채워지며, 그 외에는 `null`입니다.

> [accordion] 속성
>
> **first\_earned\_at** `string | null` *required*
>
> 사용자가 처음으로 총수입을 얻은 시점(ISO 8601 타임스탬프).
>
> **owned\_accounts** `object` *required*
>
> 사용자가 소유하거나 소유자 권한을 가진 계정에서 발생한 총수입.
>
> > [accordion] 속성
> >
> > **last\_24\_hours** `string` *required*
> >
> > 최근 24시간 동안의 총수입(USD)입니다.
> >
> > **last\_30\_days** `string` *required*
> >
> > 최근 30일 동안의 총수입(USD)입니다.
> >
> > **last\_7\_days** `string` *required*
> >
> > 최근 7일 동안의 총수입(USD)입니다.
> >
> > **lifetime** `string` *required*
> >
> > 전체 기간 총수입(USD)입니다.
>
> **partners** `object` *required*
>
> 사용자 지갑에 입금된 파트너 커미션. 대기 중인 파트너 지급은 입금될 때까지 제외되며, 이후의 취소는 총수입을 줄이지 않습니다.
>
> > [accordion] 속성
> >
> > **last\_24\_hours** `string` *required*
> >
> > 최근 24시간 동안의 총수입(USD)입니다.
> >
> > **last\_30\_days** `string` *required*
> >
> > 최근 30일 동안의 총수입(USD)입니다.
> >
> > **last\_7\_days** `string` *required*
> >
> > 최근 7일 동안의 총수입(USD)입니다.
> >
> > **lifetime** `string` *required*
> >
> > 전체 기간 총수입(USD)입니다.
>
> **personal** `object` *required*
>
> 사용자 개인 지갑에서 발생한 총수입.
>
> > [accordion] 속성
> >
> > **last\_24\_hours** `string` *required*
> >
> > 최근 24시간 동안의 총수입(USD)입니다.
> >
> > **last\_30\_days** `string` *required*
> >
> > 최근 30일 동안의 총수입(USD)입니다.
> >
> > **last\_7\_days** `string` *required*
> >
> > 최근 7일 동안의 총수입(USD)입니다.
> >
> > **lifetime** `string` *required*
> >
> > 전체 기간 총수입(USD)입니다.
>
> **total** `object` *required*
>
> 사용자 개인 지갑과 사용자가 소유하거나 소유자 권한을 가진 계정에서 발생한 총수입.
>
> > [accordion] 속성
> >
> > **last\_24\_hours** `string` *required*
> >
> > 최근 24시간 동안의 총수입(USD)입니다.
> >
> > **last\_30\_days** `string` *required*
> >
> > 최근 30일 동안의 총수입(USD)입니다.
> >
> > **last\_7\_days** `string` *required*
> >
> > 최근 7일 동안의 총수입(USD)입니다.
> >
> > **lifetime** `string` *required*
> >
> > 전체 기간 총수입(USD)입니다.

**email** `string | null` *required*

사용자의 이메일 주소. 이메일 읽기 범위가 있는 호출자에 대해 셀프 뷰(예약된 id `me`로 조회)에서만 채워지며, 그 외에는 `null`이고 계정에 아직 확인된 이메일이 없는 동안에도 `null`입니다.

**followers\_count** `integer` *required*

이 사용자를 팔로우하는 사용자 수.

**level** `object | null` *required*

사용자가 소유한 모든 계정에 걸쳐 집계된 사용자의 Whop Level. `current`는 공개됩니다. 포인트 및 지출 필드는 예약된 id `me`로 자신을 조회하고 잔액 읽기 범위가 있는 경우에만 채워집니다. 목록에서는 `null`이며, 사용자의 계정 중 Whop Levels에 포함된 것이 없는 경우에도 `null`입니다.

> [accordion] 속성
>
> **current** `integer` *required*
>
> 적용되는 레벨: 이번 달 또는 이전 5개월 동안 사용자가 도달한 가장 높은 레벨로, `0`부터 `10`까지입니다. 공개됩니다.
>
> **points** `integer | null` *required*
>
> 사용자가 소유한 모든 계정에서 이번 달에 얻은 포인트와 파트너 포인트의 합계(내림). 월 순합계가 0 미만인 계정은 0으로 계산됩니다. 예약된 id `me`로 자신을 조회하고 잔액 읽기 범위가 있는 경우가 아니면 `null`입니다.
>
> **points\_by\_source** `object | null` *required*
>
> 획득처별로 나눈 이번 달 포인트. 각 출처는 환불을 차감한 값이므로 음수일 수 있습니다. 예약된 id `me`로 자신을 조회하고 잔액 읽기 범위가 있는 경우가 아니면 `null`입니다.
>
> > [accordion] 속성
> >
> > **ads** `integer` *required*
> >
> > 환불을 차감한 결제된 Whop Ads 청구액에서 얻은 포인트: 1달러당 10포인트, 0 방향으로 반올림.
> >
> > **cards** `integer` *required*
> >
> > 환불을 차감한 확정된 Whop Card 지출에서 얻은 포인트: 1달러당 10포인트, 0 방향으로 반올림.
> >
> > **partners** `integer` *required*
> >
> > 소유자가 파트너로서 추천한 계정에서 얻은 포인트: 해당 계정이 3포인트를 얻을 때마다 1포인트, 0 방향으로 반올림.
> >
> > **trading** `integer` *required*
> >
> > Whop을 통해 체결된 무기한 선물 거래량에서 얻은 포인트: 거래 1달러당 1포인트, 0 방향으로 반올림.
>
> **resets\_at** `string | null` *required*
>
> 이번 달 포인트가 0으로 초기화되는 시점(ISO 8601 타임스탬프). 예약된 id `me`로 자신을 조회하고 잔액 읽기 범위가 있는 경우가 아니면 `null`입니다.

**name** `string | null` *required*

사용자의 표시 이름

**profile\_picture** `object` *required*

아바타 래퍼입니다. `url`은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 자리 표시자입니다.

> [accordion] 속성
>
> **url** `string` *required*
>
> 아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 자리 표시자입니다.

**social\_links** `object[]` *required*

사용자의 공개 프로필에 있는 소셜 계정과 웹사이트. 없으면 비어 있습니다.

> [accordion] 속성
>
> **url** `string` *required*
>
> 링크의 URL.
>
> **username** `string | null` *required*
>
> 입력되었거나 연결된 계정에서 보고된 플랫폼상의 사용자 핸들. 개인 사이트처럼 핸들이 없는 링크의 경우 `null`입니다.
>
> **verified** `boolean` *required*
>
> 사용자가 해당 계정을 소유하고 있음을 Whop이 인증했는지 여부.
>
> **website** `string` *required*
>
> 링크가 가리키는 플랫폼. `website`는 소셜 플랫폼이 아닌 개인 사이트입니다.
>
> 사용 가능한 옵션: `x`, `instagram`, `facebook`, `tiktok`, `youtube`, `linkedin`, `twitch`, `website`

**state** `string | null` *required*

IP 주소에서 파생된 사용자의 주 또는 지역. 알 수 없거나 사용자가 위치 공유를 끈 경우 `null`입니다.

**total\_usd** `string | null` *required*

환율을 알 수 있는 항목에 대한 `balances` 내 사용자 개인 보유 자산의 총 USD 가치. 잔액 읽기 범위가 있는 호출자에 대해 셀프 뷰(예약된 id `me`로 조회)에서만 계산되며, 그 외, `include_balance=false`인 경우, 또는 잔액 소스를 사용할 수 없는 경우 `null`입니다.

**trading** `trading_account | null` *required*

트레이딩 계정 주소, 증거금 및 미결제 포지션의 스냅샷, WebSocket 구독. `me`를 조회할 때 `include_trading=true`로 옵트인하세요. 그 외, 트레이딩 권한이 없는 경우, 또는 Ethereum 지갑이 없는 경우 `null`입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 이 트레이딩 계정을 지원하는 Whop 지갑 ID로, `cwal_` 접두사가 붙습니다.
>
> **account\_id** `string | null` *required*
>
> 이 트레이딩 계정을 소유한 계정으로, `biz_` 접두사가 붙습니다. 사용자가 소유한 경우 `null`입니다.
>
> **hyperliquid** `object | null` *required*
>
> Hyperliquid 전용 상태. `provider`가 `hyperliquid`인 경우 존재하며, 그 외에는 `null`입니다.
>
> > [accordion] 속성
> >
> > **address** `string` *required*
> >
> > Hyperliquid 계정을 보유한 소문자 지갑 주소.
> >
> > **depositable** `string | null` *required*
> >
> > `deposit` 거래로 이 계정에 옮길 수 있는 Plasma 상 Whop 지갑의 USDT0(십진수 문자열). 체인을 읽을 수 없는 경우 `null`입니다.
> >
> > **margin\_summary** `object | null` *required*
> >
> > 메인 거래소와 `xyz` 마켓 전반의 계정 가치 및 증거금으로, Hyperliquid에서 최대 초당 한 번 읽어 옵니다. Hyperliquid를 읽을 수 없는 경우 `null`입니다. 실시간 업데이트에는 `websocket_subscriptions`를 사용하세요.
> >
> > > [accordion] 속성
> > >
> > > **account\_value** `object` *required*
> > >
> > > 미실현 손익을 포함한 총 계정 가치(USD).
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 자리 ISO 4217 통화 코드입니다.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > >
> > > **total\_margin\_used** `object` *required*
> > >
> > > 미결제 포지션 전반에 할당된 증거금(USD).
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 자리 ISO 4217 통화 코드입니다.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > >
> > > **total\_position\_notional** `object` *required*
> > >
> > > 미결제 포지션의 합산 명목 가치(USD).
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 자리 ISO 4217 통화 코드입니다.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > >
> > > **withdrawable** `object` *required*
> > >
> > > 포지션을 청산하지 않고 지금 인출할 수 있는 USD.
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 자리 ISO 4217 통화 코드입니다.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> >
> > **positions** `trading_position[] | null` *required*
> >
> > 메인 거래소와 `xyz` 마켓 전반의 미결제 무기한 선물 포지션으로, Hyperliquid에서 최대 초당 한 번 읽어 옵니다. Hyperliquid를 읽을 수 없는 경우 `null`입니다. 실시간 업데이트에는 `websocket_subscriptions`를 사용하세요.
> >
> > > [accordion] 속성
> > >
> > > **id** `string` *required*
> > >
> > > `trdpos_` 접두사가 붙은 트레이딩 포지션 ID. 하나의 트레이딩 계정 내에서 마켓별로 고정됩니다.
> > >
> > > **entry\_price** `object | null` *required*
> > >
> > > 평균 진입 가격(USD). 제공자가 생략한 경우 `null`입니다.
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 자리 ISO 4217 통화 코드입니다.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > >
> > > **hyperliquid** `object | null` *required*
> > >
> > > Hyperliquid 무기한 선물 세부 정보. Hyperliquid 포지션에 존재하며, 그 외에는 `null`입니다.
> > >
> > > > [accordion] 속성
> > > >
> > > > **cumulative\_funding** `object` *required*
> > > >
> > > > 여러 기간에 걸쳐 포지션에 지불된 펀딩(USD).
> > > >
> > > > > [accordion] 속성
> > > > >
> > > > > **all\_time** `object | null` *required*
> > > > >
> > > > > 계정 기록 전체에서 이 마켓에 지불된 펀딩(USD). 사용할 수 없는 경우 `null`입니다.
> > > > >
> > > > > > [accordion] 속성
> > > > > >
> > > > > > **amount** `string` *required*
> > > > > >
> > > > > > 주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > > > >
> > > > > > **currency** `string` *required*
> > > > > >
> > > > > > 소문자로 된 세 자리 ISO 4217 통화 코드입니다.
> > > > > >
> > > > > > **decimals** `integer` *required*
> > > > > >
> > > > > > 금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
> > > > > >
> > > > > > **display\_decimals** `integer` *required*
> > > > > >
> > > > > > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > > > >
> > > > > **since\_change** `object | null` *required*
> > > > >
> > > > > 포지션 크기가 마지막으로 변경된 이후 지불된 펀딩(USD). 사용할 수 없는 경우 `null`입니다.
> > > > >
> > > > > > [accordion] 속성
> > > > > >
> > > > > > **amount** `string` *required*
> > > > > >
> > > > > > 주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > > > >
> > > > > > **currency** `string` *required*
> > > > > >
> > > > > > 소문자로 된 세 자리 ISO 4217 통화 코드입니다.
> > > > > >
> > > > > > **decimals** `integer` *required*
> > > > > >
> > > > > > 금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
> > > > > >
> > > > > > **display\_decimals** `integer` *required*
> > > > > >
> > > > > > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > > > >
> > > > > **since\_open** `object | null` *required*
> > > > >
> > > > > 포지션이 열린 이후 지불된 펀딩(USD). 사용할 수 없는 경우 `null`입니다.
> > > > >
> > > > > > [accordion] 속성
> > > > > >
> > > > > > **amount** `string` *required*
> > > > > >
> > > > > > 주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > > > >
> > > > > > **currency** `string` *required*
> > > > > >
> > > > > > 소문자로 된 세 자리 ISO 4217 통화 코드입니다.
> > > > > >
> > > > > > **decimals** `integer` *required*
> > > > > >
> > > > > > 금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
> > > > > >
> > > > > > **display\_decimals** `integer` *required*
> > > > > >
> > > > > > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > > >
> > > > **leverage** `object` *required*
> > > >
> > > > 포지션의 증거금 모드와 배수.
> > > >
> > > > > [accordion] 속성
> > > > >
> > > > > **type** `string` *required*
> > > > >
> > > > > `cross`는 포지션 간에 증거금을 공유합니다. `isolated`는 증거금을 이 포지션으로 제한합니다.
> > > > >
> > > > > 사용 가능한 옵션: `cross`, `isolated`
> > > > >
> > > > > **value** `integer` *required*
> > > > >
> > > > > 포지션 증거금에 적용되는 배수(예: 10배의 경우 `10`).
> > > >
> > > > **liquidation\_price** `object | null` *required*
> > > >
> > > > 예상 청산 가격(USD). Hyperliquid가 보고하지 않는 경우 `null`입니다.
> > > >
> > > > > [accordion] 속성
> > > > >
> > > > > **amount** `string` *required*
> > > > >
> > > > > 주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > > >
> > > > > **currency** `string` *required*
> > > > >
> > > > > 소문자로 된 세 자리 ISO 4217 통화 코드입니다.
> > > > >
> > > > > **decimals** `integer` *required*
> > > > >
> > > > > 금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
> > > > >
> > > > > **display\_decimals** `integer` *required*
> > > > >
> > > > > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > > >
> > > > **margin\_used** `object` *required*
> > > >
> > > > 포지션에 할당된 증거금(USD).
> > > >
> > > > > [accordion] 속성
> > > > >
> > > > > **amount** `string` *required*
> > > > >
> > > > > 주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > > >
> > > > > **currency** `string` *required*
> > > > >
> > > > > 소문자로 된 세 자리 ISO 4217 통화 코드입니다.
> > > > >
> > > > > **decimals** `integer` *required*
> > > > >
> > > > > 금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
> > > > >
> > > > > **display\_decimals** `integer` *required*
> > > > >
> > > > > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > > >
> > > > **return\_on\_equity** `string` *required*
> > > >
> > > > 십진수 비율 문자열로 표현한 자기자본이익률(예: 10%의 경우 `0.1`).
> > >
> > > **market** `string` *required*
> > >
> > > 제공자의 마켓 기호(예: `ETH`).
> > >
> > > **object** `string` *required*
> > >
> > > **position\_value** `object` *required*
> > >
> > > 현재 포지션 가치(USD).
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 자리 ISO 4217 통화 코드입니다.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > >
> > > **side** `string` *required*
> > >
> > > 사용 가능한 옵션: `long`, `short`
> > >
> > > **size** `string` *required*
> > >
> > > 십진수 문자열로 표현한 절대 포지션 크기.
> > >
> > > **unrealized\_pnl** `object` *required*
> > >
> > > 미실현 손익(USD). 손실인 경우 음수입니다.
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 자리 ISO 4217 통화 코드입니다.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> >
> > **websocket\_subscriptions** `object[]` *required*
> >
> > 실시간 계정 업데이트를 위한 구독. `websocket_url`에 연결한 후 각 `message`를 변경 없이 전송하세요.
> >
> > > [accordion] 속성
> > >
> > > **channel** `string` *required*
> > >
> > > 이 구독이 여는 실시간 업데이트 스트림.
> > >
> > > 사용 가능한 옵션: `clearinghouse_state`, `open_orders`, `order_updates`, `user_fills`, `user_events`
> > >
> > > **message** `string` *required*
> > >
> > > Hyperliquid WebSocket을 통해 변경 없이 전송할 JSON 구독 메시지.
> >
> > **websocket\_url** `string` *required*
> >
> > 실시간 업데이트를 위해 직접 연결할 Hyperliquid WebSocket URL.
>
> **object** `string` *required*
>
> **provider** `string` *required*
>
> 포지션과 주문을 보유하는 거래 장소.
>
> 사용 가능한 옵션: `hyperliquid`
>
> **spot** `object | null` *required*
>
> 진입 가격과 손익이 포함된 Whop 지갑의 현물 보유 자산. 읽을 수 없는 경우 `null`입니다.
>
> > [accordion] 속성
> >
> > **holdings** `object[]` *required*
> >
> > 지갑이 아직 보유하고 있는 각 현물 자산과 평균 진입 가격 및 손익. 취득 원가는 가장 오래된 단위를 먼저 판매한 것으로 계산하며, Whop 외부에서 들어온 자산도 포함합니다.
> >
> > > [accordion] 속성
> > >
> > > **average\_entry\_price** `object | null` *required*
> > >
> > > 아직 보유 중인 단위당 평균 지불 가격(USD)으로, 가장 오래된 단위를 먼저 판매한 것으로 계산합니다. 알 수 없는 경우 `null`입니다.
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 자리 ISO 4217 통화 코드입니다.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > >
> > > **cost\_basis** `object` *required*
> > >
> > > 아직 보유 중인 단위에 대해 지불한 USD 금액.
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 자리 ISO 4217 통화 코드입니다.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > >
> > > **market** `string` *required*
> > >
> > > `GET /trades/markets`의 현물 마켓 `id`(예: `BTC`, `XAUT` 또는 `AAPL`과 같은 토큰화된 주식의 티커).
> > >
> > > **realized\_pnl** `object` *required*
> > >
> > > 매도를 통해 이미 확정된 손익(USD).
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 자리 ISO 4217 통화 코드입니다.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > >
> > > **unrealized\_pnl** `object` *required*
> > >
> > > 아직 보유 중인 단위의 가치에서 `cost_basis`를 뺀 값(USD).
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 자리 ISO 4217 통화 코드입니다.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > >
> > > **unrealized\_pnl\_percentage** `number | null` *required*
> > >
> > > `cost_basis` 대비 `unrealized_pnl`의 백분율로, `2`는 2% 상승을 의미합니다. 알 수 없는 경우 `null`입니다.
>
> **user\_id** `string | null` *required*
>
> 이 트레이딩 계정을 소유한 사용자로, `user_` 접두사가 붙습니다. 계정이 소유한 경우 `null`입니다.

**username** `string` *required*

사용자의 고유한 사용자 이름

**verification** `object` *required*

사용자의 `individual`(KYC) 및 `business`(KYB) 프로필에 대한 신원 인증 상태. 각각 생성되기 전까지는 `null`이며, 그 외에는 `not_started`, `pending`, `approved` 또는 `rejected` 중 하나의 `status`입니다.

**verified\_at** `string | null` *required*

사용자가 인증 배지를 받은 시점(ISO 8601 타임스탬프). 사용자가 인증되지 않은 경우 `null`입니다.

**whop\_partner\_enabled\_at** `string | null` *required*

사용자가 Whop Partner로 등록된 시점(ISO 8601 타임스탬프). 등록한 적이 없으면 `null`입니다.

**whop\_partner\_onboarded\_accounts\_count** `integer | null` *required*

사용자가 Whop Partner로서 Whop에 추천한 계정 중 사용자에게 귀속된 거래액이 \$1를 초과한 계정 수. Verified Whop Partner인 단일 사용자를 조회할 때만 채워지며, 그 외에는 `null`입니다.

**whop\_partner\_verified\_at** `string | null` *required*

사용자가 Verified Whop Partner가 된 시점(ISO 8601 타임스탬프). 프로그램을 떠난 파트너와 정지된 사용자를 포함하여 Verified Whop Partner가 아닌 사용자의 경우 `null`입니다.

```json User theme={null}
{
	"id": "user_alex123",
	"trading": {
		"id": "cwal_xxxxxxxxxxxxx",
		"object": "trading_account",
		"account_id": null,
		"user_id": "user_alex123",
		"provider": "hyperliquid",
		"hyperliquid": {
			"address": "0x1234567890abcdef1234567890abcdef12345678",
			"websocket_url": "wss://api.hyperliquid.xyz/ws",
			"websocket_subscriptions": [
				{
					"channel": "clearinghouse_state",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"clearinghouseState\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				},
				{
					"channel": "open_orders",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"openOrders\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				},
				{
					"channel": "order_updates",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"orderUpdates\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				},
				{
					"channel": "user_fills",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"userFills\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				},
				{
					"channel": "user_events",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"userEvents\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				}
			],
			"depositable": "1250.50",
			"margin_summary": {
				"account_value": {
					"currency": "usd",
					"amount": "1520.50",
					"decimals": 2,
					"display_decimals": 2
				},
				"total_position_notional": {
					"currency": "usd",
					"amount": "4350.00",
					"decimals": 2,
					"display_decimals": 2
				},
				"total_margin_used": {
					"currency": "usd",
					"amount": "435.00",
					"decimals": 2,
					"display_decimals": 2
				},
				"withdrawable": {
					"currency": "usd",
					"amount": "500.00",
					"decimals": 2,
					"display_decimals": 2
				}
			},
			"positions": [
				{
					"id": "trdpos_0123456789abcdef",
					"object": "trading_position",
					"market": "ETH",
					"side": "short",
					"size": "1.5",
					"entry_price": {
						"currency": "usd",
						"amount": "3000.00",
						"decimals": 2,
						"display_decimals": 2
					},
					"position_value": {
						"currency": "usd",
						"amount": "4350.00",
						"decimals": 2,
						"display_decimals": 2
					},
					"unrealized_pnl": {
						"currency": "usd",
						"amount": "150.25",
						"decimals": 2,
						"display_decimals": 2
					},
					"hyperliquid": {
						"leverage": {
							"type": "cross",
							"value": 10
						},
						"liquidation_price": {
							"currency": "usd",
							"amount": "4912.40",
							"decimals": 2,
							"display_decimals": 2
						},
						"margin_used": {
							"currency": "usd",
							"amount": "435.00",
							"decimals": 2,
							"display_decimals": 2
						},
						"return_on_equity": "0.33",
						"cumulative_funding": {
							"all_time": {
								"currency": "usd",
								"amount": "1.20",
								"decimals": 2,
								"display_decimals": 2
							},
							"since_open": {
								"currency": "usd",
								"amount": "0.40",
								"decimals": 2,
								"display_decimals": 2
							},
							"since_change": {
								"currency": "usd",
								"amount": "0.10",
								"decimals": 2,
								"display_decimals": 2
							}
						}
					}
				}
			]
		},
		"spot": {
			"holdings": [
				{
					"market": "BTC",
					"average_entry_price": {
						"currency": "usd",
						"amount": "79841.12345678",
						"decimals": 8,
						"display_decimals": 8
					},
					"cost_basis": {
						"currency": "usd",
						"amount": "400.00",
						"decimals": 2,
						"display_decimals": 2
					},
					"unrealized_pnl": {
						"currency": "usd",
						"amount": "38.25",
						"decimals": 2,
						"display_decimals": 2
					},
					"unrealized_pnl_percentage": 9.5625,
					"realized_pnl": {
						"currency": "usd",
						"amount": "3.25",
						"decimals": 2,
						"display_decimals": 2
					}
				}
			]
		}
	},
	"balance": {
		"businesses": [
			{
				"id": "biz_acme123",
				"name": "Acme Inc",
				"logo_url": "https://cdn.whop.com/logos/acme.png",
				"balance_usd": "14325.00"
			}
		],
		"businesses_total_usd": "14325.00",
		"cash": [
			{
				"currency": "usd",
				"balance": 250,
				"balance_usd": 250,
				"pending_balance_usd": 0,
				"in_transit_balance_usd": 0,
				"price_usd": 1,
				"reserve_balance_usd": 0,
				"total_withdrawable_balance": 250
			}
		],
		"cash_usd": "250.00",
		"crypto": [
			{
				"symbol": "USDT",
				"name": "Tether USD",
				"balance": "500.00",
				"breakdown": {
					"available": "450.00",
					"in_transit": "0",
					"pending": "50.00",
					"pending_settlements": [
						{
							"amount": "50.00",
							"date": "2026-08-12"
						}
					],
					"finishing_settlement": "0",
					"reserve": "0"
				},
				"value_usd": 500,
				"price_usd": 1,
				"icon_url": "https://cdn.whop.com/tokens/usdt.png"
			}
		],
		"crypto_usd": "500.00",
		"pending_usd": "0.00",
		"total_usd": "750.00",
		"treasury_pending_usd": "0.00"
	},
	"total_usd": "750.00",
	"balances": [
		{
			"balance": "500.00",
			"breakdown": {
				"available": "450.00",
				"in_transit": "0",
				"pending": "50.00",
				"reserve": "0",
				"pending_settlements": [
					{
						"amount": "50.00",
						"date": "2026-08-12"
					}
				],
				"finishing_settlement": "0"
			},
			"icon_url": "https://cdn.whop.com/tokens/usdt.png",
			"name": "Tether USD",
			"price_usd": 1,
			"symbol": "USDT",
			"value_usd": "500.00"
		},
		{
			"balance": "250.00",
			"breakdown": {
				"available": "240.00",
				"in_transit": "0",
				"pending": "10.00",
				"reserve": "0",
				"pending_settlements": [
					{
						"amount": "10.00",
						"date": "2026-08-12"
					}
				],
				"finishing_settlement": "0"
			},
			"icon_url": null,
			"name": "US Dollar",
			"price_usd": 1,
			"symbol": "USD",
			"value_usd": "250.00"
		}
	],
	"balance_history": {
		"data": [
			{
				"t": 1735689600,
				"v": 500
			},
			{
				"t": 1735776000,
				"v": 750
			}
		],
		"last": 750,
		"min": 500,
		"max": 750
	},
	"bio": "Building communities on Whop.",
	"banner": {
		"url": "https://cdn.whop.com/banner.png"
	},
	"created_at": "2026-06-01T12:00:00Z",
	"earnings_usd": {
		"total": {
			"lifetime": "15075.00",
			"last_30_days": "3425.00",
			"last_7_days": "890.00",
			"last_24_hours": "120.00"
		},
		"personal": {
			"lifetime": "750.00",
			"last_30_days": "250.00",
			"last_7_days": "100.00",
			"last_24_hours": "25.00"
		},
		"owned_accounts": {
			"lifetime": "14325.00",
			"last_30_days": "3175.00",
			"last_7_days": "790.00",
			"last_24_hours": "95.00"
		},
		"partners": {
			"lifetime": "600.00",
			"last_30_days": "200.00",
			"last_7_days": "80.00",
			"last_24_hours": "20.00"
		},
		"first_earned_at": "2026-06-02T15:30:00Z"
	},
	"name": "Alex Rivera",
	"profile_picture": {
		"url": "https://cdn.whop.com/avatar.png"
	},
	"social_links": [
		{
			"website": "instagram",
			"username": "janedoe",
			"url": "https://instagram.com/janedoe",
			"verified": true
		}
	],
	"username": "alex",
	"city": "Austin",
	"state": "Texas",
	"country": "US",
	"cards": {
		"kind": "individual",
		"status": "approved",
		"decline_reason": null
	},
	"level": {
		"current": 1,
		"points": 41000,
		"points_by_source": {
			"cards": 40000,
			"ads": 0,
			"trading": 1000,
			"partners": 0
		},
		"resets_at": "2026-11-01T04:00:00.000Z"
	},
	"followers_count": 1284,
	"verified_at": "2026-03-18T15:42:00Z",
	"verification": {
		"business": null,
		"individual": {
			"status": "approved"
		}
	},
	"whop_partner_enabled_at": "2026-06-10T09:00:00Z",
	"whop_partner_verified_at": "2026-07-15T18:30:00Z",
	"whop_partner_onboarded_accounts_count": 12,
	"email": "jack@whop.com",
	"date_of_birth": "1998-04-23"
}
```


## Related topics

- [Users](https://docs.whop.com/ko/api-reference/legacy/users/user.md)
- [Create API Key](https://docs.whop.com/ko/api-reference/api-keys/create-api-key.md)
- [Update User](https://docs.whop.com/ko/api-reference/users/update-user.md)
