API Reference

Build on TradeStance.

Everything in the platform runs on a public REST API — 100+ endpoints covering landed-cost calculation, price signals, commodity forecasts, portfolio positions, and live WebSocket ticker. The full OpenAPI spec is coming in June 2026.

Public beta — reach out for early access

What you can build against today

Landed cost calculator

POST /calculate

Product + destination → full landed price breakdown with customs, freight, financing.

Price signals

POST /price-signal

Compare current landed cost vs 30-day average. Returns BUY / HOLD / AVOID signal.

Commodity forecasts

GET /forecast/:hs

30-day DIA-LSTM forecast with uncertainty bands, per HS code.

Risk alerts

GET /alerts

Scored news alerts from commodity + shipping beats, filtered to your watchlist.

Portfolio + trades

GET /portfolio, /trades

Positions, P&L, and trade history. Writes via POST /trades.

WebSocket ticker

WSS /ws

Live commodity prices, signal changes, and risk pings over the TradePulse-WS v1.1 protocol.

Billing + subscriptions

GET /billing/*

Plans, subscriptions, and usage status per product.

IAM + entitlements

GET /iam/*

Products, entitlements, roles, and permission checks.

Getting started

1. Get an API key

During beta, email api@tradestance.com with your use case. We'll provision a scoped key keyed to your org.

2. Authenticate

All requests use bearer-token auth against https://api.tradestance.com:

curl https://api.tradestance.com/calculate \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "content-type: application/json" \
  -d '{"product_name":"Pistachios","destination":"US"}'

3. Subscribe to events

Connect the WebSocket ticker for live price + signal updates. Webhook subscriptions (order events, price thresholds) land in the next quarter.

Want the full spec?

OpenAPI 3 spec + Postman collection + typed SDKs for TypeScript, Python, and Go drop in June. Join the waitlist to get early access.