Crypto market overview
Total market cap, 24h volume, BTC / ETH gas snapshot
GET
/openapi/v1/market/overviewRefresh: 30 s
A single call for the top-line crypto market figures: total market cap, 24-hour volume, and current BTC / ETH gas prices.
Request Parameters
No parameters.
Request Example
curl "https://openapi.sosovalue.com/openapi/v1/market/overview" \ -H "x-soso-api-key: $SOSO_API_KEY"
Response Example
{
"total_market_cap": "2280614829402.85",
"total_market_cap_change_pct": "0.6",
"total_volume_24h": "40122576829.22",
"eth_gas_gwei": "0.126601389",
"btc_gas_sat_vb": "6",
"as_of": 1785911722870
}Response Fields
| Field | Type | Description |
|---|---|---|
| total_market_cap | String | Total crypto market capitalisation, USD |
| total_market_cap_change_pct | String | 24-hour change of total market cap, as a percentage ("0.6" = 0.6%) |
| total_volume_24h | String | Total 24-hour trading volume, USD |
| eth_gas_gwei | String | Ethereum gas price in Gwei — Infura's suggested low tier |
| btc_gas_sat_vb | String | Bitcoin recommended median fee in sat/vB |
| as_of | Number | Generation time, millisecond epoch |
Field-level availability
This endpoint aggregates three independent sources. A field is omitted entirely if its source is unavailable — the request still returns 200 with whatever could be fetched:
| Field(s) | Source |
|---|---|
total_market_cap, total_market_cap_change_pct, total_volume_24h | Market quotation service |
eth_gas_gwei | Ethereum gas oracle snapshot |
btc_gas_sat_vb | Bitcoin fee estimator snapshot |
A partial response is normal, not an error. Treat every field as optional:
const cap = data.total_market_cap ?? null; // may be absent
as_of is always present.
Value formats
| Convention | Detail |
|---|---|
| Numbers are strings | Market cap and volume exceed the JavaScript safe-integer range. Parse with BigDecimal / decimal.Decimal, not float |
total_market_cap_change_pct is a percentage | "0.6" means 0.6%, not 0.6×. Divide by 100 for a decimal fraction |
eth_gas_gwei is Gwei | Already in Gwei — no unit conversion needed |
btc_gas_sat_vb is sat/vB | Satoshis per virtual byte |
Freshness
Cached for 30 seconds. Upstream refresh cadence is roughly:
| Data | Refresh |
|---|---|
| Market cap / volume | ~30 s |
| ETH gas | ~1 min |
| BTC gas | pushed on change |
Polling faster than every 30 seconds returns identical values.
Related
For historical series rather than a point-in-time snapshot, use Analysis Charts:
| Metric | Chart |
|---|---|
| Total market cap and volume history | total_crypto_market_cap |
| Fear & Greed Index | fgi_indicator |
| BTC futures open interest | futures_open_interest |
Gas prices are snapshot only — there is no historical gas series.
Example
curl -sS -H 'x-soso-api-key: YOUR_KEY' \ 'https://openapi.sosovalue.com/openapi/v1/market/overview'