بستن موقعیت تعهدی

درصورتی که قصد بستن موقعیت تعهدی خود در قیمت مشخص را دارید میتوانید از API زیر استفاده کنید.
به یاد داشته باشید که به منظور این کار باید id موقعیت تعهدی که در زمان ساخت دریافت کردید را به عنوان Path-Variable ارسال کنید

curl -i -X PATCH \
  'https://api.wallex.ir/margin-trade/v1/positions/{id}/close' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -d '{
    "price": "string"
  }'

Response

application/json

{
  "call_price": "string",
  "close_filled_price": "string",
  "close_price": "string",
  "close_reason": "string",
  "closed_at": "string",
  "collateral": {
    "currency": "string",
    "value": "string"
  },
  "created_at": "string",
  "expires_at": "string",
  "extend_time": 0,
  "first_order_filled": true,
  "id": "string",
  "interest": {
    "currency": "string",
    "value": "string"
  },
  "is_called": true,
  "liquidity_price": "string",
  "loan": {
    "currency": "string",
    "value": "string"
  },
  "market": "string",
  "max_age": 0,
  "open_filled_price": "string",
  "open_price": "string",
  "opened_at": "string",
  "profit": {
    "currency": "string",
    "value": "string"
  },
  "profit_percentage": "string",
  "risk_coef": "string",
  "side": "string",
  "state": "string",
  "stop_loss": "string",
  "take_profit": "string",
  "updated_at": "string"
}

توضیحات Request-Body

برای فراخوانی این API باید اطلاعات زیر را به‌صورت JSON در Request-Body ارسال کنید:

Example

"82494"

Data Type

String

Required or Optional

Required

Definition

قیمت واحدی که قصد دارید موقعیت تعهدی خود را ببندید

توضیحات Path-Variable

برای فراخوانی این API باید ID موقعیت تعهدی خود را در Path-Variable ارسال کنید

Example

"10"

Data Type

number

Required or Optional

Required

Definition

هر موقعیت تعهدی یک ID یکتا دارد که برای بستن موقعیت تعهدی باید در این API ارسال شود.

توضیحات Response-Body


{
    "result": {
    "call_price": "حد هشدار",
    "close_filled_price": "قیمت بسته سفارش",
    "close_price": "قیمت بسته شدن",
    "close_reason": "علت بستن",
    "closed_at": "زمان بسته شدن",
    "collateral": {
      "currency": " ارز",
      "value": "ارزش وثیقه",
    "created_at":" زمان ساختن سفارش",
    "expires_at":"تاریخ منقضی شدن",
    "extend_time":"زمان تمدید",
    "first_order_filled":" اولین سفارش انجام شده",
    "id":" ایدی سفارش",
    "interest": {
      "currency": "ارز",
      "value": "ارزش کارمزد"
    },
    "is_called":"به حد هشدار رسیده است یا خیر",
    "liquidity_price": "قیمت لیکوییدیتی",
  "loan": { 
    "currency": "ارز",
    "value": " ارزش وام"
    },
    "market": "نام جفت ارز",
    "max_age":"حداکثر عمرموقعیت",
    "open_filled_price":"قیمت باز شدن سفارش",
    "open_price": "قیمت واحد",
    "opened_at":"زمانی که موقعیت ایجاد شده",
    "profit": {
      "currency": "ارز",
      "value": "ارزش سود و ضرر"
    },
    "profit_percentage": "درصد سود و ضرر",
    "risk_coef": "میزان اعتبار",
    "side": "لانگ / شورت",
    "state": "وضعیت سفارش",
    "stop_loss": "حد ضرر",
    "take_profit": "حد سود",
    "updated_at": "نمایش دهنده زمان بروزرسانی وثیقه یا حد سود و ضرر"
    },
  "success": "موفقیت آمیز بودن درخواست"
}
}