Instrument detail
One instrument
GET
/openapi/v3/instruments/{ref}Refresh: Minute / daily
This endpoint uses v3 at https://openapi.sosovalue.com/openapi/v3. Do not append it to /openapi/v1; see version-specific conventions.
Returns the instrument itself plus its listings.
Supported optional parameters are expand=profile,derivatives, lang=en|zh, and the standard type / venue / expiry disambiguation selectors.
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" \ -H "x-soso-api-key: $SOSO_API_KEY"
Response Fields
data: instrument_id / instrument_type / symbol / name / is_delisted / delisted_on / last_trade_date / figi / asset_id + listings[] (structure below). ?expand=profile adds the same profile fields described for catalog rows; ?expand=derivatives adds linked contracts.
Notes
- On this endpoint only, each entry in
listings[]additionally carriestrading_sessions(the listing's session definition: timezone, start/end of each session, whether 7×24). This block is populated only here —/listings/{ref}and/instruments/{ref}/listingsdo not include it.