{"openapi":"3.0.3","info":{"title":"TroyStack API","version":"1.0.0","description":"AI-powered precious metals portfolio tracking and market intelligence. Live spot prices, COMEX vault data, Stack Signal editorial, and junk silver melt value tools.","contact":{"url":"https://troystack.com","email":"support@troystack.com"}},"servers":[{"url":"https://api.troystack.ai"}],"paths":{"/v1/prices":{"get":{"summary":"Get live spot prices","description":"Returns current spot prices for gold, silver, platinum, and palladium with daily change percentages.","operationId":"getPrices","tags":["Prices"],"responses":{"200":{"description":"Live spot prices for all 4 metals"}}}},"/v1/prices/history":{"get":{"summary":"Get historical prices","operationId":"getPriceHistory","tags":["Prices"],"parameters":[{"name":"metal","in":"query","schema":{"type":"string","enum":["gold","silver","platinum","palladium"]},"required":true},{"name":"range","in":"query","schema":{"type":"string","enum":["1M","3M","6M","1Y","5Y","ALL"]}}],"responses":{"200":{"description":"Historical price data"}}}},"/v1/stack-signal":{"get":{"summary":"Get Stack Signal articles","description":"Returns curated Stack Signal precious metals intelligence articles with Troy's commentary.","operationId":"getStackSignal","tags":["Stack Signal"],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":20,"minimum":1,"maximum":50}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}},{"name":"category","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Stack Signal articles with Troy commentary and source references"}}}},"/v1/stack-signal/latest":{"get":{"summary":"Get latest Stack Signal synthesis","description":"Returns the most recent Stack Signal daily synthesis editorial.","operationId":"getStackSignalLatest","tags":["Stack Signal"],"responses":{"200":{"description":"Latest daily synthesis article"}}}},"/v1/market-intel":{"get":{"summary":"Get market intelligence","description":"Returns latest precious metals news headlines with AI analysis and category tags.","operationId":"getMarketIntel","tags":["Market Intelligence"],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":20}},{"name":"category","in":"query","schema":{"type":"string","enum":["BREAKING","SUPPLY_DEMAND","CENTRAL_BANK","POLICY","MINING","INVESTMENT","GEOPOLITICAL","ANALYSIS"]}}],"responses":{"200":{"description":"Market intelligence articles"}}}},"/v1/vault-watch":{"get":{"summary":"Get COMEX vault data","description":"Returns real-time COMEX warehouse inventory including registered, eligible ounces, daily drains, and oversubscribed ratios.","operationId":"getVaultWatch","tags":["Vault Watch"],"parameters":[{"name":"metal","in":"query","schema":{"type":"string","enum":["gold","silver","platinum","palladium"],"default":"silver"}}],"responses":{"200":{"description":"COMEX warehouse inventory data"}}}},"/v1/junk-silver":{"get":{"summary":"Junk silver melt value calculator","description":"Calculates silver melt value for pre-1965 US coinage. All quantity params are optional non-negative integers.","operationId":"getJunkSilver","tags":["Tools"],"parameters":[{"name":"dimes","in":"query","schema":{"type":"integer","minimum":0},"description":"Roosevelt/Mercury dimes (0.07234 oz Ag each)"},{"name":"quarters","in":"query","schema":{"type":"integer","minimum":0},"description":"Washington quarters (0.18084 oz Ag each)"},{"name":"half_dollars","in":"query","schema":{"type":"integer","minimum":0},"description":"Walking Liberty/Franklin/Kennedy 1964 half dollars (0.36169 oz Ag each)"},{"name":"kennedy_40","in":"query","schema":{"type":"integer","minimum":0},"description":"Kennedy 1965-1970 40% silver halves (0.14792 oz Ag each)"},{"name":"dollars","in":"query","schema":{"type":"integer","minimum":0},"description":"Morgan/Peace dollars (0.77344 oz Ag each)"},{"name":"war_nickels","in":"query","schema":{"type":"integer","minimum":0},"description":"Jefferson 1942-1945 war nickels (0.05626 oz Ag each)"}],"responses":{"200":{"description":"Melt value breakdown by coin type + totals"}}}},"/v1/speculation":{"get":{"summary":"What-if price projections","description":"Calculate projected portfolio value at hypothetical future metal prices.","operationId":"getSpeculation","tags":["Tools"],"parameters":[{"name":"silver","in":"query","schema":{"type":"number"},"description":"Target silver price per oz"},{"name":"gold","in":"query","schema":{"type":"number"},"description":"Target gold price per oz"},{"name":"platinum","in":"query","schema":{"type":"number"}},{"name":"palladium","in":"query","schema":{"type":"number"}}],"responses":{"200":{"description":"Price projections with multipliers"}}}},"/v1/portfolio":{"get":{"summary":"Get portfolio summary","description":"Returns authenticated user's portfolio with live valuation, cost basis, and unrealized P/L.","operationId":"getPortfolio","tags":["Portfolio"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Portfolio summary"},"401":{"description":"Authentication required"}}}},"/v1/holdings":{"get":{"summary":"List holdings","operationId":"getHoldings","tags":["Portfolio"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"List of holdings"}}},"post":{"summary":"Add a purchase","operationId":"addHolding","tags":["Portfolio"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["metal","quantity","weight_oz","purchase_price"],"properties":{"metal":{"type":"string","enum":["gold","silver","platinum","palladium"]},"product_name":{"type":"string","example":"2024 American Silver Eagle"},"quantity":{"type":"integer","example":20},"weight_oz":{"type":"number","example":1},"purchase_price":{"type":"number","example":35.5,"description":"Price per unit"},"dealer":{"type":"string","example":"APMEX"},"purchase_date":{"type":"string","format":"date","example":"2024-11-21"}}}}}},"responses":{"201":{"description":"Holding created"}}}},"/v1/analytics":{"get":{"summary":"Portfolio analytics","description":"Cost basis, break-even analysis, and allocation per metal.","operationId":"getAnalytics","tags":["Portfolio"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Analytics data"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key from TroyStack app"}}}}