Set Notification Master Preference

POST /api/v1/account/notifications/preferences/master

This endpoint turns one channel on or off in your master preference. Pacifica uses a channel only when it is on in the master preference and in the notification type’s preference. Other channels keep their current value. The master preference doesn’t change the type preferences. Turn a channel off here to pause it for all types. When you turn it on again, your type preferences apply again.

Operation Type (for Signing)

Header Field	Type	Content
`"type"`	string	`"set_notification_master_preference"`

Request Body

Field	Type	Need	Description	Example
`”account”`	string	required	User’s wallet address	`42trU9A5…`
`“signature”`	string	required	Cryptographic signature	`5j1Vy9Uq…`
`“timestamp”`	integer	required	Current timestamp in milliseconds	`1716200000000`
`”channel”`	string	required	Channel to change: `“in_app"` `"mobile_push"` `"web_push”`	`web_push`
`”enabled”`	boolean	required	`true` turns the channel on. `false` turns it off	`true`
`”expiry_window”`	integer	optional	Signature expiry in milliseconds	`30000`
`”agent_wallet”`	string	optional	Agent wallet address	`69trU9A5…`

{
  "account": "42trU9A5...",
  "signature": "5j1Vy9Uq...",
  "timestamp": 1716200000000,
  "channel": "web_push",
  "enabled": true,
  "expiry_window": 30000
}

You can sign this request with the account key or with an agent wallet.

Response

Status 200: Master preference updated. The response has all your preferences after the change, in the same format as List notification preferences

{
  "success": true,
  "data": {
    "master_enabled_channels": ["in_app", "web_push"],
    "preferences": [
      { "notification_type": "deposit_success", "enabled_channels": ["in_app", "web_push"] },
      { "notification_type": "withdraw_success", "enabled_channels": ["in_app", "web_push"] },
      { "notification_type": "order_filled", "enabled_channels": ["in_app", "web_push"] },
      { "notification_type": "order_partially_filled", "enabled_channels": [] },
      { "notification_type": "order_canceled", "enabled_channels": [] },
      { "notification_type": "tp_sl_triggered", "enabled_channels": ["in_app", "web_push"] },
      { "notification_type": "liquidation", "enabled_channels": ["in_app", "web_push"] },
      { "notification_type": "strategy_update", "enabled_channels": ["in_app"] }
    ]
  },
  "error": null,
  "code": null
}

Status 400: Invalid request parameters or signature
Status 403: The account doesn’t exist. An account exists after its first deposit
Status 409: You tried to turn on web_push, but Web Push isn’t available. Get Web Push config returns enabled: false in this case

{
  "success": false,
  "data": null,
  "error": "Web Push is disabled",
  "code": 409,
  "error_id": "web_push_disabled"
}

Status 429: Rate limit exceeded
Status 500: Internal server error

Code Example (Python)

import requests

payload = {
    "account": "42trU9A5...",
    "signature": "5j1Vy9Uq...",
    "timestamp": 1716200000000,
    "channel": "web_push",
    "enabled": True
}

response = requests.post(
    "/api/v1/account/notifications/preferences/master",
    json=payload,
    headers={"Content-Type": "application/json"}
)

data = response.json()

​Operation Type (for Signing)

​Request Body

​Response

​Code Example (Python)

Operation Type (for Signing)

Request Body

Response

Code Example (Python)