Instrument listings
An instrument's listings across exchanges
GET
/openapi/v3/instruments/{ref}/listingsRefresh: Minute / daily
This endpoint uses v3 at https://openapi.sosovalue.com/openapi/v3. Do not append it to /openapi/v1; see version-specific conventions.
/instruments/{ref}/listings returns an instrument's listings across exchanges; /listings/{ref} returns a single listing's detail.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| ref | string | Required | Instrument reference. A full_symbol such as AAPL.US or BTC-USDT-PERP.BINANCE is recommended; a stable id, symbol or FIGI also works |
Request Example
curl "https://openapi.sosovalue.com/openapi/v3/instruments/MSTR.US/listings" \ -H "x-soso-api-key: $SOSO_API_KEY"
Response Fields
| Field | Type | Description |
|---|---|---|
| listing_id | Number | Stable id |
| external_id | String | Alternate stable id |
| venue_code | String | Exchange code, e.g. NASDAQ |
| code | String | Trading code on that venue |
| full_symbol | String | e.g. AAPL.US — unambiguous ref |
| trading_currency | String | Trading currency |
| is_primary | Boolean | Whether this is the primary listing |
| lot_size | Number | Exchange board-lot size when known, particularly relevant to Hong Kong listings |
Notes
- Why the listing layer exists: prices are venue-specific. When an instrument is listed on multiple exchanges, its OHLC differs per venue.
/instruments/{ref}/candlesprices from the default (primary) listing venue, andresolvedechoes the actuallisting_id/venuethe price came from; for a specific venue use/listings/{ref}/candles(see Candles).