Updates account trading value display

POST

https://api.prod.paradex.trade/v1/account/settings/trading_value_display

POST

/v1/account/settings/trading_value_display

$ curl -X POST https://api.prod.paradex.trade/v1/account/settings/trading_value_display \
>      -H "Authorization: <apiKey>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "trading_value_display": "Spot Notional"
> }'

1 {
2   "ai_agent_url": "wss://agent.paradex.trade:18789",
3   "discord": {
4     "id": "847362910284756480",
5     "image_url": "https://cdn.discordapp.com/avatars/847362910284756480/a_123abc456def7890.gif",
6     "username": "CryptoTrader#1234"
7   },
8   "is_username_private": true,
9   "last_seen_notification": 1713400000000,
10   "market_max_slippage": {},
11   "marketed_by": "maxDegen",
12   "nfts": [
13     {
14       "collection_address": "0xabc123def4567890abc123def4567890abc123de",
15       "collection_name": "Paradex Collectibles",
16       "id": "987654321",
17       "image_url": "https://cdn.paradex.trade/nfts/987654321.png",
18       "name": "Paradex Dragon #321",
19       "price": {
20         "currency": "ETH",
21         "decimals": 18,
22         "value": "2.5"
23       }
24     }
25   ],
26   "notifications": {
27     "announcements": false,
28     "fill_sound": true,
29     "fills": true,
30     "orders": true,
31     "transfers": true
32   },
33   "referral": {
34     "commission_rate": "0.1",
35     "commission_volume_cap": "1000000000",
36     "discount_rate": "0.1",
37     "discount_volume_cap": "30000000",
38     "minimum_volume": "0.123",
39     "name": "Referral",
40     "points_bonus_rate": "0.1",
41     "points_bonus_volume_cap": "1000000000",
42     "referral_type": "Referral"
43   },
44   "referral_code": "cryptofox8",
45   "referred_by": "maxDegen",
46   "size_currency_display": "BASE",
47   "tap_share_rate": {
48     "last_updated_at": 1715592690488,
49     "share_rate": "0.2"
50   },
51   "tap_status": "ACTIVE",
52   "twitter": {
53     "id": "1357924680",
54     "image_url": "https://pbs.twimg.com/profile_images/1357924680/profile_pic_normal.jpg",
55     "username": "ParadexOfficial"
56   },
57   "twitter_following": {},
58   "username": "crypto_enthusiast",
59   "xp_share_rate": {
60     "last_updated_at": 1715592690488,
61     "share_rate": "0.2"
62   }
63 }

To set user preferences for the trading value display on the UI, Spot Notional will use spot price, and Market Value will use the market price.

Authentication

Authorizationstring

API Key authentication via header

Request

Update account trading value display request

trading_value_displaystringRequired

Response

ai_agent_urlstringOptional

discordobjectOptional

is_username_privatebooleanOptional

last_seen_notificationintegerOptional

market_max_slippagemap from strings to stringsOptional

marketed_bystringOptional

nftslist of objectsOptional

notificationsobjectOptional

referralobjectOptional

referral_codestringOptional

referred_bystringOptional

size_currency_displaystringOptional

tap_share_rateobjectOptional

tap_statusstringOptional

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

twitterobjectOptional

twitter_followingmap from strings to booleansOptional

usernamestringOptional

xp_share_rateobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error