v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
profiles

Get public user profile

Get a user's public profile by their handle.

This is a public endpoint - no authentication required.

Returns 404 if:

  • Handle not found
  • User's profile is set to private

The response includes:

  • handle: The user's handle
  • created_at: When the account was created
  • stats: Aggregated tip statistics (sent/received counts and totals)
  • earning_addresses: Wallet addresses that can earn tips (Smart Account wallets)
  • social_links: Linked social profiles (Twitter, GitHub, etc.)
get/v1/profiles/{handle}

Path parameters

handlestring required

User handle (case-insensitive)

User handle (case-insensitive)

Response

Successful Response

handlestring required

User's handle (e.g., 'alice')

descriptionstring nullable

Profile bio (max 280 characters)

avatar_urlstring nullable

User-selected avatar URL from verified social identity

created_atstring required

Account creation date (ISO 8601)

referral_codestring nullable

User's shareable referral code (e.g., 'GRV-ABC123')

tip_to_talk_minnumber nullable

Minimum tip in USD for paid messages (Tip to Talk). NULL = disabled.

is_claimedboolean

Whether this profile has been claimed by the creator. Pre-registered profiles are unclaimed until the creator authenticates.

tip_button_labelstring

CTA label for the tip button on the profile page. Feed/content contexts should always show 'Tip' regardless.

Example response

{
  "theme": {
    "accent_color": "#4CAF50",
    "preset": "dark"
  }
}