Skip to main content
GET
TypeScript

인증

Authorization
string
header
필수

An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

헤더

Api-Version-Date
string

Pins the request to a dated API version.

예시:

"2026-11-17"

경로 매개변수

id
string
필수

User ID (prefixed user_), username, or me for the authenticated user.

쿼리 매개변수

include_trading
boolean
기본값:false

Also return the trading account under trading: its address, a snapshot of its margin and open positions, and its Hyperliquid WebSocket subscriptions. Only honored on the self view (me) with crypto_wallet:trade:read, crypto_wallet:trade, or crypto_wallet:manage permission and an Ethereum wallet.

account_id
string

When set, returns the user's account-specific profile overrides for this account.

include_balance
boolean

Compute live wallet and owned-account balances on the self view (default true). Set false for identity-only reads. Ignored when the id is not me or the caller lacks balance-read scope.

include_balance_history
boolean

Also compute your balance history (opt-in; runs a heavier query). Only applies when the id is me; ignored for callers without balance-read scope.

from
string

Balance-history window start, ISO 8601 date or datetime. Defaults to 30 days ago. Only used with include_balance_history.

to
string

Balance-history window end, ISO 8601 date or datetime. Defaults to now. Only used with include_balance_history.

interval
enum<string>

Balance-history point granularity. Defaults to day. Only used with include_balance_history.

사용 가능한 옵션:
hour,
day,
week,
month
time_zone
string

IANA time zone the balance-history points are bucketed in. Defaults to UTC. Only used with include_balance_history.

응답

user retrieved

balance
object | null
필수

The user's balance: personal cash + other holdings + deposits still in flight, plus account balances for accounts they own. Computed only on the self view (retrieved with the reserved id me) for callers with balance-read scope; null otherwise, or when include_balance=false.

balance_history
object | null
필수

The user's cumulative wallet balance over time (USD { t, v } points plus last/min/max), for the balance chart. Opt in with include_balance_history=true when retrieving yourself with the reserved id me; populated only for callers with balance-read scope and null otherwise. A user with no wallet activity returns an empty series.

balances
object[]
필수
banner
object | null
필수

The user's profile banner wrapper. null when the user has no banner.

bio
string | null
필수

The user's biography

예시:

"Ceramic coating specialist. Detailing cars in Austin since 2016."

cards
object | null
필수

Where the user's personal card application stands. Populated only on the self view (retrieved with the reserved id me) for callers with balance-read scope; null otherwise, or when the user has never applied for a card.

city
string | null
필수

The user's city, derived from their IP address. null when unknown or the user turned off location sharing.

예시:

"Austin"

country
string | null
필수

The user's country as an ISO 3166-1 alpha-2 code, derived from their IP address. null when unknown or the user turned off location sharing.

예시:

"US"

created_at
string
필수

When the user was created, as an ISO 8601 timestamp

예시:

"2026-01-01T12:00:00.000Z"

date_of_birth
string | null
필수

The user's date of birth as an ISO 8601 date, like 1998-04-23. Populated only on the self view (retrieved with the reserved id me) for callers with email-read scope; null otherwise, or when the user has not set one.

예시:

null

earnings_usd
object | null
필수

The user's gross USD income over time, including a Partner commission breakdown. Populated only on single-user self reads for callers with balance-read scope; null otherwise.

email
string | null
필수

The user's email address. Populated only on the self view (retrieved with the reserved id me) for callers with email-read scope; null otherwise, or while the account has no confirmed email yet.

예시:

"marcus@shinetime.example"

followers_count
integer
필수

The number of users who follow this user.

예시:

0

id
string
필수

User ID, prefixed user_.

예시:

"user_xxxxxxxxxxxxxx"

level
object | null
필수

The user's Whop Level, counted across every account they own. current is public. The points and spend fields are populated only when you retrieve yourself with the reserved id me and have balance-read scope. null on lists, and when none of their accounts are in Whop Levels.

name
string | null
필수

The user's display name

예시:

"Marcus Webb"

profile_picture
object
필수

Avatar wrapper. Its url is always present, and is a generated placeholder when the user set no picture.

state
string | null
필수

The user's state or region, derived from their IP address. null when unknown or the user turned off location sharing.

예시:

"Texas"

total_usd
string | null
필수

Total USD value of the user's personal holdings in balances, across those with known exchange rates. Computed only on the self view (retrieved with the reserved id me) for callers with balance-read scope; null otherwise, when include_balance=false, or when the balance source is unavailable.

예시:

"6320.75"

trading
object | null
필수

The trading account address, a snapshot of its margin and open positions, and its WebSocket subscriptions. Opt in with include_trading=true when retrieving me. null otherwise, without trading permission, or without an Ethereum wallet.

username
string
필수

The user's unique username

예시:

"marcuswebb"

verification
object
필수

Identity verification status for the user's individual (KYC) and business (KYB) profiles. Each is null until created, otherwise a status of not_started, pending, approved, or rejected.

예시:
verified_at
string | null
필수

When the user received a verified badge, as an ISO 8601 timestamp. null when the user is not verified.

예시:

"2026-01-01T12:00:00.000Z"

whop_partner_enabled_at
string | null
필수

When the user became an enrolled Whop Partner, as an ISO 8601 timestamp. null if never enrolled.

예시:

"2026-01-01T12:00:00.000Z"

whop_partner_onboarded_accounts_count
integer | null
필수

Number of accounts the user referred to Whop as a Whop Partner that have processed more than $1 in volume attributed to the user. Populated only when retrieving a single user who is a Verified Whop Partner; null otherwise.

예시:

1

whop_partner_verified_at
string | null
필수

When the user became a Verified Whop Partner, as an ISO 8601 timestamp. null for users who are not Verified Whop Partners, including partners who left the program and suspended users.

예시:

"2026-01-01T12:00:00.000Z"