DocsAPI Reference
Public REST API · Pro plan

API Reference

Fetch your trades, signals, and broker accounts programmatically. Push new trades from your bot or TradingView. Stable v1 surface — we'll never break a working integration without a `/v2` migration path.

Quick start

1

Mint an API key

Open /account → API Keys tab → click Create key. Choose a name (e.g. "TradingView webhook") and scopes (read or read+write). The plaintext key is shown once — store it immediately.

2

Authenticate every request

Send the key in the Authorization: Bearer header on every request. Don't put it in URL params, don't commit it to git, don't ship it in your frontend bundle.

3

Try a request

curl -H "Authorization: Bearer $TJP_API_KEY" \
  https://tradejournalpro.net/api/v1/me

Conventions

  • • Base URL: https://tradejournalpro.net
  • • All responses are JSON.
  • • Success returns { "ok": true, ... }; errors return { "error": "..." } with an HTTP 4xx/5xx code.
  • • Rate limit: 60 requests / minute / key. Exceeding returns 429.
  • • read scope can list and fetch. write scope can create resources.
  • • Timestamps are ISO 8601 UTC. Dates are YYYY-MM-DD.

Endpoints

GET/api/v1/me
read scope

Returns the authenticated user's profile and plan.

Example request

curl -H "Authorization: Bearer $TJP_API_KEY" \
  https://tradejournalpro.net/api/v1/me

Example response

{
  "ok": true,
  "user": {
    "id": "user_2abc...",
    "email": "trader@example.com",
    "plan": "pro",
    "plan_expires_at": "2026-12-31T23:59:59Z"
  }
}
GET/api/v1/trades
read scope

List your trades. Sorted newest first.

Parameters

  • limitint (1-500, default 100)
  • fromISO date
  • toISO date
  • pairstring — e.g. XAUUSD

Example request

curl -H "Authorization: Bearer $TJP_API_KEY" \
  "https://tradejournalpro.net/api/v1/trades?limit=50&pair=XAUUSD"
POST/api/v1/trades
write scope

Create a trade — useful for TradingView webhook integrations or custom bots.

Parameters

  • date*YYYY-MM-DD
  • pair*string (e.g. XAUUSD)
  • direction*BUY | SELL | LONG | SHORT
  • entry_price*number
  • exit_price*number
  • stop_loss*number
  • take_profit*number
  • lot_size*number
  • pnl*number
  • risk_reward*number
  • outcome*WIN | LOSS | BREAKEVEN
  • session*LONDON | NY | ASIA | OTHER
  • strategystring (optional)
  • notesstring (optional)

Example request

curl -X POST \
  -H "Authorization: Bearer $TJP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "date":"2026-05-19", "pair":"XAUUSD", "direction":"BUY",
    "entry_price":2342.50, "exit_price":2355.00,
    "stop_loss":2330.00, "take_profit":2355.00,
    "lot_size":0.10, "pnl":125.00, "risk_reward":1.0,
    "outcome":"WIN", "session":"LONDON"
  }' \
  https://tradejournalpro.net/api/v1/trades
GET/api/v1/signals
read scope

List parsed signals received by your account.

Parameters

  • limitint (1-500, default 100)
  • statusstring — pending, executed, ignored, win_rate_blocked, …
  • pairstring
  • sinceISO timestamp

Example request

curl -H "Authorization: Bearer $TJP_API_KEY" \
  "https://tradejournalpro.net/api/v1/signals?status=executed&limit=20"
GET/api/v1/accounts
read scope

List your broker accounts (MT4/MT5/cTrader cloud + EA + crypto exchanges).

Example request

curl -H "Authorization: Bearer $TJP_API_KEY" \
  https://tradejournalpro.net/api/v1/accounts

Error codes

400Bad request — missing or malformed body
401Missing, malformed, invalid, or revoked API key
402Pro plan required (e.g. write scope, or signal copier endpoints)
403API key doesn't have the required scope
404Resource not found, or doesn't belong to your account
429Rate limit (60/min/key)
500Server error — retry with exponential backoff

Outbound webhooks are coming next.

Right now this is a read+write REST API. Real-time outbound webhooks for new signals / executed trades / closed positions ship next. Email islamahmed9717@gmail.com if you need early access.