Updates account notification preferences | Paradex

curl -X POST https://api.testnet.paradex.trade/v1/account/profile/notifications \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "discord": {
    "id": "123456789012345678",
    "image_url": "https://cdn.discordapp.com/avatars/123456789012345678/a_abcdef1234567890.gif",
    "username": "CryptoTrader42"
  },
  "is_username_private": false,
  "market_max_slippage": {},
  "marketed_by": "maxDegen",
  "nfts": [
    {
      "collection_address": "0xabc123def4567890abc123def4567890abc123de",
      "collection_name": "CryptoPunks",
      "description": "A collection of 10,000 unique collectible characters with proof of ownership stored on the Ethereum blockchain.",
      "id": "1234",
      "image_url": "https://cryptopunks.app/cryptopunks/image/1234.png",
      "name": "CryptoPunk #1234",
      "price": {
        "currency": "ETH",
        "decimals": 18,
        "value": "15.75"
      }
    }
  ],
  "notifications": {
    "announcements": true,
    "fill_sound": false,
    "fills": true,
    "orders": false,
    "transfers": true
  },
  "referral": {
    "commission_rate": "0.1",
    "commission_volume_cap": "1000000000",
    "discount_rate": "0.1",
    "discount_volume_cap": "30000000",
    "minimum_volume": "0.123",
    "name": "Referral",
    "points_bonus_rate": "0.1",
    "points_bonus_volume_cap": "1000000000",
    "referral_type": "Referral"
  },
  "referral_code": "cryptofox8",
  "referred_by": "maxDegen",
  "size_currency_display": "BASE",
  "tap_share_rate": {
    "last_updated_at": 1715592690488,
    "share_rate": "0.2"
  },
  "tap_status": "ACTIVE",
  "twitter": {
    "id": "9876543210",
    "image_url": "https://pbs.twimg.com/profile_images/9876543210/profile_pic_normal.jpg",
    "username": "CryptoTrader42"
  },
  "twitter_following": {},
  "username": "crypto_trader_42",
  "xp_share_rate": {
    "last_updated_at": 1715592690488,
    "share_rate": "0.2"
  }
}

Updates user notification preferences for orders, fills, announcements, and transfers. All fields are optional - only provided fields will be updated.

Authentication

Authorizationstring

API Key authentication via header

Request

Update notification preferences request (all fields optional)

announcementsbooleanOptional

fill_soundbooleanOptional

fillsbooleanOptional

ordersbooleanOptional

transfersbooleanOptional

Response

discordobject

is_username_privateboolean

market_max_slippagemap from strings to strings

marketed_bystring

nftslist of objects

notificationsobject

referralobject

referral_codestring

referred_bystring

size_currency_displaystring

tap_share_rateobject

tap_statusstring

TAP affiliate status: “NONE”, “ACTIVE”, or “INACTIVE”

twitterobject

twitter_followingmap from strings to booleans

usernamestring

xp_share_rateobject

Errors

400

Bad Request Error

401

Unauthorized Error