Skip to Content
SignalWise

Self-service subscriptions

Let your users subscribe to alerts and manage the assets they follow.

Overview

Beta

Self-service subscriptions are being rolled out. Contact your account manager to enable them.

The self-service widget lets your end users subscribe to personalized alerts and choose the assets they follow, inside your app, without a custom integration. The widget calls the endpoints below; you can also call them from your backend.

  • Each user has one watchlist.
  • Changes are applied asynchronously, within about 1 hour.
  • Authentication uses a Bridgewise token obtained through single sign-on with your identity provider.
ENDPOINTS
PUT     /portfolio-analysis/subscription
DELETE  /portfolio-analysis/subscription
GET     /portfolio-analysis/portfolios

Subscribe

PUT/portfolio-analysis/subscription

Subscribes the user and sets their watchlist. The body is the full watchlist: it replaces the previous one. Calling it twice with the same body has the same effect as calling it once.

Query parameters

tenant_idstringRequired
Your tenant ID.
user_idstringRequired
Your user's ID.

Body

collection_iduuid
ID of the watchlist. Generated if omitted. Resend it on every update.
preferred_languagesarray of stringsRequired
For example ["en-US"]. Format xx-XX.
assetsarrayRequired
The assets to follow.
assets[].tickerstring
Ticker, for example AAPL.
assets[].exchangestring
Exchange code, for example XNAS.
assets[].asset_typeenum
stock, fund or bond. ETFs are fund.
assets[].currencystring
ISO 4217 currency, for example USD.

Returns

202 Accepted, with state: "pending_sync" and the expected sync time.

PUT /portfolio-analysis/subscription
curl -X PUT "https://rest.bridgewise.com/portfolio-analysis/subscription?tenant_id=<tenant>&user_id=user-42" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "collection_id": "8f3c2a1e-5b47-4c1d-9e6a-2f0b7d4c9a31",
    "preferred_languages": ["en-US"],
    "assets": [
      { "ticker": "AAPL", "exchange": "XNAS", "asset_type": "stock", "currency": "USD" }
    ]
  }'
RESPONSE 202
{
  "tenant_id": "<tenant>",
  "user_id": "user-42",
  "subscribed": true,
  "state": "pending_sync",
  "watchlist_id": "8f3c2a1e-5b47-4c1d-9e6a-2f0b7d4c9a31",
  "sync_eta_seconds": 3600,
  "requested_at": "2026-11-16T12:00:00Z"
}

Unsubscribe

DELETE/portfolio-analysis/subscription

Stops alerts for the user. The watchlist is kept, so the user can subscribe again later.

Query parameters

tenant_idstringRequired
Your tenant ID.
user_idstringRequired
Your user's ID.
collection_iduuidRequired
The watchlist ID.

Returns

202 Accepted. If the user is already unsubscribed, 200 or 204.

DELETE /portfolio-analysis/subscription
curl -X DELETE "https://rest.bridgewise.com/portfolio-analysis/subscription?tenant_id=<tenant>&user_id=user-42&collection_id=8f3c2a1e-5b47-4c1d-9e6a-2f0b7d4c9a31" \
  -H "Authorization: Bearer <token>"
RESPONSE 202
{
  "subscribed": false,
  "state": "pending",
  "alert_delivery_stops_within_seconds": 3600
}

Get a user's watchlist

GET/portfolio-analysis/portfolios

Returns the user's collections. A collection with collection_type: "watchlist" means the user is subscribed. An empty list means the user is not subscribed.

Query parameters

tenant_idstringRequired
Your tenant ID.
user_idstringRequired
Your user's ID.
GET /portfolio-analysis/portfolios
curl -G https://rest.bridgewise.com/portfolio-analysis/portfolios \
  -H "Authorization: Bearer <token>" \
  -d tenant_id=<tenant> \
  -d user_id=user-42