TradersForge API

A simple, read-only REST API for your own trades and analytics. Pull your data into spreadsheets, dashboards, backtests, or custom tools. Available on the Elite plan.

Authentication

Generate a key in Settings → API Keys (Elite only). The secret is shown once — store it securely. Send it as a Bearer token on every request:

curl https://app.tradersforge.net/api/v1/me \
  -H "Authorization: Bearer tf_live_your_key_here"

Base URL: https://app.tradersforge.net/api/v1

Rate limits

120 requests per minute, per key. Exceeding it returns 429 Too Many Requests — back off and retry.

Endpoints

All responses are JSON wrapped in a data field. All endpoints are read-only (GET) and scoped to your own account.

GET/v1/me

Your account id and plan. Use it to verify a key works.

GET/v1/trades

List your trades, newest first.

Query params: limit (1–200, default 50), offset, symbol, status (open|closed), account_id, from, to (ISO timestamps).

curl "https://app.tradersforge.net/api/v1/trades?status=closed&limit=100" \
  -H "Authorization: Bearer tf_live_your_key_here"

GET/v1/trades/:id

Fetch a single trade by id.

GET/v1/accounts

List your trading accounts (manual + broker-synced).

GET/v1/stats

Summary performance over your closed trades: win rate, net P&L, profit factor, avg win/loss. Accepts from/to.

Errors

Status	Meaning
401	Missing, invalid, or revoked key.
403	Key owner is not on the Elite plan.
404	Resource not found (or not yours).
429	Rate limit exceeded (120/min).
500	Something went wrong on our end.

Errors return { "error": "message" }. Need a scope or endpoint we don't offer yet? Tell us.