خلاصه / Summary
این دموی UI نمای کلی «پک مرجع دادههای رمز ارز» را با کارتهای KPI، تبهای پیمایش و جدولهای فشرده نمایش میدهد.
Total Providers
—
▲ +5
Free Endpoints
—
▲ 2
Failover Chains
—
▲ 1
WS Topics
—
▲ 3
نمونه درخواستها (Examples)
CoinGecko – Simple Price
curl -s 'https://api.coingecko.com/api/v3/simple/price?ids=bitcoin,ethereum&vs_currencies=usd'
Binance – Klines
curl -s 'https://api.binance.com/api/v3/klines?symbol=BTCUSDT&interval=1h&limit=100'
Registry Snapshot
نمای خلاصهی ردهها و سرویسها (نمونهداده داخلی)
Categories
| Category | Count | Notes |
|---|
Highlighted Providers
| Name | Role | Status |
|---|
Failover Chains
زنجیرههای جایگزینی آزاد-محور (Free-first)
Realtime (WebSocket)
قرارداد موضوعها، پیامها، heartbeat و استراتژی reconnect
Topics
| Topic | Example |
|---|
Sample Message
Collection Plan (ETL/ELT)
زمانبندی دریافت داده و TTL
| Bucket | Endpoints | Schedule | TTL |
|---|
Query Templates
قرارداد endpointها + نمونه cURL
coingecko.simple_price
GET /simple/price?ids={ids}&vs_currencies={fiats}
curl -s 'https://api.coingecko.com/api/v3/simple/price?ids=bitcoin,ethereum&vs_currencies=usd'
binance_public.klines
GET /api/v3/klines?symbol={symbol}&interval={interval}&limit={n}
curl -s 'https://api.binance.com/api/v3/klines?symbol=BTCUSDT&interval=1h&limit=100'
Observability
متریکها، بررسی کیفیت داده، هشدارها
Success Rate
—
▲
p95 Latency
—
▼
Failover Activations
—
▲
Data Quality Checklist
| Rule | Status | Note |
|---|
Docs (Compact)
راهنمای استفاده، امنیت و نسخهبندی بهصورت خلاصه
Quick Start
- JSON اصلی را لود کنید.
- از discovery برای یافتن id استفاده کنید.
- query_templates را بخوانید.
- Auth را اعمال کنید (توکن سرویس + کلید آزاد).
- درخواست بزنید یا به WS مشترک شوید.
Security Notes
- کلیدهای رایگان عمومیاند؛ برای سقف بیشتر کلید خودتان را وارد کنید.
- توکن سرویس، سهمیه و دسترسی را کنترل میکند.
- کلیدها در لاگ ماسک میشوند.
Change Log
{
"version": "3.0.0",
"changes": ["Added WS spec","Expanded failover","Token-based access & quotas","Observability & DQ"]
}