API FAQ

Frequently asked questions

Why do I get 401?

Missing or invalid X-API-Key header. v1 feeds require auth.

Fix: Use X-API-Key header. Bearer is NOT supported.

curl -H "X-API-Key: YOUR_KEY" https://api.feedoracle.io/api/v1/feeds/carbon/chains

→ See Authentication & Vendor Controls for canonical base URL, deprecation policy, and expected 401 behavior.

How do I use v3 sustainability endpoint?

/api/v3/disclosure/sustainability/{symbol} returns single-network sustainability data (public, no API key required).

Related: /api/v3/disclosure/networks returns all networks in one call.

Which endpoints need no key?

• /api/v3/disclosure/networks - All networks
• /api/v2/l2/cheapest - Cheapest L2
• /api/v2/l2/health - L2 sequencer health
• /api/v2/attestation/status - DAP status
• /api/v2/quality/status - Data quality
• /api/health.json - System health

Public endpoints are rate-limited (100 req/min). Key = higher limits.

How to rotate keys?

1. Generate new key at /subscribe
2. Deploy new key to your app
3. Test new key works
4. Disable old key

ID Types

• snapshot_id (UUID) → /api/v2/snapshots/{id}
• report_id (MOAT) → /api/v2/verify/{id}
• attestation_id (dap_*) → /verify/{id}