Close a position

POST

/api/v1/management/servers/{serverId}/accounts/{accountNumber}/positions/{positionId}/close

curl --request POST \
  --url https://api.koneth.com/api/v1/management/servers/6be9a699-2f28-402e-b64e-93ba6bdafe1b/accounts/7001042/positions/1f4d3c2b-0a19-4c8e-9f21-8b7c6d5e4f30/close \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: account-create-client-1042' \
  --header 'X-Request-Id: onboarding-client-1042' \
  --data '{ "volume": 0.25, "requestId": "close-position-client-1042" }'

• Production
• Local development

Closes an open position in full, or partially when volume is smaller than the position volume. Requires positions:write.

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

positionId

required

string

>= 1 characters <= 100 characters

Identifier of an open position on the account.

Example

1f4d3c2b-0a19-4c8e-9f21-8b7c6d5e4f30

Header Parameters

Idempotency-Key

required

string

>= 1 characters <= 100 characters

Unique key for this logical mutation. Reuse it only when retrying the same operation. Maximum 100 characters.

Example

account-create-client-1042

X-Request-Id

string

Optional correlation ID used for API request billing and logs.

Example

onboarding-client-1042

Request Body^required

Media typeapplication/json

object

volume

Partial volume to close. Omit to close the whole position.

number

> 0

requestId

required

string

>= 1 characters <= 100 characters

Example

{
  "volume": 0.25,
  "requestId": "close-position-client-1042"
}

Responses

200

An earlier command was returned for the idempotency key.

Media typeapplication/json

object

command

required

object

id

required

string format: uuid

operation

required

string

Allowed values: account.create account.update account.enable account.disable account.archive account.password_reset account.investor_password_reset account.history_export finance.deposit finance.withdraw trade.open trade.cancel trade.modify position.close position.modify position.close_all

status

required

string

Allowed values: queued leased succeeded failed expired

managedAccountId

One of:

string

string format: uuid

null

null

attempts

required

integer

payload

object

key

additional properties

any

result

One of:

object

object

key

additional properties

any

null

null

errorCode

One of:

string

string

null

null

errorMessage

One of:

string

string

null

null

idempotencyKey

required

string

createdAt

required

string format: date-time

completedAt

One of:

string

string format: date-time

null

null

key

additional properties

any

duplicate

required

boolean

Example

{
  "command": {
    "operation": "account.create",
    "status": "queued"
  }
}

202

Operation queued.

Media typeapplication/json

object

command

required

object

id

required

string format: uuid

operation

required

string

Allowed values: account.create account.update account.enable account.disable account.archive account.password_reset account.investor_password_reset account.history_export finance.deposit finance.withdraw trade.open trade.cancel trade.modify position.close position.modify position.close_all

status

required

string

Allowed values: queued leased succeeded failed expired

managedAccountId

One of:

string

string format: uuid

null

null

attempts

required

integer

payload

object

key

additional properties

any

result

One of:

object

object

key

additional properties

any

null

null

errorCode

One of:

string

string

null

null

errorMessage

One of:

string

string

null

null

idempotencyKey

required

string

createdAt

required

string format: date-time

completedAt

One of:

string

string format: date-time

null

null

key

additional properties

any

duplicate

required

boolean

Example

{
  "command": {
    "operation": "account.create",
    "status": "queued"
  }
}

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

409

The request conflicts with the current resource state.

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