Skip to content
API status
API reference

List account metrics

GET
/api/v1/management/servers/{serverId}/account-metrics
curl --request GET \
  --url 'https://api.koneth.com/api/v1/management/servers/6be9a699-2f28-402e-b64e-93ba6bdafe1b/account-metrics?limit=100' \
  --header 'Authorization: <Authorization>' \
  --header 'X-Request-Id: onboarding-client-1042'

Returns available account metric snapshots for a server. Requires metrics:read. This is not a live valuation request and does not include trade or transaction details. Snapshots can be unavailable or delayed. An empty response does not indicate zero risk. Results are bounded and do not include a replay cursor. To request just the latest stored snapshot for one account, set accountNumber and limit=1. This does not request a fresh valuation.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
serverId
required
string format: uuid

UUID of a trading server owned by your organization.

Example
6be9a699-2f28-402e-b64e-93ba6bdafe1b

Header Parameters

Section titled “Header Parameters”
X-Request-Id
string

Optional correlation ID used for API request billing and logs.

Example
onboarding-client-1042

Query Parameters

Section titled “Query Parameters”
accountNumber
string
>= 1 characters <= 32 characters

Filter snapshots to one trading account.

from
string format: date-time

Return snapshots measured at or after this timestamp.

limit
integer
default: 100 >= 1 <= 500

Maximum number of snapshots to return.

Responses

Section titled “Responses”

200

Section titled “200”

Metric snapshots returned in descending measurement order.

Media typeapplication/json
object
snapshots
required
Array<object>
object
id
required
string format: uuid
organizationId
required
string format: uuid
serverId
required
string format: uuid
accountNumber
required
string
eventId
required
string
sequence
required
integer
balance
required
number
equity
required
number
usedMargin
required
number
freeMargin
required
number
marginLevel
One of:
number
unrealizedProfit
required
number
dailyDrawdown
required

Not an authoritative organization drawdown calculation. Calculate rules from the account facts required by your policy.

number
totalDrawdown
required

Not an authoritative organization drawdown calculation. Do not interpret this value alone as proof of zero loss.

number
accountStatus
required
string
measuredAt
required

Source snapshot time. The existing sender rounds it to the minute; it does not certify price freshness or execution time.

string format: date-time
createdAt
required

Date and time the receiving service created the stored snapshot record.

string format: date-time
Examplegenerated
{
  "snapshots": [
    {
      "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "organizationId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "serverId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "accountNumber": "example",
      "eventId": "example",
      "sequence": 1,
      "balance": 1,
      "equity": 1,
      "usedMargin": 1,
      "freeMargin": 1,
      "marginLevel": 1,
      "unrealizedProfit": 1,
      "dailyDrawdown": 1,
      "totalDrawdown": 1,
      "accountStatus": "example",
      "measuredAt": "2026-04-15T12:00:00Z",
      "createdAt": "2026-04-15T12:00:00Z"
    }
  ]
}

400

Section titled “400”

Invalid request.

Media typeapplication/json
object
error
required
string
issues

Validation issue details when the request fails schema validation.

Array<object>
object
key
additional properties
any
Examplegenerated
{
  "error": "example",
  "issues": [
    {}
  ]
}

401

Section titled “401”

Management API authentication is missing or invalid.

Media typeapplication/json
object
error
required
string
issues

Validation issue details when the request fails schema validation.

Array<object>
object
key
additional properties
any
Example
{
  "error": "Management API authentication required"
}

402

Section titled “402”

The organization cannot cover the active API request price.

Media typeapplication/json
object
error
required
string
issues

Validation issue details when the request fails schema validation.

Array<object>
object
key
additional properties
any
Example
{
  "error": "Insufficient API credits"
}

403

Section titled “403”

The key lacks the required scope or server access.

Media typeapplication/json
object
error
required
string
issues

Validation issue details when the request fails schema validation.

Array<object>
object
key
additional properties
any
Example
{
  "error": "Missing API scope: accounts:read"
}

500

Section titled “500”

Unexpected server error.

Media typeapplication/json
object
error
required
string
issues

Validation issue details when the request fails schema validation.

Array<object>
object
key
additional properties
any
Example
{
  "error": "Internal server error"
}