ETF aggregated history
Daily aggregated data for one market's crypto ETFs by symbol and country_code: net inflow, value traded, net assets and cumulative inflow. Newest first, weekends and holidays excluded. For a single fund use /etfs/{ticker}/history.
GET
/openapi/v1/etfs/summary-historyRefresh: 1 min · Query: date range (start_date / end_date)
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Required | ETF underlying: BTC, ETH, SOL, LTC, HBAR, XRP, DOGE, LINK, AVAX, DOT |
| country_code | string | Required | US or HK; HK supports BTC, ETH, SOL only |
| start_date | string | Optional | yyyy-MM-dd; only the most recent 1 month is supported |
| end_date | string | Optional | yyyy-MM-dd; only the most recent 1 month is supported |
| limit | number | Optional | Default 50, max 300 |
Header: x-soso-api-key (required). All parameters go in the query string; no body.
Request example
curl "https://openapi.sosovalue.com/openapi/v1/etfs/summary-history?symbol=BTC&country_code=US&limit=30" \ -H "x-soso-api-key: $SOSO_API_KEY"
Response
{
"code": 0,
"message": "success",
"data": [
{
"date": "2024-04-12",
"total_net_inflow": -55066297.0000000000000000,
"total_value_traded": 4706120449.0000000000000000,
"total_net_assets": 56216535367.0000000000000000,
"cum_net_inflow": 13534833596.0950000000000000
},
{
"date": "2024-04-11",
"total_net_inflow": 91269283.0000000000000000,
"total_value_traded": 2498627928.0000000000000000,
"total_net_assets": 59225065270.0000000000000000,
"cum_net_inflow": 12581438056.0950000000000000
}
]
}HTTP/1.1 200 OK Content-Type: application/json X-RateLimit-Limit-Minute: 100 X-RateLimit-Remaining-Minute: 17 X-RateLimit-Reset-Minute: 1793250060 X-RateLimit-Limit-Month: 10000 X-RateLimit-Remaining-Month: 3580 X-RateLimit-Reset-Month: 1796083200
| Field | Type | Description |
|---|---|---|
| date | string | Trading day, weekends and holidays excluded |
| total_net_inflow | number | Net inflow across all funds that day (USD); negative means net outflow |
| total_value_traded | number | Total value traded that day (USD) |
| total_net_assets | number | Total net assets at close (USD) |
| cum_net_inflow | number | Cumulative net inflow since listing (USD) |
Endpoint-specific errors
| HTTP | code | Reason |
|---|---|---|
| 400 | 400002 | symbol or country_code missing |
| 400 | 400003 | symbol not in the supported list (details.constraint lists the allowed values) |
| 400 | 400001 | Valid symbol but no such listing, e.g. symbol=LTC&country_code=HK (Unsupported ETF category) |
Generic errors (401, 429, 5xx) are on the error codes page.