{"openapi":"3.1.0","info":{"title":"PlatPhorm Finance","version":"0.1.0-phase1","description":"PlatPhorm Finance provides public informational finance data and local simulations only. It does not provide personalized investment advice, execute trades, request brokerage credentials, or promise returns. Public-safe Phase 1 endpoints do not require authentication. PLATPHORM_API_KEY is documented for future protected backend actions only."},"servers":[{"url":"https://finance.platphormnews.com"}],"components":{"securitySchemes":{"PlatPhormApiKey":{"type":"apiKey","in":"header","name":"X-PlatPhorm-API-Key","description":"Future protected backend actions accept PLATPHORM_API_KEY. Public-safe Phase 1 flows do not require a key."},"PlatPhormBearer":{"type":"http","scheme":"bearer","description":"Future protected backend actions accept Authorization: Bearer $PLATPHORM_API_KEY."}}},"paths":{"/api/v1/markets":{"get":{"summary":"Markets API","description":"Public market summary. Public-safe endpoint.","security":[],"responses":{"200":{"description":"Standard PlatPhorm REST envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object"}}}}}}}}},"/api/v1/quotes":{"get":{"summary":"Quotes API","description":"Public quote lookup. Public-safe endpoint.","security":[],"responses":{"200":{"description":"Standard PlatPhorm REST envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object"}}}}}}}}},"/api/v1/quotes/{symbol}":{"get":{"summary":"Quote API","description":"Public quote by symbol. Public-safe endpoint.","security":[],"responses":{"200":{"description":"Standard PlatPhorm REST envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object"}}}}}}}}},"/api/v1/assets/{symbol}":{"get":{"summary":"Asset API","description":"Public asset profile by symbol. Public-safe endpoint.","security":[],"responses":{"200":{"description":"Standard PlatPhorm REST envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object"}}}}}}}}},"/api/v1/news":{"get":{"summary":"News API","description":"Public finance news feed. Public-safe endpoint.","security":[],"responses":{"200":{"description":"Standard PlatPhorm REST envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object"}}}}}}}}},"/api/v1/feeds":{"get":{"summary":"Feeds API","description":"Public finance feed sources. Public-safe endpoint.","security":[],"responses":{"200":{"description":"Standard PlatPhorm REST envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object"}}}}}}}}},"/api/v1/sources":{"get":{"summary":"Sources API","description":"Public provider source status. Public-safe endpoint.","security":[],"responses":{"200":{"description":"Standard PlatPhorm REST envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object"}}}}}}}}},"/api/v1/provider/status":{"get":{"summary":"Provider Status API","description":"Public provider health. Public-safe endpoint.","security":[],"responses":{"200":{"description":"Standard PlatPhorm REST envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object"}}}}}}}}},"/api/v1/watchlist":{"post":{"summary":"Watchlist API","description":"Validates a local watchlist without server persistence. Public-safe endpoint.","security":[],"responses":{"200":{"description":"Standard PlatPhorm REST envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object"}}}}}}}}},"/api/v1/portfolio/simulate":{"post":{"summary":"Portfolio Simulation API","description":"Public simulation-only portfolio calculator. Public-safe endpoint.","security":[],"responses":{"200":{"description":"Standard PlatPhorm REST envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object"}}}}}}}}},"/api/v1/calculators":{"get":{"summary":"Calculators API","description":"Public calculator registry. Public-safe endpoint.","security":[],"responses":{"200":{"description":"Standard PlatPhorm REST envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object"}}}}}}}}},"/api/v1/calculators/{slug}":{"post":{"summary":"Calculator Run API","description":"Runs an informational calculator. Public-safe endpoint.","security":[],"responses":{"200":{"description":"Standard PlatPhorm REST envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object"}}}}}}}}},"/api/v1/reports/summary":{"post":{"summary":"Report Summary API","description":"Public-safe degraded report scaffolding. Future protected-action metadata is exposed; enforcement is off by default for public-safe Phase 1.","security":[{"PlatPhormApiKey":[]}],"responses":{"200":{"description":"Standard PlatPhorm REST envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object"}}}}}}}}},"/api/v1/integrations/quickbooks/status":{"get":{"summary":"QuickBooks Status API","description":"Public-safe integration status only. Future protected-action metadata is exposed; enforcement is off by default for public-safe Phase 1.","security":[{"PlatPhormApiKey":[]}],"responses":{"200":{"description":"Standard PlatPhorm REST envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object"}}}}}}}}},"/api/mcp":{"get":{"summary":"MCP metadata","description":"Public read-only MCP metadata and capabilities.","responses":{"200":{"description":"MCP metadata"}}},"post":{"summary":"MCP JSON-RPC","description":"JSON-RPC 2.0 endpoint for initialize, ping, tools/list, tools/call, resources/list, resources/read, prompts/list, and prompts/get.","responses":{"200":{"description":"JSON-RPC 2.0 response"}}}},"/api/health":{"get":{"summary":"Health","description":"Public health summary with provider, discovery, auth, trace, and degraded storage status.","responses":{"200":{"description":"Health envelope"}}}},"/api/docs":{"get":{"summary":"Human API documentation","description":"Public HTML API documentation.","responses":{"200":{"description":"HTML docs"}}}}},"x-platphorm-finance":{"publicSafeAccess":true,"dataStatuses":["delayed","cached","stale","unavailable","degraded"],"realTimeClaim":false,"financialDisclaimer":"PlatPhorm Finance provides public informational finance data and local simulations only. It does not provide personalized investment advice, execute trades, request brokerage credentials, or promise returns."}}