v32

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-076085232.1 KB

Portfolio

Get your profile

Retrieve the authenticated user's profile by address, including their internal user ID and fee rate. This is useful for API users who need their feeRateBps (for order signing) or numeric id (used as ownerId in other flows). You can only access your own profile — requesting another user's address returns 403. If you do not want to pass an address, use GET /profiles/me.

get/profiles/{account}

Path parameters

accountstring required

Your wallet address (the address associated with your API key)

Response

User profile with fee rate and rank information

idinteger

Internal user ID (used as ownerId in other API flows)

accountstring

Ethereum wallet address

usernamestring

Unique username

displayNamestring

Display name shown in the UI

biostring nullable

User biography

clientstring

Client type used during registration

pfpUrlstring nullable

Profile picture URL

smartWalletstring nullable

Smart wallet address, if configured

isCreatorboolean

Whether the user is a market creator

isOnboardedboolean

Whether the user has completed onboarding

socialUrlstring nullable

URL to the user's social media profile

hasTradedboolean

Whether the user has executed at least one trade

tradeWalletOption'eoa' | 'smartWallet' nullable

Which wallet is used for trading

tradeWalletChoosenboolean

Whether the user has selected a trade wallet

embeddedAccountstring nullable

Embedded wallet address (Privy)

mode'simple' | 'advanced'

Trading UI mode

referralCodestring nullable

User's referral code

pointsnumber

Current points balance

accumulativePointsnumber

Total accumulated points (all-time)

referredUsersCountinteger

Number of users referred

enrolledInPointsProgramboolean nullable

Whether the user is enrolled in the points program

leaderboardPositioninteger

Position on the leaderboard

isTop100boolean

Whether the user is in the top 100 on the leaderboard

isCaptainboolean

Whether the user is a competition team captain

Example response

{
  "id": 42,
  "account": "0x27b4afBD88fE7c88c6897BB0b4ADE338D0401E37",
  "username": "trader123",
  "displayName": "Trader 123",
  "client": "eoa",
  "points": 15000,
  "accumulativePoints": 50000,
  "rank": {
    "name": "Gold",
    "feeRateBps": 200
  }
}