# Close

**POST /auth/close**

Close a position. Requires a signed payload in HMAC form to be appended to the x-signature header. The signed payload must be base64-encoded.

Javascript example:

  ```
  const formurlencoded = require('form-urlencoded').default;
  const crypto = require("crypto-js");
  const fetch = require("node-fetch");
  const API_KEY = "<YOUR_API_KEY>";
  const SECRET_KEY = "<YOUR_SECRET_KEY>";

  (async function() {
    const payload = {pair: 'USD_BTCCALL_PERP', qty: 100, price: 100, timestamp: Date.now()};
    const payload_url_encoded = formurlencoded(payload);
    const HMAC = crypto.HmacSHA256(payload_url_encoded, SECRET_KEY).toString(crypto.enc.Base64);
    const submitted = await fetch('https://api.testnet.everstrike.io/auth/close', {method: 'POST', body: payload_url_encoded, headers: {'content-type': 'application/x-www-form-urlencoded', 'x-api-key': API_KEY, 'x-signature': HMAC}});
    const response = await submitted.json();
    console.log(response);
  })();
  ```

Python example (Python3):

  ```
  import requests
  import urllib
  import hmac
  import hashlib
  import base64
  from time import time

  api_key = '<YOUR_API_KEY>'
  secret_key = '<YOUR_SECRET_KEY>'
  url='https://api.testnet.everstrike.io/auth/close'
  payload = {'pair': 'USD_BTCCALL_PERP', 'qty': 0.001, 'price': 1, 'timestamp': time()*1000.0}
  urlencoded_payload = urllib.parse.urlencode(payload)
  hmac_signature = hmac.new(bytes(secret_key , 'utf-8'), msg = bytes(urlencoded_payload , 'utf-8'), digestmod = hashlib.sha256).digest()
  hmac_signature_base64 = base64.b64encode(hmac_signature)
  headers = {'content-type': 'application/x-www-form-urlencoded', 'x-api-key': api_key, 'x-signature': hmac_signature_base64}

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

  print(response.text)
  print(response.status_code, response.reason)

  ```



## Servers
- https://api.testnet.everstrike.io: https://api.testnet.everstrike.io ()


## Authentication methods
- Api key
- Hmac signature


## Parameters



### Body: application/x-www-form-urlencoded (object)

- **pair** (string)
  Market of position (e.g. "USD_BTCCALL_PERP")
- **qty** (integer(int32))
  Quantity to close. To close the entire position, exclude this field.
- **price** (integer(int32))
  The price to close the position at. To close at market, exclude this field.
- **trigger_price** (integer(int32))
  The stop price to close the position at. To submit the close immediately, exclude this field.
- **trigger_event** (string)
  The price event that triggers the stop. Can be either MARK_PRICE, INDEX_PRICE or LAST_PRICE. The default is MARK_PRICE.
- **close_on_trigger** (boolean)
  Whether to submit the close order as a Close on Trigger order. Close on Trigger orders cancel open reduce-only orders upon being triggered in an attempt to free up margin, making them less likely to fail due to an insufficient balance.
- **timestamp** (integer(int32))
  UNIX timestamp in milliseconds. As trading is all about timing, orders that reach the API 15 seconds or more after this timestamp will be rejected.
- **recv_window** (integer(int32))
  A custom time window. Order is accepted if timestamp + recv_window <= now


## Responses
### 200
OK

#### Body: application/json (object)
- **code** (integer)
  Response code
- **msg** (string)
  Diagnostic message
- **result** (object)
  Request result

### 503
Error

#### Body: application/json (object)
- **code** (integer)

- **msg** (string)

- **result** (object)



[Powered by Bump.sh](https://bump.sh)