Skip to content
API status
API reference

List account positions

GET
/api/v1/management/servers/{serverId}/accounts/{accountNumber}/positions
curl --request GET \
  --url 'https://api.koneth.com/api/v1/management/servers/6be9a699-2f28-402e-b64e-93ba6bdafe1b/accounts/7001042/positions?page=1&limit=20&status=all' \
  --header 'Authorization: <Authorization>' \
  --header 'X-Request-Id: onboarding-client-1042'

Returns a newest-first page of open and closed positions for one trading account. Each record includes its opening time and final closing time when fully closed. Use status=open&limit=1 to confirm whether any open position remains before ending a live-metrics subscription. Requires accounts:read.

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
accountNumber
required
string
>= 4 characters <= 32 characters /^[A-Za-z0-9_-]+$/

Trading account number.

Example
7001042

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”
page
integer
default: 1 >= 1

One-based page number.

limit
integer
default: 20 >= 1 <= 100

Maximum records returned on one page.

status
string
default: all
Allowed values: all open closed

Filter positions by lifecycle status.

Responses

Section titled “Responses”

200

Section titled “200”

Position page returned.

Media typeapplication/json
object
positions
required
Array<object>

Position record. Use linked deals for the execution time of each partial close.

object
id
string
orderId
string
symbol
string
side
string
volume
number
openPrice
number
status
string
openedAt

Date and time the position opened.

string format: date-time
closedAt
One of:
string format: date-time
key
additional properties
any
pagination
required
object
page
required
integer
>= 1
limit
required
integer
>= 1 <= 100
total
required
integer
totalPages
required
integer
Examplegenerated
{
  "positions": [
    {
      "id": "example",
      "orderId": "example",
      "symbol": "example",
      "side": "example",
      "volume": 1,
      "openPrice": 1,
      "status": "example",
      "openedAt": "2026-04-15T12:00:00Z",
      "closedAt": "2026-04-15T12:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 1,
    "total": 1,
    "totalPages": 1
  }
}

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"
}

404

Section titled “404”

The requested resource was not found.

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": [
    {}
  ]
}

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"
}