Listed-company crypto treasury
Listed-company crypto treasury
GET
/openapi/v3/instruments/{ref}/treasuryRefresh: Minute / daily
This endpoint uses v3 at https://openapi.sosovalue.com/openapi/v3. Do not append it to /openapi/v1; see version-specific conventions.
For US-listed companies that hold crypto assets ("crypto treasury stocks"). For other instruments, or when nothing is disclosed, data.treasury is null.
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 |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | Optional | Caps the number of lots[] entries (see the general rules in Pagination) |
Request Example
curl "https://openapi.sosovalue.com/openapi/v3/instruments/MSTR.US/treasury" \ -H "x-soso-api-key: $SOSO_API_KEY"
Response Fields
data.treasury (snapshot):
| Field | Type | Description |
|---|---|---|
| is_mining | Boolean | Whether mining is involved (absent = unknown, false = explicitly not) |
| coin_symbol | String | Coin held |
| coin_hold_num / coin_hold_value | String | Amount held / market value |
| avg_cost / position_cost | String | Average cost / position cost |
| data_update_time | String | Data update time |
| source_link | String | Disclosure source link |
data.lots[] (purchase detail; data.count is the row count):
| Field | Type | Description |
|---|---|---|
| lot_date | String | Purchase date |
| coin_amount / coin_price | String | Amount / execution price for this lot |
| cost_value | String | Cost of this lot |
| source_link | String | Disclosure source link |