# TroyStack

## Overview
TroyStack is an AI-powered precious metals portfolio tracking and market intelligence platform. It helps investors track their gold, silver, platinum, and palladium holdings with live spot prices, AI-curated Stack Signal market analysis, institutional-grade COMEX vault data, and junk silver melt value tools.

## API
Base URL: https://api.troystack.ai

### Public Endpoints (no auth required)
- GET /v1/prices — Live spot prices for Au, Ag, Pt, Pd with daily change percentages
- GET /v1/prices/history?metal=silver&range=1Y — Historical price data (1M, 3M, 6M, 1Y, 5Y, ALL)
- GET /v1/stack-signal — Latest Stack Signal market intelligence articles (Troy's curated precious metals analysis)
- GET /v1/stack-signal/latest — Most recent Stack Signal daily synthesis editorial
- GET /v1/market-intel — Latest precious metals news headlines
- GET /v1/vault-watch?metal=silver — COMEX warehouse inventory (registered, eligible, oversubscribed ratio)
- GET /v1/vault-watch/history?metal=silver&days=30 — Vault drain history
- GET /v1/junk-silver?dimes=50&quarters=40 — Pre-1965 US coin melt value calculator
- GET /v1/speculation?silver=1000&gold=25000 — What-if price scenario projections

### Authenticated Endpoints (Bearer token required)
- GET /v1/portfolio — User's portfolio summary with live valuation and unrealized P/L
- GET /v1/analytics — Cost basis, break-even, allocation analysis per metal
- GET /v1/holdings — List all holdings with purchase details
- POST /v1/holdings — Add a new purchase (metal, quantity, weight_oz, purchase_price)

### Authentication
API keys are generated in the TroyStack iOS app under Settings → Developer Access.
Include as: Authorization: Bearer YOUR_API_KEY

## MCP Server
TroyStack is available as an MCP (Model Context Protocol) tool server.
Manifest: https://api.troystack.ai/.well-known/mcp.json

## Use Cases
- Check current gold and silver prices
- Read Troy's Stack Signal market intelligence and daily editorials
- Get COMEX vault inventory and silver squeeze data
- Calculate melt value of pre-1965 US junk silver coins
- Track a precious metals portfolio programmatically
- Analyze cost basis and break-even prices
- Run what-if scenarios for future metal prices

## Links
- Website: https://troystack.com
- App Store: https://apps.apple.com/app/troystack/id6738029817
- API Docs: https://api.troystack.ai
- Contact: support@troystack.com