Appearance
Place Order
POST
/v1/perps/orders/simple
Open a new perps trade or increase an existing one.
On open, leverage is required. When increasing an existing trade, omit leverage,
takeProfitPrice and stopLossPrice. amount is the margin in USDC and must be at least
the pair's minMarginAmount (currently 2 USDC), in increments of 0.01.
In the response, amountToReturn is the portion of submitted margin not needed by the
position, returned to your VALR spot balance automatically. The position may be null or
delayed in some cases — use GET /v1/perps/positions to confirm.
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
{
"pair": "BTCUSDC",
"side": "BUY",
"amount": "5",
"leverage": 5,
"takeProfitPrice": "90000",
"stopLossPrice": "70000",
"payCurrencySymbol": "USDC"
}
Responses
Order placed successfully
application/json