@troystack/sdk

TypeScript SDK for the TroyStack precious metals API.

Install

npm install @troystack/sdk

Quick Start

import { TroyStack } from "@troystack/sdk";

const troy = new TroyStack(); // no key needed for public endpoints

const prices = await troy.spot();
console.log(prices);

For authenticated endpoints, pass your API key:

const troy = new TroyStack("ts_your_api_key");
const brief = await troy.dailyBrief();

Or set the TROYSTACK_API_KEY environment variable.

API Reference

Public Methods (no API key required)

| Method | Description | |---|---| | spot() | Current spot prices for all metals | | priceHistory(metal, range?) | Historical price data. Range: 1d, 1w, 1m, 3m, 1y, 5y | | signal(limit?) | Stack Signal articles (market intelligence) | | signalLatest() | Most recent Stack Signal article | | comex(metal?) | COMEX vault watch data | | junkSilver(coins) | Junk silver melt value calculator | | whatIf(targets) | Speculation / what-if price scenarios | | purchasingPower(metal, ounces) | Current purchasing power of a metal position |

Authenticated Methods (API key required)

| Method | Description | |---|---| | ask(question) | Ask Troy AI a question | | portfolio() | Get your portfolio | | addHolding(holding) | Add a holding to your portfolio | | analytics() | Portfolio analytics and allocation | | dailyBrief() | Personalized daily market brief |

Error Handling

import { TroyStack, TroyStackApiError } from "@troystack/sdk";

try {
  const data = await troy.portfolio();
} catch (err) {
  if (err instanceof TroyStackApiError) {
    console.error(err.status, err.message);
  }
}

Documentation

Full API docs at troystack.com/developers

License

MIT