API Docs

Appearance

Place stop limit order​

POST
/v1/orders/stop/limit

Create a new Stop Loss Limit or Take Profit Limit order.

When the response is 202 Accepted, you can either use the Order Status REST API or WebSocket API to receive updates about this order.

Parameter Description
side (required) BUY or SELL
quantity (required) Amount in Base Currency must be provided.
price (required) The Limit Price at which the BUY or SELL order will be placed.
pair (required) Can be any supported currency pair.
stopPrice (required) The target price for the trade to trigger. Cannot be equal to last traded price.
type (required) Can be TAKE_PROFIT_LIMIT or STOP_LOSS_LIMIT.
customerOrderId (optional) Alphanumeric value. Must be unique across all open orders.
timeInForce (optional) Can be GTC, FOK or IOC. Default value is GTC.

Stop limit order support varies by currency pair. Use GET /v1/public/{pair}/ordertypes to verify support.

V1 order endpoints return 202 Accepted. Validation errors are delivered asynchronously via WebSocket. Use the Order Status REST API or WebSocket API to receive the status of this order.

  • customerOrderId:
    Supports alphanumeric characters and dashes ("-"), with a 50-character limit. Must be unique across all open orders for a given account.

  • timeInForce:
    Defines how long an order remains active:

    • GTC (Good Till Cancelled): Remains active until fully filled or explicitly cancelled.
    • FOK (Fill or Kill): Must be fully filled immediately or cancelled entirely.
    • IOC (Immediate or Cancel): Fills as much as possible immediately; any unfilled portion is cancelled.

  • allowMargin:
    Set to true for margin/leverage trades. Only subaccounts can trade on margin, and each must be enabled individually via the account/status API.

Authorizations​

apiKey

Your API key

Type
API Key (header: X-VALR-API-KEY)
+
apiSignature

HMAC SHA512 signature of the request (see Authentication section)

Type
API Key (header: X-VALR-SIGNATURE)
+
apiTimestamp

Request timestamp in milliseconds

Type
API Key (header: X-VALR-TIMESTAMP)

Request Body​

application/json
JSON
{
"side": "BUY",
"quantity": "0.00016",
"price": "645055",
"pair": "BTCUSDT",
"customerOrderId": "556789",
"timeInForce": "GTC",
"stopPrice": "36000",
"type": "STOP_LOSS_LIMIT"
}

Responses​

Stop limit order accepted

application/json
JSON
{
"id": "0198176c-df21-794a-99bc-ea7683efe371",
"customerOrderId": "556789"
}

Playground​

Authorization
Body

Samples​