Get current ETF data metrics
Overview
🌟 Tips:
This API provides current ETF data metrics (US BTC/ETH Spot ETFs) for BTC or ETH spot Exchange-Traded Funds (ETFs), enabling users to access detailed information and metrics that are essential for market analysis and investment decisions.
Access current daily data for each BTC/ETH spot ETF, and aggregate daily and cumulative metrics.
​Request Specification
POST /openapi/v2/etf/currentEtfDataMetrics
Request Parameters
type is required (String), samples: "us-btc-spot" or "us-eth-spot"
Sample Request
POST 'https://api.sosovalue.xyz/openapi/v2/etf/currentEtfDataMetrics' \
-H 'x-soso-api-key: YOUR_x-soso-api-key' \
-H 'Content-Type: application/json' \
-d '{"type": "us-btc-spot"}'Sample Response
{
"code": 0, // 0 for success, 1 for fail
"msg": null,
"data": {
"totalNetAssets": {
"value": 53060000000.0, // Total Net Assets of $53.06B
"lastUpdateDate": "2024-04-18"
},
"totalNetAssetsPercentage": {
"value": 0.00482, // Total Net Assets Perventage
"lastUpdateDate": "2024-04-18"
},
"totalTokenHoldings": {
"value": 120000.0, // Total Token Holdings, Cryptocurrency-denominated pricing
"lastUpdateDate": "2024-04-18"
},
"dailyNetInflow": {
"value": -4390000.0, // Daily Total Net Inflow of -$4.39M
"lastUpdateDate": "2024-04-18"
},
"cumNetInflow": {
"value": 102400000.0, // Cumulative Total Net Inflow of $102.4M
"lastUpdateDate": "2024-04-18"
},
"dailyTotalValueTraded": {
"value": 2570000000.0, // Daily Total Value Traded of $2.57B
"lastUpdateDate": "2024-04-18"
},
"list": [
{
"id": "1746110179689463810",
"ticker": "GBTC",
"institute": "Grayscale Investments",
"netAssets": {
"value": 7500000000.0, // Net Assets of $7.5B
"lastUpdateDate": "2024-04-18",
"status": "1" // Updated
},
"netAssetsPercentage": {
"value": 0.0155, // Net Assets Percentage of 1.55%
"lastUpdateDate": "2024-04-18",
"status": "1" // Updated
},
"dailyNetInflow": {
"value": null, // Not updated and is thus null
"lastUpdateDate": "2024-04-17",
"status": "3" // Not updated and not counted into total daily net inflow.
},
"cumNetInflow": {
"value": -16380000000.0, // Cumulative Net Inflow of -$16.38B
"lastUpdateDate": "2024-04-17",
"status": "2" // Not updated today but counted into all etf's total cumulative net inflow.
},
"dailyValueTraded": {
"value": 2580000000.0, // Total Value Traded of $2.58B
"lastUpdateDate": "2024-04-18",
"status": "1" // Updated
},
"fee": {
"value": 0.009,
"lastUpdateDate": "2024-04-18",
"status": "1" // Updated
},
"discountPremiumRate": {
"value": -0.0003,
"lastUpdateDate": "2024-04-18",
"status": "1" // Updated
}
},
...
]
}
}
General Data Fields
totalNetAssets
object
- value
float
Combined Value of all BTC or ETH ETFs, in USD.
- lastUpdateDate
string
Format: YYYY-MM-DD
totalNetAssetsPercentage
object
- value
float
The sum of all BTC or ETH spot ETF's net assets / BTC or ETH market cap, where the market cap is the market value at 4 PM New York time on the day.
- lastUpdateDate
string
Format: YYYY-MM-DD
totalTokenHoldings
object
- value
float
Combined number of $BTC or ETH held in all BTC or ETH ETFs. Cryptocurrency-denominated pricing. (This data is an estimate and may differ from the actual figures.)
- lastUpdateDate
string
Format: YYYY-MM-DD
dailyNetInflow
object
- value
float
Net inflow into all BTC or ETH ETFs in the last 24h of open market, in USD.
- lastUpdateDate
string
Format: YYYY-MM-DD
cumNetInflow
object
- value
float
Cumulative net inflows since launch of all spot BTC or ETH ETFs, in USD.
- lastUpdateDate
string
Format: YYYY-MM-DD
dailyTotalValueTraded
object
- value
float
Total daily value traded across all BTC or ETH spot ETFs, in USD.
- lastUpdateDate
string
Format: YYYY-MM-DD
List Data Fields
id
string
Unique identifier for the ETF.
ticker
string
Ticker symbol for the ETF.
institute
string
Institution managing the ETF.
netAssets
object
- value
float
Total value of ETF
- lastUpdateDate
string
Format: YYYY-MM-DD
- status
integer
Date update status
netAssetsPercentage
object
- value
float
Net assets / (BTC or ETH) market cap (The market value of BTC or ETH at 4 PM New York time on the day.)
- lastUpdateDate
string
Format: YYYY-MM-DD
- status
integer
Date update status
dailyNetInflow
object
- value
float
Net inflow from last 24h
- lastUpdateDate
string
Format: YYYY-MM-DD
- status
integer
Date update status
cumNetInflow
object
- value
float
Cumulative inflows since launch
- lastUpdateDate
string
Format: YYYY-MM-DD
- status
integer
Date update status
dailyValueTraded
object
Trading value details including value, update date, and status.
- value
float
Trading value on the last update date.
- lastUpdateDate
string
Format: YYYY-MM-DD
- status
integer
Date update status
fee
object
- value
float
Current fee rate for the ETF
- lastUpdateDate
string
Format: YYYY-MM-DD
- status
integer
Date update status
discountPremiumRate
object
- value
float
Discount or premium rate of the ETF
- lastUpdateDate
string
Format: YYYY-MM-DD
- status
integer
Date update status
Data Status Codes
1
Data is freshly updated.
This status indicates that the data has been updated most recently. It is directly included in the total calculations and ensures the most accurate and current representation of the values.
2
Data not updated but summed into total fields.
This status is applied when data has not been updated on the current day, yet the last updated values are still included in the overall calculations. This approach is generally used for data points where a daily update has a minimal impact on the aggregate results, such as the cumulative net inflow of a small-scale ETF. Including these values in the total helps to expedite the computation of aggregate data without significantly affecting the overall accuracy.
3
Data not updated and not summed into total fields.
This status is used when the data has not been updated and is also excluded from total calculations. This decision is based on the potential impact of outdated data on investment decisions. For instance, if daily net inflow data is outdated, including it might lead to incorrect interpretations, such as misrepresenting inflows as outflows, which can significantly alter investment strategies.
When status == 3, the data will be
null
How SoSo Value Present Data with Data Status Codes
Last updated