buy

Place a buy order in an instrument. (Authorization is required)
URI: https://www.deribit.com/api/v1/private/buy
URI Path: /api/v1/private/buy
Parameters: shown as JQuery data for POST
{
    "instrument": "BTC-19DEC14-C",  // name 
    "quantity": 1,                // quantity, in contracts ($10 per contract for futures, ฿1 — for options)
    "price": "0.02",              // float, without "adv" parameter - USD for futures, BTC for options,
                                  // for advanced orders: if "adv"="usd" USD, if "adv"="implv" - implied volatility in %
    "label": "1"                  // optional parameter, user defined maximum 32-char label for the order
    "post_only": true,            // optional parameter, if true then the order will be POST ONLY
                                  // (adjusted to always enter the order book as a maker order without
                                  // immediate matching with lower fee or rebate, see the docs for more details) 
    "adv": "usd"                  // optional parameter, can be "implv", "usd", or absent (advanced order type)
}
  • In case of “adv”=”implv”, field “price” must be a value of Implied Volatility (in percentages), e.g., “price”=100, means implied volatility of 100%
  • In case of “adv”=”usd”, field “price” must be the option price value in USD
  • it is not allowed to combine “adv”=”implv”,”usd” parameter with “post_only”=true
  • “adv” parameter is not applicable to futures, ignored
Method: POST
Result is JSON object:
{
    "success": true, // true or false
    "result": {
        "order": {
            "orderId": 889, 	// id of created order if success = true
            "instrument": "BTC-22JAN16", 	//instrument name of the order
            "direction": "buy", 	// direction, buy
            "price": 417, 	// price, float, USD for futures, BTC for options
            "quantity": 1, 	// quantity, in contracts ($10 per contract for futures, ฿1 — for options)
            "label": "",        // user defined label (up to 32 characters)
            "filledQuantity": 0, 	//filled quantity, in contracts ($10 per contract for futures, ฿1 — for options)
            "avgPrice": 0,            // average fill price of the order
            "commission": 0, 	// commission in btc
            "created": 1453398857489, // creation timestamp
            "lastUpdate": 1453398857489, // timestamp of the last order state update
            "state": "open"   // order state
            "postOnly": false            // true for post-only orders only
            "adv": false,             // advanced type (false, or "usd" or "implv") 
             // for advanced orders could be:
            "implv": 250  // implied volatility in %, if "adv"="implv"
            "usd": 50     // usd price, if "adv"="usd"
            },
         "trades": [] // the list of immediate trades if them have happened 
        }, 
    "message": "" // empty or text message, e.g. error message }
account
sell