Close position - AP Markets · Partners

POST

/

api

/

v1

/

positions

/

{position}

/

close

Close an open position

curl --request POST \
  --url https://api-trading.ap-markets.com/api/v1/positions/{position}/close \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "login": 104205
}
'

import requests

url = "https://api-trading.ap-markets.com/api/v1/positions/{position}/close"

payload = { "login": 104205 }
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({login: 104205})
};

fetch('https://api-trading.ap-markets.com/api/v1/positions/{position}/close', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{}

{
  "detail": "Invalid request"
}

Send login and optionally volume and comment. Omit volume for a full close; 5000 requests 0.5 lots. The API resolves symbol, direction, price and precision. Keep one Idempotency-Key per intent and confirm execution. See the complete guide. See Volume: lots and MT5 units for conversions and each endpoint’s volume fields.

Authorizations

Authorization

string

header

required

Send the provider-issued token in the Authorization header using Bearer authentication.

Headers

Idempotency-Key

string

required

Persisted key for this intent. Reuse the same key and body when retrying; use a new key for another trading intent, including a modification.

Required string length: 16 - 128

Pattern: ^[A-Za-z0-9._:-]{16,128}$

Example:

"550e8400-e29b-41d4-a716-446655440000"

Path Parameters

position

integer

required

Body

application/json

Verified owner account login.

Example:

123456

volume

integer | null

Optional integer MT5 units, not lots: 10000 = 1 lot independently of contract size. Omit to request the full current position volume; partial execution may leave a remainder.

Required range: x > 0

Example:

100

comment

string

default:REST API close

Maximum string length: 31

Response

Successful Response

The response is of type Response Close Position Api V1 Positions Position Close Post · object.

Close an open position

curl --request POST \
  --url https://api-trading.ap-markets.com/api/v1/positions/{position}/close \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "login": 104205
}
'

import requests

url = "https://api-trading.ap-markets.com/api/v1/positions/{position}/close"

payload = { "login": 104205 }
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({login: 104205})
};

fetch('https://api-trading.ap-markets.com/api/v1/positions/{position}/close', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{}

{
  "detail": "Invalid request"
}