Set Leverage

Set leverage for a futures pair on PointPay Exchange.

Details

POST https://api.pointpay.io/fapi/v1/private/trade/leverage

Headers

Name	Type	Description
X-TXC-APIKEY*	STRING	Public API key
X-TXC-PAYLOAD*	STRING	Base64-encoded request body
X-TXC-SIGNATURE*	STRING	HmacSHA512 signature of the request body

Request Body

Name	Type	Description	Example
symbol*	STRING	Trading pair	BTCUSDT
leverage*	NUMERIC	Leverage value	10

Fields marked with * are required.

CURL Example

curl -X POST "https://api.pointpay.io/fapi/v1/private/trade/leverage" \
  -H "accept: application/json" \
  -H "X-TXC-APIKEY: <api-key>" \
  -H "X-TXC-PAYLOAD: <base64-payload>" \
  -H "X-TXC-SIGNATURE: <signature>" \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "BTCUSDT",
    "leverage": 10
  }'

200: OK Successful

Response parameters:

Name	Type	Description
leverage	STRING	Applied leverage

Response example:

{
    "notification": null,
    "warning": null,
    "variables": null,
    "status": "000000",
    "response": {
        "leverage": "25"
    },
    "errors": null
}

400: Bad Request

Response example

{
    "code": 400,
    "success": false,
    "message": "invalid input",
    "result": []
}

Returned when the request is invalid.

Common reasons:

• Invalid request format

• Invalid headers

401: Unauthorized

Response example

{"code":400,"success":false,"message":"authentication failure","result":[]}

Returned when authentication headers are missing / invalid or API Keys are not enabled.