ETF historical data
History of one fund, last 1 month. Flows settle T+1: on the newest row the flow fields are null — skip it or use market-snapshot
GET
/openapi/v1/etfs/{ticker}/historyRefresh: 1 min
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| ticker | string | Required | ETF ticker |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| start_date | string | Optional | Start date. Only the most recent 1 month is supported |
| end_date | string | Optional | End date. Only the most recent 1 month is supported |
Request Example
curl "https://openapi.sosovalue.com/openapi/v1/etfs/IBIT/history" \ -H "x-soso-api-key: $SOSO_API_KEY"
Response Example
[
{
"date": "2024-04-12",
"ticker": "IBIT",
"net_inflow": 3000000,
"cum_inflow": 400000000,
"net_assets": 5000000,
"currency_share": 0.005,
"prem_dsc": -0.0001,
"value_traded": 4441000000,
"volume": 322302
}
]Response Fields
| Field | Type | Description |
|---|---|---|
| date | String | Data date, YYYY-MM-DD (not an epoch timestamp) |
| ticker | String | ETF ticker |
| net_inflow | Number | Daily net inflow (USD) |
| cum_inflow | Number | Cumulative net inflow (USD) |
| net_assets | Number | Net assets (USD) |
| currency_share | Number | Market share |
| prem_dsc | Number | Premium/discount rate |
| value_traded | Number | Trading volume (USD) |
| volume | Number | Share volume |
Notes
- The query range is limited to the most recent 1 month.
The most recent row is not settled yet
Flow and asset figures settle on a T+1 basis. On the current trading day the row already exists — carrying value_traded and volume — while the settled fields are still null:
[
{
"date": "2026-08-12",
"ticker": "IBIT",
"net_inflow": null,
"cum_inflow": null,
"net_assets": null,
"currency_share": null,
"prem_dsc": null,
"value_traded": 910925300,
"volume": "910925300"
},
{
"date": "2026-08-11",
"ticker": "IBIT",
"net_inflow": 50195600,
"cum_inflow": 61171454223.66,
"net_assets": 47337319120,
"...": "..."
}
]Taking data[0] therefore yields null for every flow metric. Two ways to handle it:
| Goal | Do this |
|---|---|
| Latest settled values | Use GET /etfs/{ticker}/market-snapshot — it always returns the latest settled figures |
| Walking this array | Skip rows where net_inflow is null, or start from data[1] |
This is settlement latency, not a gap in the data — the same row is complete the next day.
Known issues
volumecurrently returns the same value asvalue_traded(USD turnover), and as a JSON string rather than a number — it is not the share count the field name implies. For share volume usevolumefrommarket-snapshot(≈36× smaller). A fix is pending; do not build on the currentvolumehere.