---
title: "Updates account profile username fields"
method: POST
path: "/account/profile/username"
tags: ["Account"]
---

# Updates account profile username fields

`POST /account/profile/username`

## Request

- Base URL: `https://api.prod.paradex.trade/v1`
- URL: `https://api.prod.paradex.trade/v1/account/profile/username`
- Auth: API key in header `Authorization`

Respond with requester's account information

## Response `200`

OK

- ResponsesAccountProfileResp
  - `ai_agent_url` string
  - `discord` ResponsesDiscordProfile
    - `id` string
    - `image_url` string
    - `username` string
  - `is_username_private` boolean
  - `last_seen_notification` integer
  - `market_max_slippage` object
  - `marketed_by` string
  - `nfts` ResponsesNft[]
    - `collection_address` string
    - `collection_name` string
    - `id` string
    - `image_url` string
    - `name` string
    - `price` Messagesv1NftPrice
      - `currency` string
      - `decimals` integer
      - `value` string
  - `notifications` ResponsesNotificationPreferencesResp
    - `announcements` boolean
    - `fill_sound` boolean
    - `fills` boolean
    - `orders` boolean
    - `transfers` boolean
  - `referral` ResponsesReferralConfigResp
    - `commission_rate` string: Commission rate for the referer
    - `commission_volume_cap` string: Volume cap for commission
    - `discount_rate` string: Discount rate for the referee
    - `discount_volume_cap` string: Volume cap for discount
    - `minimum_volume` string: Minimum volume required to be eligible for Program
    - `name` string: Referral name
    - `points_bonus_rate` string: Points bonus rate for the referee
    - `points_bonus_volume_cap` string: Volume cap for points bonus
    - `referral_type` string: Referral type
  - `referral_code` string
  - `referred_by` string
  - `size_currency_display` string
  - `tap_share_rate` ResponsesShareRateResp
    - `last_updated_at` integer
    - `share_rate` string
  - `tap_status` string: TAP affiliate status: "NONE", "ACTIVE", or "INACTIVE"
  - `twitter` ResponsesTwitterProfile
    - `id` string
    - `image_url` string
    - `username` string
  - `twitter_following` object
  - `username` string
  - `xp_share_rate` ResponsesShareRateResp
    - `last_updated_at` integer
    - `share_rate` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Requires the account's main key

## Changes

- **2026-10-22** `f33feb7333ea`: 9 warning
  - added the new `ADDRESS_BOOK_NOT_PARADEX_ACCOUNT` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `ADDRESS_BOOK_NOT_PARADEX_ACCOUNT` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `401`
  - added the new `ADDRESS_BOOK_NOT_PARADEX_ACCOUNT` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `403`
  - added the new `ADDRESS_BOOK_REPEATED_IN_IMPORT` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - …5 more
- **2026-10-20** `72c125c93c2b`: 6 warning
  - added the new `SESSION_EXPIRED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `SESSION_EXPIRED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `401`
  - added the new `SESSION_EXPIRED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `403`
  - added the new `SESSION_REVOKED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - …2 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/changes/account/profile/username/post.md)

---

[API](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2.md) - [All operations](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/revisions/f33feb7333ea?raw)