Instrument identifiers
How assets are identified in messages, and how to use your own IDs.
Bridgewise identifiers
| ID | Meaning |
|---|---|
companyId (CID) | The company, across all its listings |
tradingItemId (TID) | One listing of the company on one exchange |
assetId | The asset in the message |
For crypto, forex and commodities, companyId and tradingItemId are -1. Use tickerSymbol and tickerExchange instead.
Identifying your users' holdings
When you send portfolios for personalization, choose one identifier type per asset with instrumentIdType:
instrumentIdType | Required fields | Example |
|---|---|---|
ticker | tickerSymbol + exchangeSymbol | AAPL + NasdaqGS |
isin | isin + exchangeSymbol (full exchange name) + currency | US0378331005 + Nasdaq Global Select + USD |
tase | securityNumber + exchangeSymbol: "TASE" | 1081124 |
asset | assetId: your own ID, registered with Bridgewise | INT-000123 |
How an ISIN is resolved: an ISIN can be listed on several exchanges. SignalWise picks the listing that matches the currency, then the exchange name, then falls back to the primary listing.
Using your own IDs
You can map your own instrument IDs to Bridgewise IDs:
- Send a CSV file with the columns
tid,cid,external_identifier,tenant_id,status, over SFTP or a shared bucket. - Bridgewise loads the mapping. Uploading a new, shorter file removes the missing rows.
- Your IDs can then be used in portfolios (
instrumentIdType: "asset") and are added to the alerts you receive.
Looking up an identifier
curl "https://rest.bridgewise.com/identifier-search?identifier=AAPL&identifier_type=ticker" \
-H "Authorization: Bearer <token>"Use identifier_type=CUSTOM to check that one of your own IDs is mapped.