Chilkat Online Tools

Ruby / Binance spot API / New Order (TRADE)

Back to Collection Items

require 'chilkat'

# This example assumes the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

http = Chilkat::CkHttp.new()

http.SetRequestHeader("Content-Type","application/json")
http.SetRequestHeader("X-MBX-APIKEY","{{binance-api-key}}")

# resp is a CkHttpResponse
resp = http.QuickRequest("POST","https://domain.com/api/v3/order?symbol=BNBUSDT&side=SELL&type=×tamp={{timestamp}}&signature={{signature}}")
if (http.get_LastMethodSuccess() == false)
    print http.lastErrorText() + "\n";
    exit
end

print resp.get_StatusCode().to_s() + "\n";
print resp.bodyStr() + "\n";

Curl Command

curl -X POST
	-H "Content-Type: application/json"
	-H "X-MBX-APIKEY: {{binance-api-key}}"
https://domain.com/api/v3/order?symbol=BNBUSDT&side=SELL&type=&timestamp={{timestamp}}&signature={{signature}}

Postman Collection Item JSON

{
  "name": "New Order (TRADE)",
  "request": {
    "method": "POST",
    "header": [
      {
        "key": "Content-Type",
        "type": "text",
        "value": "application/json"
      },
      {
        "key": "X-MBX-APIKEY",
        "value": "{{binance-api-key}}",
        "type": "text"
      }
    ],
    "url": {
      "raw": "{{url}}/api/v3/order?symbol=BNBUSDT&side=SELL&type=&timestamp={{timestamp}}&signature={{signature}}",
      "host": [
        "{{url}}"
      ],
      "path": [
        "api",
        "v3",
        "order"
      ],
      "query": [
        {
          "key": "symbol",
          "value": "BNBUSDT",
          "description": "Trading symbol, e.g. BNBUSDT"
        },
        {
          "key": "side",
          "value": "SELL"
        },
        {
          "key": "type",
          "value": "",
          "description": "Order type"
        },
        {
          "key": "timeInForce",
          "value": "",
          "description": "Order time in force",
          "disabled": true
        },
        {
          "key": "quantity",
          "value": "",
          "description": "Order quantity",
          "disabled": true
        },
        {
          "key": "quoteOrderQty",
          "value": "",
          "description": "Quote quantity",
          "disabled": true
        },
        {
          "key": "price",
          "value": "",
          "description": "Order price",
          "disabled": true
        },
        {
          "key": "newClientOrderId",
          "value": "",
          "description": "Used to uniquely identify this cancel. Automatically generated by default",
          "disabled": true
        },
        {
          "key": "strategyId",
          "value": "",
          "disabled": true
        },
        {
          "key": "strategyType",
          "value": "",
          "description": "The value cannot be less than 1000000",
          "disabled": true
        },
        {
          "key": "stopPrice",
          "value": "20.01",
          "description": "Used with STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, and TAKE_PROFIT_LIMIT orders.",
          "disabled": true
        },
        {
          "key": "trailingDelta",
          "value": "",
          "description": "Used with STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, and TAKE_PROFIT_LIMIT orders.",
          "disabled": true
        },
        {
          "key": "icebergQty",
          "value": "",
          "description": "Used with LIMIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT to create an iceberg order.",
          "disabled": true
        },
        {
          "key": "newOrderRespType",
          "value": "",
          "description": "Set the response JSON. MARKET and LIMIT order types default to FULL, all other orders default to ACK.",
          "disabled": true
        },
        {
          "key": "recvWindow",
          "value": "5000",
          "description": "The value cannot be greater than 60000",
          "disabled": true
        },
        {
          "key": "timestamp",
          "value": "{{timestamp}}",
          "description": "UTC timestamp in ms"
        },
        {
          "key": "signature",
          "value": "{{signature}}",
          "description": "Signature"
        }
      ]
    },
    "description": "Send in a new order.\n\n- `LIMIT_MAKER` are `LIMIT` orders that will be rejected if they would immediately match and trade as a taker.\n- `STOP_LOSS` and `TAKE_PROFIT` will execute a `MARKET` order when the `stopPrice` is reached.\n- Any `LIMIT` or `LIMIT_MAKER` type order can be made an iceberg order by sending an `icebergQty`.\n- Any order with an `icebergQty` MUST have `timeInForce` set to `GTC`.\n- `MARKET` orders using `quantity` specifies how much a user wants to buy or sell based on the market price.\n- `MARKET` orders using `quoteOrderQty` specifies the amount the user wants to spend (when buying) or receive (when selling) of the quote asset; the correct quantity will be determined based on the market liquidity and `quoteOrderQty`.\n- `MARKET` orders using `quoteOrderQty` will not break `LOT_SIZE` filter rules; the order will execute a quantity that will have the notional value as close as possible to `quoteOrderQty`.\n- same `newClientOrderId` can be accepted only when the previous one is filled, otherwise the order will be rejected.\n\nTrigger order price rules against market price for both `MARKET` and `LIMIT` versions:\n\n- Price above market price: `STOP_LOSS` `BUY`, `TAKE_PROFIT` `SELL`\n- Price below market price: `STOP_LOSS` `SELL`, `TAKE_PROFIT` `BUY`\n\n\nWeight(IP): 1"
  },
  "response": [
  ]
}