{"name":"TroyStack API","version":"1.0.0","description":"Precious metals portfolio tracking, live spot prices, COMEX vault data, and market intelligence.","documentation":"https://api.troystack.ai/docs","endpoints":{"public":{"GET /v1/prices":"Live spot prices for Au, Ag, Pt, Pd","GET /v1/prices/history?metal=silver&range=1M":"Historical price data","GET /v1/market-intel":"Latest precious metals news and analysis","GET /v1/vault-watch":"COMEX warehouse inventory data","GET /v1/speculation?silver=1000&gold=25000":"What-if price projections"},"authenticated":{"GET /v1/portfolio":"User portfolio summary with live valuation","GET /v1/analytics":"Cost basis, break-even, allocation analysis","POST /v1/holdings":"Add a purchase to portfolio","GET /v1/holdings":"List all holdings"},"intelligence":{"POST /v1/intelligence/generate":"Trigger intelligence generation (API key required)","GET /v1/daily-brief?userId=xxx":"Get today's daily brief for a user","POST /v1/daily-brief/generate":"Generate daily brief for a user","POST /v1/advisor/chat":"AI Stack Advisor chat","POST /v1/scan-receipt":"Scan receipt image for holdings data"},"push":{"POST /v1/push/register":"Register Expo push token","DELETE /v1/push/delete":"Remove push token","POST /v1/push/price-alerts":"Create price alert","GET /v1/push/price-alerts":"Get price alerts"},"billing":{"POST /v1/stripe/create-checkout-session":"Create Stripe checkout","POST /v1/stripe/verify-session":"Verify checkout session","POST /v1/webhooks/stripe":"Stripe webhook"},"social":{"POST /v1/stack-signal/articles/:id/view":"Record article view","POST /v1/stack-signal/articles/:id/like":"Toggle like (userId required)","GET /v1/stack-signal/articles/:id/likes":"Get like count + user_liked","POST /v1/stack-signal/articles/:id/comments":"Post comment (userId required)","GET /v1/stack-signal/articles/:id/comments":"List comments"},"dealer_prices":{"GET /v1/dealer-prices?metal=&weight=":"Compare dealer prices for a product","GET /v1/dealer-prices/products":"List tracked products","POST /v1/dealer-prices/click":"Log affiliate click"},"llm":{"GET /llms.txt":"LLM-readable app description","GET /openapi.json":"OpenAPI 3.0 specification","GET /.well-known/ai-plugin.json":"AI plugin manifest","GET /.well-known/mcp.json":"MCP server manifest"}},"authentication":{"type":"Bearer token","header":"Authorization: Bearer YOUR_API_KEY","signup":"Generate API keys in TroyStack app → Settings → Developer Access"}}