Accounts

Read the authenticated user’s accounts and related payout information.

List accounts

GET /api/v1/accounts

Scope: accounts:read

Query parameters

Parameter	Description
`includeMetrics`	When `true`, attaches per-account metrics from `computeMetricsForAccounts`

Example

curl "https://www.deltalytix.app/api/v1/accounts?includeMetrics=true" \
  -H "Authorization: Bearer dltx_at_…"

const res = await fetch(
  "https://www.deltalytix.app/api/v1/accounts?includeMetrics=true",
  {
    headers: { Authorization: `Bearer ${accessToken}` },
  },
);
const payload = await res.json();

Response `200`

{
  "data": [
    {
      "id": "acc_01HZX…",
      "accountNumber": "SIM-001",
      "name": "Evaluation A",
      "payouts": [
        {
          "id": "pay_01HZX…",
          "amount": 2500,
          "date": "2026-02-01T00:00:00.000Z",
          "status": "paid"
        }
      ],
      "metrics": {
        "balance": 52480.12,
        "drawdown": 3.4,
        "consistency": 0.82,
        "progress": 0.61
      }
    }
  ],
  "nextCursor": null
}

metrics is present only when includeMetrics=true. Metric fields include balance, drawdown, consistency, and progress toward account targets.

For portfolio-level analytics across all accounts, prefer the Metrics endpoints.

List accounts

GET /api/v1/accounts

Scope: accounts:read

Parameter

Description

includeMetrics

When true, attaches per-account metrics from computeMetricsForAccounts

curl "https://www.deltalytix.app/api/v1/accounts?includeMetrics=true" \
  -H "Authorization: Bearer dltx_at_…"

const res = await fetch(
  "https://www.deltalytix.app/api/v1/accounts?includeMetrics=true",
  {
    headers: { Authorization: `Bearer ${accessToken}` },
  },
);
const payload = await res.json();

{
  "data": [
    {
      "id": "acc_01HZX…",
      "accountNumber": "SIM-001",
      "name": "Evaluation A",
      "payouts": [
        {
          "id": "pay_01HZX…",
          "amount": 2500,
          "date": "2026-02-01T00:00:00.000Z",
          "status": "paid"
        }
      ],
      "metrics": {
        "balance": 52480.12,
        "drawdown": 3.4,
        "consistency": 0.82,
        "progress": 0.61
      }
    }
  ],
  "nextCursor": null
}

metrics is present only when includeMetrics=true. Metric fields include balance, drawdown, consistency, and progress toward account targets.

For portfolio-level analytics across all accounts, prefer the Metrics endpoints.