Accounts

List your accounts, retrieve one, and expand it with equity curve, monthly returns and per-symbol breakdowns.

List accounts

GET /api/v1/accounts

Returns the accounts and portfolios you own, newest first. Private accounts are included — they are yours.

Query parameters

type
string
account or portfolio. Omit for both.
platform
string
MT4, MT5, cTrader or TradeLocker.
page
integer
Defaults to 1.
limit
integer
Defaults to 50, maximum 200.

Response

Response
{
  "data": [
    {
      "type": "account",
      "slug": "dark-algo",
      "name": "Dark Algo (EURUSD) - VT Market",
      "platform": "MT4",
      "currency": "USD",
      "broker": "VT Markets (Pty) Ltd",
      "server": "VTMarkets-Live 4",
      "leverage": 2000,
      "demo": false,
      "published": true,
      "verified": { "identity": false, "track_record": false },
      "balance": 1022.98,
      "equity": 996.96,
      "created_at": "2026-06-21T09:53:58Z",
      "updated_at": "2026-08-22T13:42:48Z",
      "performance": {
        "twr_percent": 5.96,
        "absolute_gain_percent": 5.89,
        "max_drawdown_percent": 0.15,
        "avg_daily_return_percent": 0.11,
        "avg_monthly_return_percent": 3.26,
        "deposits": 1000,
        "withdrawals": 35.91
      },
      "owner": { "slug": "hope-algo-trading", "name": "Hope Algo Trading" }
    }
  ],
  "pagination": { "page": 1, "limit": 50, "total": 1, "has_more": false }
}

Retrieve an account

GET /api/v1/accounts/{slug}

Works for any account you own, and for any account someone has published. A private account that is not yours returns 404 — not 403, because confirming that a private account exists would already leak something.

The account object

type
string
account or portfolio.
slug
string
Stable identifier, same as in the public URL.
name
string
The label the owner chose for the account. Not the name of the account holder at the broker, which this API never returns.
platform
string
MT4, MT5, cTrader or TradeLocker.
currency
string
The account's deposit currency. Every money figure in the response is in this currency.
demo
boolean
Whether this is a demo account.
published
boolean
Whether the account has a public page. Always true for accounts you do not own.
verified
object
identity — the owner proved they control the account. track_record — the history is read directly from the broker rather than self-reported.
balance
number
Closed-trade balance.
equity
number
Balance including the profit or loss of positions still open.
performance
object
Headline figures. See conventions for what twr_percent and absolute_gain_percent each measure, and note max_drawdown_percent is positive.
owner
object
slug and name, where name is the owner's public brand name and is null when they have not set one. Personal names are never returned.

Expanding with include

The account object above is the core. Everything else is opt-in, because the full statistics payload is around 50 KB and most callers want a fraction of it.

GET /api/v1/accounts/dark-algo?include=equity_curve,monthly

Comma-separated, in any order. One request either way — asking for four sections is not four round trips.

equity_curve
Balance and equity over time, plus the dates and amounts of deposits and withdrawals.
twr
Time-weighted return progression — one point per trade.
monthly
Return per month and per year, the same grid as the public page's monthly table.
by_symbol
Results broken down per instrument: trades, win rate, profit.
by_magic_number
The same breakdown per magic number, which on MT4 and MT5 usually means per strategy.
advanced
Expectancy, profit factor, Z-score, average win and loss, longs versus shorts, and the rest of the advanced statistics.
The owner of an account can hide sections of it. When a section is hidden, include returns it as null rather than failing the request — so ask for what you need and handle null.

Reading someone else's account

Nothing special is required: pass the public slug to the same endpoint. Your key needs the public:read scope, which every key has by default.

curl https://showmytrades.com/api/v1/accounts/dark-algo \
  -H "Authorization: Bearer smt_live_YOUR_KEY"

You get the same shape, minus anything the owner has chosen to hide.