API Versioning
Understanding FeedOracle API path versions
Key concept: Path versions (v1/v2/v3) and product versions (schema_version) are independent.
API Path Versions
| Path | Purpose | Status |
|---|---|---|
/api/v3/ | Disclosure API with attestation | Partial |
/api/v2/ | MOAT, Attestations, Reports | Current |
/api/v1/ | Legacy data feeds | Supported |
v2 Endpoints (MOAT)
| Endpoint | Auth | Description |
|---|---|---|
GET /api/v2/verify/{report_id} | None | Verify MOAT report |
GET /api/v2/snapshots/latest | None | Latest snapshot |
GET /api/v2/quality/status | None | Quality metrics |
GET /api/v2/attestation/status | None | DAP system status |
GET /api/v2/attestation/chains | None | Multi-chain anchors |
GET /api/v2/attestation/activity | None | Recent activity |
GET /api/v2/l2/health | None | L2 chain health |
ID Types
Important: Do not confuse these ID types.
| ID Type | Format | Used With |
|---|---|---|
snapshot_id | UUID | /api/v2/snapshots/{id} |
report_id | MOAT format | /api/v2/verify/{id} |
attestation_id | dap_* | /verify/{id} |
Authentication
v1 Data Feeds: Require X-API-Key header. No auth = 401.
v2 MOAT/Attestation: Public (no auth required).
v3 Disclosure: Public preview (no auth required).