sosovalue-pandas
Python client for the SoSoValue API that returns data as pandas DataFrames.
Installation
uv add sosovalue-pandas
# or
pip install sosovalue-pandas
Quick start
from sosovalue_pandas import SoSoValueClient
with SoSoValueClient(api_key="your-api-key") as client:
# ETF inflows for a single type (~300 daily points)
df = client.get_etf_historical_inflow_chart("us-btc-spot")
# All supported ETF types in one DataFrame
df_all = client.get_all_etf_inflows()
# All listed cryptocurrencies
df_currencies = client.get_all_listed_currencies()
API reference
SoSoValueClient(api_key, base_url, timeout)
| Method | Description |
|---|---|
get_etf_historical_inflow_chart(etf) |
~300 daily points for one ETF type |
get_all_etf_inflows() |
All ETF types concatenated |
get_all_listed_currencies() |
All listed cryptocurrencies |
ETF types
from sosovalue_pandas import ETF_TYPES
# ["us-btc-spot", "us-eth-spot", "us-sol-spot", "us-doge-spot",
# "us-ltc-spot", "us-link-spot", "us-avax-spot"]
ETF inflow columns
| Column | Type | Description |
|---|---|---|
date |
datetime64 |
Trading date |
totalNetInflow |
float |
Daily net inflow (USD) |
totalValueTraded |
float |
Total value traded (USD) |
totalNetAssets |
float |
Total net assets (USD) |
cumNetInflow |
float |
Cumulative net inflow (USD) |
etf |
str |
ETF type identifier |
Currencies columns
| Column | Type | Description |
|---|---|---|
currencyId |
int |
Unique identifier |
fullName |
str |
Full name (e.g. "Bitcoin") |
currencyName |
str |
Ticker symbol (e.g. "BTC") |
Error handling
from sosovalue_pandas import SoSoValueClient, SoSoValueError
with SoSoValueClient(api_key="...") as client:
try:
df = client.get_etf_historical_inflow_chart("us-btc-spot")
except SoSoValueError as e:
print(f"API error: {e}")
API key
Get your API key from SoSoValue OpenAPI.
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for sosovalue-pandas 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sosovalue_pandas-0.1.1.tar.gz | 3.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sosovalue_pandas-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 8.7 kB
Release files / sosovalue_pandas-0.1.1.tar.gz
| Download URL | sosovalue_pandas-0.1.1.tar.gz |
|---|---|
| Size | 3.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
039a3584069a05b77e0bfee9d461402fe987c9fbffbde10003c486bc626ed543
|
|
BLAKE2b-256 checksum How to use checksums |
064c4ad13ae8b80b8b89ba63342f7d2c084499bee7ef809910414a69147145bb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / sosovalue_pandas-0.1.1-py3-none-any.whl
| Download URL | sosovalue_pandas-0.1.1-py3-none-any.whl |
|---|---|
| Size | 4.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e74cedd6604c980cf40143b0bb5aed45485d9832531031d46da796f8a608f2a8
|
|
BLAKE2b-256 checksum How to use checksums |
837be0f8bd85b50d6c4d4807c7666389eea257bd04000feaeffc3f1b46dde02f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
