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

Field Name	Type	Description
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

Field Name	Type	Description
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

Code	Description
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

SoSoValue ETF Dashboard