Hugging Face's logo

Spaces:
Really-amin
/
Datasourceforcryptocurrency-4
Paused

App Files Community
Datasourceforcryptocurrency-4 / docs /API_REFERENCE.md
Really-amin's picture
Really-amin
APEX Data Hub free backend provider update
f6c8eac verified
preview code
|
Raw History Blame Contribute Delete
2.54 kB

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.