List account deals

GET

/api/v1/management/servers/{serverId}/accounts/{accountNumber}/deals

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

• Production
• Local development

Returns a newest-first page of executions for one trading account. Use deals to inspect each entry, exit, and partial-close timestamp. Requires accounts:read.

Authorizations

• managementKey

Parameters

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

X-Request-Id

string

Optional correlation ID used for API request billing and logs.

Example

onboarding-client-1042

Query Parameters

page

integer

default: 1 >= 1

One-based page number.

limit

integer

default: 20 >= 1 <= 100

Maximum records returned on one page.

Responses

200

Deal page returned.

Media typeapplication/json

object

deals

required

Array<object>

An individual execution, including an entry, exit, or partial close.

object

id

string

orderId

string

positionId

string

symbol

string

side

string

kind

string

volume

number

price

number

commission

number

realizedPnl

number

swap

number

executedAt

Date and time this execution occurred; preserved independently for every partial close.

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

Example^generated

{
  "deals": [
    {
      "id": "example",
      "orderId": "example",
      "positionId": "example",
      "symbol": "example",
      "side": "example",
      "kind": "example",
      "volume": 1,
      "price": 1,
      "commission": 1,
      "realizedPnl": 1,
      "swap": 1,
      "executedAt": "2026-04-15T12:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 1,
    "total": 1,
    "totalPages": 1
  }
}

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

Example^generated

{
  "error": "example",
  "issues": [
    {}
  ]
}

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

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

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

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

Example^generated

{
  "error": "example",
  "issues": [
    {}
  ]
}

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