> For the complete documentation index, see [llms.txt](https://sosovalue.gitbook.io/soso-value-api-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sosovalue.gitbook.io/soso-value-api-doc/2.-etf/history.md).

# 2.4 ETF Historical Data

```
GET /etfs/{ticker}/history
```

**Path Parameters**

| Parameter   | Type   | Required | Description                                           |
| ----------- | ------ | -------- | ----------------------------------------------------- |
| ticker      | string | Yes      | ETF ticker                                            |
| start\_date | string | No       | Start date. Only the most recent 1 month is supported |
| end\_date   | string | No       | End date. Only the most recent 1 month is supported   |

**Response Example**

```json
[
    {
        "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`:

```json
[
    {
        "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`](/soso-value-api-doc/2.-etf/market-snapshot.md) — 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

* `volume` currently returns the **same value as `value_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 use `volume` from [`market-snapshot`](/soso-value-api-doc/2.-etf/market-snapshot.md) (≈36× smaller). A fix is pending; do not build on the current `volume` here.