Loventy
Planned contracts only

Frontend API contract stubs for future market intelligence services.

These examples define payload shapes for later backend work. They are documentation only and do not implement endpoints, fetch calls, live providers or automation.

Prototype/static only. Backend-only secrets required. Not real-time. Not financial advice.

planned only

/api/news-impact

Purpose: classify a catalyst and affected markets.

{ "eventId": "evt_oil_supply_sample", "sourceType": "news", "reviewMode": "required" }
{ "impact": "volatile", "assets": ["Brent","WTI"], "status": "queued_for_review" }

Security: backend-only secrets. Compliance: no direct publication without review.

planned only

/api/market-forecast

Purpose: return reviewed forecast scenario cards.

{ "region": "global", "horizon": "next_session", "includeReview": true }
{ "bias": "volatile", "confidence": "medium", "reviewStatus": "approved" }

Security: backend authorization. Compliance: forecasts remain informational scenarios.

planned only

/api/asset-impact-map

Purpose: map catalysts to assets, sectors and regions.

{ "catalystId": "cat_rates_sample", "assetScope": ["indices","fx"] }
{ "assets": ["USD","banks"], "riskLevel": "elevated", "nextReviewWindow": "target_2h" }

Security: no frontend keys. Compliance: scenario classification only.

planned only

/api/catalyst-watch

Purpose: list catalyst categories and priority labels.

{ "categories": ["central_banks","crypto_regulation"], "status": "planned" }
{ "items": [{ "name": "Central banks", "priority": "high" }] }

Security: provider access must remain backend-side. Compliance: no unlicensed redistribution.

planned only

/api/watchlist-impact

Purpose: show reviewed catalyst impact for watched assets.

{ "watchlist": ["BTC","Brent"], "userScope": "prototype" }
{ "items": [{ "asset": "BTC", "status": "under_review" }] }

Security: user auth and privacy review required later. Compliance: no personal advice.

planned only

/api/alerts

Purpose: queue reviewed alert concepts for opted-in users.

{ "asset": "Nasdaq", "alertType": "forecast_changed" }
{ "queued": false, "reason": "prototype_static_only" }

Security: alert opt-in and rate limiting required. Compliance: no alert before review rules.

planned only

/api/ai-provider-router

Purpose: route AI tasks to approved providers.

{ "task": "risk_extraction", "providerPolicy": "backend_only" }
{ "provider": "planned_router", "outputStatus": "requires_review" }

Security: Anthropic/OpenAI keys must never reach frontend. Compliance: output logged and reviewed.

planned only

/api/review-queue

Purpose: manage human/compliance review before publication.

{ "draftId": "draft_forecast_sample", "action": "review" }
{ "state": "pending", "allowedActions": ["approve","edit","reject","escalate"] }

Security: reviewer auth required. Compliance: audit log mandatory.