Chart list
Chart catalog: chart_name, time_field and fields[] (series keys)
/openapi/v1/analysesReturns metadata for every chart available through the Analysis module: the name to pass to GET /analyses/{chart_name}, the time field, and the numeric series each chart carries.
Request Parameters
No parameters.
Request Example
curl "https://openapi.sosovalue.com/openapi/v1/analyses" \ -H "x-soso-api-key: $SOSO_API_KEY"
Response Example
[
{
"chart_name": "fgi_indicator",
"time_field": "timestamp",
"fields": [
{ "name": "crypto_fear_&_greed_index", "type": "number" }
]
},
{
"chart_name": "futures_open_interest",
"time_field": "timestamp",
"fields": [
{ "name": "all", "type": "number" },
{ "name": "binance", "type": "number" },
{ "name": "cme", "type": "number" },
{ "name": "okex", "type": "number" },
{ "name": "bybit", "type": "number" },
{ "name": "bitget", "type": "number" },
{ "name": "deribit", "type": "number" },
{ "name": "btc_price", "type": "number" }
]
}
]Response Fields
| Field | Type | Description |
|---|---|---|
| chart_name | String | Identifier to pass to GET /analyses/{chart_name} |
| time_field | String | Name of the time column in the data rows (always timestamp) |
| fields | Array[Object] | Numeric series carried by this chart |
| fields[].name | String | Series key as it appears in each data row |
| fields[].type | String | Always number |
How to read this section
Each table lists a chart_name and the series keys that chart carries. Three rules apply to every chart:
1. Series keys are returned verbatim — treat them as strings, not identifiers. Keys may contain &, /, parentheses, full-width parentheses, or a leading digit: crypto_fear_&_greed_index, long/short_ratio, daily_block_rewards_(btc), eth_staked(usd), 1d_btc_inflow, 24h_vol. Always access them with bracket notation.
This is also the most common source of error in AI-generated clients: assistants tend to normalise such keys into valid identifiers (crypto_fear_greed_index, long_short_ratio, vol_24h), which then match nothing. Confirm key spelling against a real response.
2. A series may be absent from individual rows. Rows omit keys whose value is null rather than emitting null, so the key set varies row to row. Measured over 60 rows per chart, 15 of the 30 charts have at least one series that is present in only some rows (as low as 36 of 60). Guard every access:
// ❌ throws on rows where btc_price is absent const p = row.btc_price.toFixed(2); // ✅ const p = row.btc_price != null ? Number(row.btc_price).toFixed(2) : null;
3. btc_price (and eth_price, bitcoin_price) is an overlay series, not the subject. Many charts include a price series purely so it can be plotted behind the metric. It is not part of the metric itself.
Five charts additionally declare series that are never populated — see Known issues.
Available charts
30 charts, verified against production on 2026-08-05.
Market aggregate
Total Crypto Market Cap & Volume
total_crypto_market_cap
Total market value of all cryptocurrencies' circulating supply.
Series:
total_crypto_market_capmarket_cap24h_vol— ⚠️ declared but never returned
Altcoin Market Cap & Volume
altcoin_market_cap_volume
Series:
altcoin_market_capaltcoin_volume
USD Inflows into Cryptocurrency Markets
usd_inflows_into_cryptocurrency_markets
Series:
cumulative_net_inflowsetf_cumulative_net_inflowsfiat_backed_stablecoin_cumulative_net_inflowsdaily_net_inflowsetf_total_net_inflowsfiat_backed_stablecoin_total_net_inflowsbtc_etf_inflowseth_etf_inflowsfiat_backed_stablecoin_inflows— ⚠️ declared but never returned
TVL by Chain Type
tvl_of_different_type_of_chain
Total value locked, split by chain category.
Series:
all— present in 50 of 60 rows sampledethereumlayer_2— present in 50 of 60 rows sampledothers— present in 50 of 60 rows sampled
Sentiment & indicators
crypto_fear_&_greed_index is a 0–100 reading (27 = fear); ahr999 is a unitless ratio.
Fear and Greed Index (FGI)
fgi_indicator
Series:
crypto_fear_&_greed_index
AHR 999
ahr_999_indicator
Bitcoin DCA valuation indicator; readings below ~0.45 have historically marked accumulation zones.
Series:
btc_priceahr999fixed_investment_zome— ⚠️ declared but never returnedbuy_at_the_buttom— ⚠️ declared but never returned
Derivatives
Exchange-named series carry that exchange's value. Open interest is in USD; funding rates are decimal fractions, not percentages.
Bitcoin Futures Open Interest
futures_open_interest
BTC futures open interest per exchange, in USD. all is the cross-exchange aggregate.
Series:
allbinancecmeokexbybitbitgetderibitbtc_price
CME Bitcoin Futures — Volume & Open Interest
bitcoin_futures_volume_open_interest
CME-only volume and open interest.
Series:
btc_priceopen_interest— ⚠️ lagsbtc_priceby one day (see below)volume— ⚠️ lagsbtc_priceby one day (see below)
⚠️ open_interest / volume are one day behind btc_price. Measured over 400 rows: btc_price runs to 2026-08-12 while both other series stop at 2026-08-11, so the newest row carries btc_price only and data[0].open_interest is missing.
For plain BTC open interest prefer futures_open_interest — it is complete on the latest row and also breaks OI down per exchange. Use this chart only when you specifically need the CME volume/OI pair, and read from data[1] (or skip rows without the key).
Bitcoin Funding Rate
funding_rate
Perpetual funding rate per exchange. Decimal fractions, not percentages; may be negative.
Series:
binanceokxbitmexbybitbtc_price
Binance BTCUSDT Futures — Long/Short Ratio (1h)
binance_btcusdt_futures_long_short_ratio_1h
Series:
btc_price— present in 59 of 60 rows sampledtop_trader_long/short_ratio_(accounts)top_trader_long/short_ratio_(positions)long/short_ratio
Binance BTCUSDT Futures — Long/Short Ratio (4h)
binance_btcusdt_futures_long_short_ratio_4h
Series:
btc_price— present in 59 of 60 rows sampledtop_trader_long/short_ratio_(accounts)top_trader_long/short_ratio_(positions)long/short_ratio
Binance BTCUSDT Futures — Long/Short Ratio (12h)
binance_btcusdt_futures_long_short_ratio_12h
Series:
btc_price— present in 58 of 60 rows sampledtop_trader_long/short_ratio_(accounts)top_trader_long/short_ratio_(positions)long/short_ratio
Binance BTCUSDT Futures — Long/Short Ratio (1d)
binance_btcusdt_futures_long_short_ratio_1d
Series:
btc_price— present in 59 of 60 rows sampledtop_trader_long/short_ratio_(accounts)top_trader_long/short_ratio_(positions)long/short_ratio
Bitcoin on-chain
Counts are raw. btc_miner_revenue is denominated in BTC.
Bitcoin Hashrate
btc_hashrate
Series:
btc_hashratebtc_price— present in 59 of 60 rows sampled
Bitcoin Mining Difficulty
btc_mining_difficulty
Series:
btc_mining_difficultybtc_price— present in 59 of 60 rows sampled
Bitcoin Miner Revenue
btc_miner_revenue
⚠️ Both metric series are currently never returned — only the btc_price overlay remains. See Known issues.
Series:
daily_block_rewards_(btc)— ⚠️ declared but never returneddaily_total_fees_(btc)— ⚠️ declared but never returnedbtc_price
Bitcoin Price & Block Rewards
btc_price_block_reward
Series:
block_rewardsbtc_price
Bitcoin Number of Transactions
btc_transactions
Series:
number_of_transactions— present in 59 of 60 rows sampled30_day_average_number_of_transactions— present in 59 of 60 rows sampledbtc_price
Bitcoin Number of Active Addresses
btc_active_addresses
Unique addresses active as sender or receiver on the Bitcoin network.
Series:
number_of_active_addresses— present in 59 of 60 rows sampledbtc_price
Bitcoin Number of New Addresses
btc_new_addresses
Series:
number_of_new_addresses— present in 59 of 60 rows sampledbtc_price
Ethereum staking
ETH Staking Amount
eth_staking_amount
Sum of ETH at stake on the Beacon Chain. eth_staked(usd) is the USD value of the same position.
Series:
eth_staking_amounteth_staked(usd)
ETH Staking Ratio
eth_staking_ratio
ETH staked divided by ETH circulating supply. Values are decimal fractions that sum to 1.
Series:
stakingnon_staked
Stablecoins
Stablecoin Total Market Cap
stablecoin_total_market_cap
mcap is the aggregate; per-ticker series are that stablecoin's market cap. All USD.
Series:
mcapusdtusdcusdsusdepyusdusdd
Fiat-Backed Stablecoins (USD Pegged, Mcap > 100M) — Net Inflows
fiat_backed_stablecoins_usd_pegged_mcap_net_inflows
Series:
fiat_backed_stablecoins_mcapfiat_backed_stablecoins_net_inflows
Asset-Backed Stablecoins (USD Pegged, Mcap > 100M) — Net Mint Amount
asset_backed_stablecoins_usd_pegged_mcap_net_mint_amount
Series:
asset_backed_stablecoins_mcapasset_backed_stablecoins_net_mint_amount
Crypto spot ETF flows
For per-issuer breakdown, AUM and premium/discount, use the ETF module instead.
Total Bitcoin Spot ETF Net Inflow
total_crypto_spot_etf_fund_flow
Series:
bitcoin_etfethereum_etffield_2— ⚠️ returned but not declared inGET /analyses
Total US BTC & ETH Spot ETF Net Inflow
total_crypto_spot_btc_eth_etf_fund_flow_1d
Series:
bitcoin_daily_total_net_inflow— present in 40 of 60 rows sampledethereum_daily_total_net_inflow— present in 40 of 60 rows sampledbitcoin_priceethereum_price
Total Ethereum Spot ETF Net Inflow
total_crypto_eth_etf_fund_flow
Series:
bitcoin_etf— present in 40 of 60 rows sampledethereum_etf— present in 40 of 60 rows sampledbtc_price
Total HK BTC Spot ETF — BTC Inflow
total_crypto_hk_btc_etf_fund_flow
Series:
1d_btc_inflow— present in 36 of 60 rows sampledtotal_btc_in_hk_etf— present in 36 of 60 rows sampledtotal_net_assets— present in 36 of 60 rows sampledbtc_price
Total HK ETH Spot ETF — ETH Inflow
total_crypto_hk_eth_etf_fund_flow
Series:
1d_eth_inflow— present in 36 of 60 rows sampledtotal_eth_in_hk_etf— present in 36 of 60 rows sampledtotal_net_assets— present in 36 of 60 rows sampledeth_price
Example
curl -sS -H 'x-soso-api-key: YOUR_KEY' \ 'https://openapi.sosovalue.com/openapi/v1/analyses'