| # APEX Data Hub API Reference |
|
|
| This package mounts new API routes without replacing the existing Space homepage. |
|
|
| ## Console routes |
|
|
| - `GET /datahub` — English Data Hub console. |
| - `GET /datahub/console` — same console route. |
| - `GET /datahub/help` — help and operating guide. |
|
|
| ## Provider probe API |
|
|
| - `GET /api/provider-probe/catalog` |
| - Returns the active provider catalog loaded from `api-resources/apex_provider_runtime_catalog_free_v1.json`. |
|
|
| - `GET /api/provider-probe/status` |
| - Returns the latest persisted provider health summary from SQLite. |
|
|
| - `GET /api/provider-probe/run?concurrency=5&timeout=12` |
| - Runs a backend-side provider probe from the Hugging Face Space runtime. |
| - Returns a single report with summary, healthy/degraded/failed providers, capability matrix, recommended order, missing secrets, and raw evidence. |
|
|
| - `GET /api/provider-probe/report` |
| - Returns the latest complete persisted runtime report. |
|
|
| - `GET /api/provider-probe/history?limit=10` |
| - Returns recent probe run summaries. |
|
|
| ## Compatibility API added for APEX gaps |
|
|
| - `GET /api/coverage` |
| - Provider and capability coverage summary derived from persisted health results. |
|
|
| - `GET /api/new-sources/status` |
| - New-source and missing-secret status, suitable for diagnostics UI. |
|
|
| - `GET /api/fear-greed` |
| - Alternative.me Fear & Greed wrapper. Does not invent upstream confidence. |
|
|
| - `GET /api/defi/protocols` |
| - DeFiLlama protocols/TVL wrapper. |
|
|
| - `GET /api/defi/yields` |
| - DeFiLlama yields/pools wrapper. |
|
|
| - `GET /api/news/latest` |
| - Unified news wrapper: keyed providers first when configured, then public/server-side fallbacks, then explicit `UNAVAILABLE`. |
|
|
| - `GET /api/resources/news/latest` |
| - Alias for the unified news service. |
|
|
| ## Response states |
|
|
| The package preserves no-fabrication semantics: |
|
|
| - `LIVE` — fresh provider data fetched and parsed successfully. |
| - `CACHED` — previously real data, returned within an explicit freshness window. |
| - `DEGRADED` — partial or lower-quality fallback; never treated as primary truth. |
| - `UNAVAILABLE` — no trusted source currently available. |
| - `NEEDS_KEY` — provider is configured in catalog but required/optional key is missing. |
| - `SCHEMA_MISMATCH` — HTTP response arrived but failed parser/validator expectations. |
| - `RATE_LIMITED` — provider rejected due to quota/rate limit. |
| - `HTTP_ERROR` / `NETWORK_ERROR` — transport failed. |
|
|
| ## Secret policy |
|
|
| Secret values never appear in committed files, HTML, API responses, JSON reports, or logs. Use Hugging Face Space Secrets only. |
|
|
