Introducing the Dotlake API: Polkadot Ecosystem Data at Your Fingertips
Overview
The Parity Data Team is excited to announce the Dotlake API — a RESTful API providing programmatic access to comprehensive blockchain metrics across the Polkadot, Kusama, Westend, Paseo, ans Solo (Substrate) ecosystems.
Production URL: https://api.data.parity.io
Interactive Documentation: Dotlake API - Swagger UI
Whether you’re building dashboards, conducting research, or developing analytics tools, Dotlake provides the data infrastructure you need without the complexity of running your own indexers.
The Problem
Accessing reliable, aggregated blockchain data in the Polkadot ecosystem has traditionally required:
- Running and maintaining your own indexer infrastructure
- Writing complex queries against raw blockchain data
- Aggregating data across multiple parachains manually
- Significant DevOps overhead for data pipelines
While tools like Subscan and SubQuery serve specific use cases well, there’s been a gap for developers who need pre-aggregated, time-series metrics via a simple REST API.
What Dotlake Provides
Daily Metrics
| Endpoint | Description |
|---|---|
/api/daily-uptime |
Chain uptime percentages (1-day, 7-day, 30-day windows) |
/api/daily-tps |
Transactions per second |
/api/daily-fees |
Transaction fees in native tokens and USD |
/api/daily-summary |
25+ comprehensive daily indicators |
/api/daily-staking-participation |
Validators, nominators, pools, and staked amounts |
/api/daily-staking-rewards |
Per-account staking rewards in native tokens and USD |
/api/daily-opengov-referenda-results |
Referendum outcomes, support levels, and voting data |
/api/daily-usdc / /api/daily-usdt |
Stablecoin holdings across chains |
Monthly Metrics
| Endpoint | Description |
|---|---|
/api/monthly-active-validators |
Validator and nominator counts |
/api/monthly-percent-staked |
DOT issuance and staking ratios |
/api/monthly-opengov-participation |
Voter counts by type |
/api/monthly-opengov-tokens |
DOT voting volumes |
/api/monthly-treasury-assets |
Treasury holdings in native tokens and USD |
/api/monthly-treasury-balances |
Treasury as percentage of total issuance |
/api/monthly-unique-accounts |
Active account metrics |
Coverage
- Relay Chains: Polkadot, Kusama, Westend, Paseo
- Parachains: Parachains and Solo-chains with data dating back to genesis
- Data Freshness: Daily updates
Authentication
Dotlake uses a wallet-based registration system powered by SIWS (Sign-In With Substrate):
- Visit the registration page and connect your Polkadot wallet
- Click on
Request API Keyto get your wallet on the allowlist - Once done, you can immediately
Sign in with Walletand cretae your API key - Use the key as a Bearer token:
Authorization: Bearer <your-api-key>
No email verification delays. Pure Web3 authentication (h/t to @shawn.coe:parity.io for SIWS).
We will monitor API usage and revoke acccess to anyone abusing the server. We can add verification if we need to, but for now it is totally open.
Example Usage
# Query daily staking participation for Polkadot
curl -X GET "https://api.data.parity.io/api/daily-staking-participation" \
-G \
--data-urlencode "relay_chain=polkadot" \
--data-urlencode "start_date=2025-01-01" \
--data-urlencode "end_date=2025-01-15" \
-H "Authorization: Bearer $API_KEY"
{
"data": [
{
"date": "2025-01-15",
"relay_chain": "polkadot",
"chain": "polkadot",
"number_of_validators": 500,
"number_of_nominators": 28450,
"number_of_pools": 215,
"staked_DOT": 725000000.5,
"percentage_staked": 58.2
}
]
}
Use Cases
- Dashboard Builders: Power real-time ecosystem health dashboards
- Researchers: Analyze governance participation trends over time
- Treasury Analysts: Track treasury balances and spending patterns
- Staking Services: Monitor validator performance and reward distributions
- DeFi Protocols: Access stablecoin supply data across chains
Technical Details
- Backend: FastAPI (Python) with ClickHouse for high-performance analytics
- Frontend: Vite + vanilla JavaScript with Polkadot wallet integration
- Authentication: SIWS (Sign-In With Substrate) for wallet-based auth
- Rate Limiting: Fair usage policies apply
Getting Started
- Get an API Key: Visit https://api.data.parity.io and connect your wallet
- Explore the Docs: Interactive Swagger documentation at
/docs - Start Querying: Use any HTTP client to access the endpoints
Feedback Welcome
We’re actively developing Dotlake and would love your input:
- What additional metrics would be valuable?
Drop your feedback in this thread or reach out to the Parity Data Team.