Introduction to Cryptocurrency Market Data
AKShare provides comprehensive cryptocurrency data through its API endpoints, offering real-time market insights, holdings reports, and CME trading volume analytics. This guide explores key functionalities with structured examples and actionable data.
Real-Time Cryptocurrency Market Data
API Endpoint: crypto_js_spot
Source: Jin10 Data Center
Description: Fetches live pricing for major cryptocurrencies.
Parameters
None required.
Output Fields
| Field | Type | Description |
|---|---|---|
| Market | object | Exchange/platform name |
| Trading Pair | object | Cryptocurrency pair (e.g., BTCUSD) |
| Latest Price | float64 | Current quote |
| Change Amount | float64 | Absolute price change |
| Change % | float64 | Percentage change |
| 24h High | float64 | Highest price in 24 hours |
| 24h Low | float64 | Lowest price in 24 hours |
| 24h Volume | float64 | Trading volume (base currency) |
| Update Time | float64 | Timestamp of last update |
Example Code
import akshare as ak
df = ak.crypto_js_spot()
print(df.head())Sample Data
| Market | Trading Pair | Latest Price | ... | 24h Volume |
|---|---|---|---|---|
| Bitfinex (Hong Kong) | LTCUSD | 231.57 | ... | 23,157.88 |
Bitcoin Holdings Report
API Endpoint: crypto_bitcoin_hold_report
Description: Tracks institutional Bitcoin holdings across public companies, governments, and ETFs.
Key Metrics
- Market Value: USD valuation of holdings.
- BTC % of Portfolio: Allocation weight.
- Holding Cost: Average acquisition price.
👉 Explore institutional Bitcoin trends
Sample Insights
| Company | Country | Holdings (BTC) | Market Value (USD) |
|------------------|-----------|----------------|---------------------|
| MicroStrategy | USA | 152,333 | 4.8B |
CME Bitcoin Volume Report
API Endpoint: crypto_bitcoin_cme
Date Parameter: Specify trade date (e.g., date="20230830").
Data Highlights
| Product | Type | Volume (Contracts) | Open Interest |
|--------------|--------|---------------------|----------------|
| Bitcoin Futures | Futures | 8,261 | 15,364 |
FAQ
Q: How frequently is real-time data updated?
A: Prices refresh every 1-2 minutes from exchange feeds.
Q: What’s included in the Bitcoin holdings report?
A: Covers 50+ entities, including Tesla, Grayscale ETFs, and government reserves.
Q: Can I pull historical CME data?
A: Yes—adjust the date parameter for past reports.