List account transactions

GET

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

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

• Production
• Local development

Returns a newest-first page of ledger transactions for one trading account. Deposit and withdrawal records include the date and time they were recorded. 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

Transaction page returned.

Media typeapplication/json

object

transactions

required

Array<object>

object

referenceId

string

type

string

Allowed values: initial_balance deposit withdrawal trade_profit trade_loss commission swap manual_adjustment

amount

number

balanceBefore

number

balanceAfter

number

currency

string

status

string

Allowed values: completed pending failed reversed

description

One of:

string

string

null

null

createdAt

Date and time this ledger entry was recorded, including deposits and withdrawals. Not external payment settlement or webhook delivery time.

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

{
  "transactions": [
    {
      "type": "initial_balance",
      "status": "completed"
    }
  ]
}

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