{{"We've detected that you are using a small display"|T}} .
{{"Want to switch to the mobile version of the site"|T}} >>

{{'Website Translator' | T}}

Translations by Google is provided for convenience and is not verified contextually.
Please refer to original for accuracy.

English 简体中文 繁體中文 한국어 русский Español Français Deutsch
  • English
  • 简体中文
  • 繁體中文
  • 한국어
  • русский
  • Español
  • Français
  • Deutsch

General API Information

  • All endpoints of /api and /wapi are under https://api.binance.com
  • All endpoints return either a JSON object or array.
  • Data is returned in ascending order. Oldest first, newest last.
  • All time and timestamp related fields are in milliseconds.
  • HTTP 4XX return codes are used for for malformed requests; the issue is on the sender's side.
  • HTTP 5XX return codes are used for internal errors; the issue is on Binance's side.
  • HTTP 504 return code is used when the API successfully sent the message but not get a response within the timeout period. It is important to NOT treat this as a failure; the execution status is UNKNOWN and could have been a success.
  • Any endpoint can retun an ERROR; the error payload is as follows:
{
  "code": -1121,
  "msg": "Invalid symbol."
}
  • Specific error codes and messages defined in another document.
  • For GET endpoints, parameters must be sent as a query string.
  • For POST, PUT, and DELETE endpoints, the parameters may be sent a query string and in the request body with content type application/x-www-form-urlencoded. You may mix parameters between both the query string and request body if you wish to do so.
  • Parameters may be sent in any order.
  • If a parameter sent in both the query string and request body, the query string parameter will be used.

Endpoint security type

  • Each endpoint has a security type that determines the how you will interact with it.
  • API-keys are passed into the Rest API via the X-MBX-APIKEY header.
  • API-keys, and secret-keys are case sensitive.
Security Type Description
NONE Endpoint can be accessed freely.
API-KEY Endpoint requires sending a valid API-KEY.
SIGNED Endpoint requires sending a valid API-Key and signing the payload

SIGNED Endpoint security

  • SIGNED endpoints require an additional parameter, signature, to be sent in the query string or request body.
  • Endpoints use HMAC SHA256 signatures. The HMAC SHA256 signature is a keyed HMAC SHA256 operation. Use your secretKey as the key and totalParams as the value for the HMAC operation.
  • The signature is not case sensitive.
  • totalParams is defined as the query string concatenated with the request body.

Timing security

  • A SIGNED endpoint also requires a parameter, timestamp, to be sent which should be the millisecond timestamp of when the request was created and sent.
  • An additional parameter, recvWindow, may be sent to specific the number of milliseconds after timestamp the request is valid for. If recvWindow is not sent, it defaults to 5000 millisecond.
    • The logic is as follows:
    if (timestamp < serverTime && (serverTime - timestamp) <= recvWindow) {
      // process request
    } else {
      // reject request
    }

Serious trading is about timing. Networks can be unstable and unreliable, which can lead to requests taking varying amounts of time to reach the servers. With recvWindow, you can specify that the request must be processed within a certain number of milliseconds or be rejected by the server.

SIGNED Endpoint Examples for POST /api/v3/order

Here is a step-by-step example of how to send a vaild signed payload from the Linux command line using echo, sha256sum, and curl.

Key Value
apiKey vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A
secretKey NhqPtmdSJYdKjVHjA7PZj4Mge3R5YNiP1e3UZjInClVN65XAbvqqM6A7H5fATj0j
Parameter Value
symbol LTCBTC
side BUY
type LIMIT
timeInForce GTC
quantity 1
price 0.1
recvWindow 6000000
timestamp 1499827319559

Example 1: As a query string

  • queryString: symbol=LTCBTC&side=BUY&type=LIMIT&timeInForce=GTC&quantity=1&price=0.1&recvWindow=5000&timestamp=1499827319559

  • HMAC SHA256 signature:

    [linux]$ echo -n "symbol=LTCBTC&side=BUY&type=LIMIT&timeInForce=GTC&quantity=1&price=0.1&recvWindow=5000&timestamp=1499827319559" | openssl dgst -sha256 -hmac "NhqPtmdSJYdKjVHjA7PZj4Mge3R5YNiP1e3UZjInClVN65XAbvqqM6A7H5fATj0j"
    (stdin)= c8db56825ae71d6d79447849e617115f4a920fa2acdcab2b053c4b2838bd6b71
    
  • curl command:

    (HMAC SHA256)
    [linux]$ curl -H "X-MBX-APIKEY: vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A" -X POST 'https://api.binance.com/api/v3/order?symbol=LTCBTC&side=BUY&type=LIMIT&timeInForce=GTC&quantity=1&price=0.1&recvWindow=5000&timestamp=1499827319559&signature=c8db56825ae71d6d79447849e617115f4a920fa2acdcab2b053c4b2838bd6b71'
    

Example 2: As a request body

  • requestBody: symbol=LTCBTC&side=BUY&type=LIMIT&timeInForce=GTC&quantity=1&price=0.1&recvWindow=5000&timestamp=1499827319559

  • HMAC SHA256 signature:

    [linux]$ echo -n "symbol=LTCBTC&side=BUY&type=LIMIT&timeInForce=GTC&quantity=1&price=0.1&recvWindow=5000&timestamp=1499827319559" | openssl dgst -sha256 -hmac "NhqPtmdSJYdKjVHjA7PZj4Mge3R5YNiP1e3UZjInClVN65XAbvqqM6A7H5fATj0j"
    (stdin)= c8db56825ae71d6d79447849e617115f4a920fa2acdcab2b053c4b2838bd6b71
    
  • curl command:

    (HMAC SHA256)
    [linux]$ curl -H "X-MBX-APIKEY: vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A" -X POST 'https://api.binance.com/api/v3/order' -d 'symbol=LTCBTC&side=BUY&type=LIMIT&timeInForce=GTC&quantity=1&price=0.1&recvWindow=6000000&timestamp=1499827319559&signature=c8db56825ae71d6d79447849e617115f4a920fa2acdcab2b053c4b2838bd6b71'
    

Example 3: Mixed query string and request body

  • queryString: symbol=LTCBTC&side=BUY&type=LIMIT&timeInForce=GTC

  • requestBody: quantity=1&price=0.1&recvWindow=5000&timestamp=1499827319559

  • HMAC SHA256 signature:

    [linux]$ echo -n "symbol=LTCBTC&side=BUY&type=LIMIT&timeInForce=GTCquantity=1&price=0.1&recvWindow=5000&timestamp=1499827319559" | openssl dgst -sha256 -hmac "NhqPtmdSJYdKjVHjA7PZj4Mge3R5YNiP1e3UZjInClVN65XAbvqqM6A7H5fATj0j"
    (stdin)= 0fd168b8ddb4876a0358a8d14d0c9f3da0e9b20c5d52b2a00fcf7d1c602f9a77
    
  • curl command:

    (HMAC SHA256)
    [linux]$ curl -H "X-MBX-APIKEY: vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A" -X POST 'https://api.binance.com/api/v3/order?symbol=LTCBTC&side=BUY&type=LIMIT&timeInForce=GTC' -d 'quantity=1&price=0.1&recvWindow=6000000&timestamp=1499827319559&signature=0fd168b8ddb4876a0358a8d14d0c9f3da0e9b20c5d52b2a00fcf7d1c602f9a77'
    

Note that the signature is different in example 3. There is no & between "GTC" and "quantity=1".

Public API Endpoints

Terminology

  • base asset refers to the asset that is the quantity of a symbol.
  • quoate asset refers to the asset that is the price of a symbol.

ENUM definitions

Symbol type:

  • SPOT

Order status:

  • NEW
  • PARTIALLY_FILLED
  • FILLED
  • CANCELED
  • PENDING_CANCEL
  • REJECTED
  • EXPIRED

Order types:

  • LIMIT
  • MARKET

Order side:

  • BUY
  • SELL

Time in force:

  • GTC
  • IOC

Kline intervals:

m -> minutes; h -> hours; d -> days; w -> weeks; M -> months

  • 1m
  • 3m
  • 5m
  • 15m
  • 30m
  • 1h
  • 2h
  • 4h
  • 6h
  • 8h
  • 12h
  • 1d
  • 3d
  • 1w
  • 1M

General endpoints

Test connectivity

+ GET /api/v1/ping

Test connectivity to the Rest API.

Parameters: NONE

Response:

{}

Check server time

+ GET /api/v1/time

Test connectivity to the Rest API and get the current server time.

Parameters: NONE

Response:

{
		  "serverTime": 1499827319559
		}

Market Data endpoints

Order book

+ GET /api/v1/depth

Parameters:

Name Type Mandatory Description
symbol STRING YES
limit INT NO Default 100; max 100.

Response:

{
		  "lastUpdateId": 1027024,
		  "bids": [
		    [
		      "4.00000000",     // PRICE
		      "431.00000000",   // QTY
		      []                // Can be ignored
		    ]
		  ],
		  "asks": [
		    [
		      "4.00000200",
		      "12.00000000",
		      []
		    ]
		  ]
		}

Compressed/Aggregate trades list

+ GET /api/v1/aggTrades

Get compressed, aggregate trades. Trades that fill at the time, from the same order, with the same price will have the quantity aggregated.

Parameters:

Name Type Mandatory Description
symbol STRING YES
fromId LONG NO ID to get aggregate trades from INCLUSIVE.
startTime LONG NO Timestamp in ms to get aggregate trades from INCLUSIVE.
endTime LONG NO Timestamp in ms to get aggregate trades until INCLUSIVE.
limit INT NO Default 500; max 500.
  • If both startTime and endTime are sent, limit should not be sent AND the distance between startTime and endTime must be less than 24 hours.
  • If frondId, startTime, and endTime are not sent, the most recent aggregate trades will be returned.

Response:

[
		  {
		    "a": 26129,         // Aggregate tradeId
		    "p": "0.01633102",  // Price
		    "q": "4.70443515",  // Quantity
		    "f": 27781,         // First tradeId
		    "l": 27781,         // Last tradeId
		    "T": 1498793709153, // Timestamp
		    "m": true,          // Was the buyer the maker?
		    "M": true           // Was the trade the best price match?
		  }
		]

Kline/candlesticks

+ GET /api/v1/klines

Kline/candlestick bars for a symbol. Klines are uniquely identified by their open time.

Parameters:

Name Type Mandatory Description
symbol STRING YES
interval ENUM YES
limit INT NO Default 500; max 500.
startTime LONG NO
endTime LONG NO
  • If startTime and endTime are not sent, the most recent klines are returned.

Response:

[
		  [
		    1499040000000,      // Open time
		    "0.01634790",       // Open
		    "0.80000000",       // High
		    "0.01575800",       // Low
		    "0.01577100",       // Close
		    "148976.11427815",  // Volume
		    1499644799999,      // Close time
		    "2434.19055334",    // Quote asset volume
		    308,                // Number of trades
		    "1756.87402397",    // Taker buy base asset volume
		    "28.46694368",      // Taker buy quote asset volume
		    "17928899.62484339" // Can be ignored
		  ]
		]

24hr ticker price change statistics

+ GET /api/v1/ticker/24hr

24 hour price change statistics.

Parameters:

Name Type Mandatory Description
symbol STRING YES

Response:

{
		  "priceChange": "-94.99999800",
		  "priceChangePercent": "-95.960",
		  "weightedAvgPrice": "0.29628482",
		  "prevClosePrice": "0.10002000",
		  "lastPrice": "4.00000200",
		  "bidPrice": "4.00000000",
		  "askPrice": "4.00000200",
		  "openPrice": "99.00000000",
		  "highPrice": "100.00000000",
		  "lowPrice": "0.10000000",
		  "volume": "8913.30000000",
		  "openTime": 1499783499040,
		  "closeTime": 1499869899040,
		  "fristId": 28385,   // First tradeId
		  "lastId": 28460,    // Last tradeId
		  "count": 76         // Trade count
		}

Symbols price ticker

+ GET /api/v1/ticker/allPrices

Latest price for all symbols.

Parameters:NONE

Response:

[
				  {
				    "symbol": "LTCBTC",
				    "price": "4.00000200"
				  },
				  {
				    "symbol": "ETHBTC",
				    "price": "0.07946600"
				  }
				]

Symbols order book ticker

+ GET /api/v1/ticker/allBookTickers

Best price/qty on the order book for all symbols.

Parameters:NONE

Response:

[
				  {
				    "symbol": "LTCBTC",
				    "bidPrice": "4.00000000",
				    "bidQty": "431.00000000",
				    "askPrice": "4.00000200",
				    "askQty": "9.00000000"
				  },
				  {
				    "symbol": "ETHBTC",
				    "bidPrice": "0.07946700",
				    "bidQty": "9.00000000",
				    "askPrice": "100000.00000000",
				    "askQty": "1000.00000000"
				  }
				]

Account endpoints

New order (SIGNED)

+ POST /api/v3/order

Send in a new order

Parameters:

Name Type Mandatory Description
symbol STRING YES
side ENUM YES
type ENUM YES
timeInForce ENUM YES
quantity DECIMAL YES
price DECIMAL YES
newClientOrderId STRING NO A unique id for the order. Automatically generated if not sent.
stopPrice DECIMAL NO Used with stop orders
icebergQty DECIMAL NO Used with iceberg orders
timestamp LONG YES

Response:

{
		  "symbol":"LTCBTC",
		  "orderId": 1,
		  "clientOrderId": "myOrder1" // Will be newClientOrderId
		  "transactTime": 1499827319559
		}

Test new order (SIGNED)

+ POST /api/v3/order/test

Test new order creation and signature/recvWindow long. Creates and validates a new order but does not send it into the matching engine.

Parameters:

Name Type Mandatory Description
symbol STRING YES
side ENUM YES
type ENUM YES
timeInForce ENUM YES
quantity DECIMAL YES
price DECIMAL YES
newClientOrderId STRING NO A unique id for the order. Automatically generated by default.
stopPrice DECIMAL NO Used with STOP orders
icebergQty DECIMAL NO Used with icebergOrders
recvWindow LONG NO
timestamp LONG YES

Response:

{}

Query order (SIGNED)

+ GET /api/v3/order

Check an order's status.

Parameters:

Name Type Mandatory Description
symbol STRING YES
orderId LONG NO
origClientOrderId STRING NO
recvWindow LONG NO
timestamp LONG YES

Either orderId or origClientOrderId must be sent.

Response:

{
		  "symbol": "LTCBTC",
		  "orderId": 1,
		  "clientOrderId": "myOrder1",
		  "price": "0.1",
		  "origQty": "1.0",
		  "executedQty": "0.0",
		  "status": "NEW",
		  "timeInForce": "GTC",
		  "type": "LIMIT",
		  "side": "BUY",
		  "stopPrice": "0.0",
		  "icebergQty": "0.0",
		  "time": 1499827319559
		}

Cancel order (SIGNED)

+ DELETE /api/v3/order

Cancel an active order.

Parameters:

Name Type Mandatory Description
symbol STRING YES
orderId LONG NO
origClientOrderId STRING NO
newClientOrderId STRING NO Used to uniquely identify this cancel. Automatically generated by default.
recvWindow LONG NO
timestamp LONG YES

Response:

{
		  "symbol": "LTCBTC",
		  "origClientOrderId": "myOrder1",
		  "orderId": 1,
		  "clientOrderId": "cancelMyOrder1"
		}

Current open orders (SIGNED)

+ GET /api/v3/openOrders

Get all open orders on a symbol.

Parameters:

Name Type Mandatory Description
symbol STRING YES
recvWindow LONG NO
timestamp LONG YES

Response:

[
		  {
		    "symbol": "LTCBTC",
		    "orderId": 1,
		    "clientOrderId": "myOrder1",
		    "price": "0.1",
		    "origQty": "1.0",
		    "executedQty": "0.0",
		    "status": "NEW",
		    "timeInForce": "GTC",
		    "type": "LIMIT",
		    "side": "BUY",
		    "stopPrice": "0.0",
		    "icebergQty": "0.0",
		    "time": 1499827319559
		  }
		]

All orders (SIGNED)

+ GET /api/v3/allOrders

Get all account orders; active, canceled, or filled.

Parameters:

Name Type Mandatory Description
symbol STRING YES
orderId LONG NO
limit INT NO Default 500; max 500.
recvWindow LONG NO
timestamp LONG YES
  • If orderId is set, it will get orders >= that orderId. Otherwise most recent orders are returned.

Response:

[
		  {
		    "symbol": "LTCBTC",
		    "orderId": 1,
		    "clientOrderId": "myOrder1",
		    "price": "0.1",
		    "origQty": "1.0",
		    "executedQty": "0.0",
		    "status": "NEW",
		    "timeInForce": "GTC",
		    "type": "LIMIT",
		    "side": "BUY",
		    "stopPrice": "0.0",
		    "icebergQty": "0.0",
		    "time": 1499827319559
		  }
		]

Account information (SIGNED)

+ GET /api/v3/account

Get current account information.

Parameters:

Name Type Mandatory Description
recvWindow LONG NO
timestamp LONG YES

Response:

{
		  "makerCommission": 15,
		  "takerCommission": 15,
		  "buyerCommission": 0,
		  "sellerCommission": 0,
		  "canTrade": true,
		  "canWithdraw": true,
		  "canDeposit": true,
		  "balances": [
		    {
		      "asset": "BTC",
		      "free": "4723846.89208129",
		      "locked": "0.00000000"
		    },
		    {
		      "asset": "LTC",
		      "free": "4763368.68006011",
		      "locked": "0.00000000"
		    }
		  ]
		}

Account trade list (SIGNED)

+ GET /api/v3/myTrades

Get trades for a specific account and symbol.

Parameters:

Name Type Mandatory Description
symbol STRING YES
limit INT NO Default 500; max 500.
fromId LONG NO TradeId to fetch from. Default gets most recent trades.
recvWindow LONG NO
timestamp LONG YES

Response:

[
		  {
		    "id": 28457,
		    "price": "4.00000100",
		    "qty": "12.00000000",
		    "commission": "10.10000000",
		    "commissionAsset": "BNB",
		    "time": 1499865549590,
		    "isBuyer": true,
		    "isMaker": false,
		    "isBestMatch": true
		  }
		]

SIGNED Endpoint Examples for /wapi/v3/withdraw.html

+POST /wapi/v3/withdraw.html

Submit a withdraw request.

Parameters:

Name Type Mandatory Description
asset STRING YES
address STRING YES
addressTag STRING NO Secondary address identifier for coins like XRP,XMR etc.
amount DECIMAL YES
name STRING NO Description of the address
recvWindow LONG NO
timestamp LONG YES

Response:

{
    "msg": "success",
    "success": true,
    "id":"7213fea8e94b4a5593d507237e5a555b"
}
		

SIGNED Endpoint Examples for /wapi/v3/depositHistory.html

+GET /wapi/v3/depositHistory.html

Fetch deposit history.

Parameters:

Name Type Mandatory Description
asset STRING NO
status INT NO 0(0:pending,1:success)
startTime LONG NO
endTime LONG NO
recvWindow LONG NO
timestamp LONG YES

Response:

		  
{
    "depositList": [
        {
            "insertTime": 1508198532000,
            "amount": 0.04670582,
            "asset": "ETH",
            "address": "0x6915f16f8791d0a1cc2bf47c13a6b2a92000504b",
            "txId": "0xdf33b22bdb2b28b1f75ccd201a4a4m6e7g83jy5fc5d5a9d1340961598cfcb0a1",
            "status": 1
        },
        {
            "insertTime": 1508298532000,
            "amount": 1000,
            "asset": "XMR",
            "address": "463tWEBn5XZJSxLU34r6g7h8jtxuNcDbjLSjkn3XAXHCbLrTTErJrBWYgHJQyrCwkNgYvyV3z8zctJLPCZy24jvb3NiTcTJ",
            "addressTag": "342341222",
            "txId": "b3c6219639c8ae3f9cf010cdc24fw7f7yt8j1e063f9b4bd1a05cb44c4b6e2509",
            "status": 1
        }
    ],
    "success": true
}
		  
		

SIGNED Endpoint Examples for /wapi/v3/withdrawHistory.html

+GET /wapi/v3/withdrawHistory.html

Fetch withdraw history.

Parameters:

Name Type Mandatory Description
asset STRING NO
status INT NO 0(0:Email Sent,1:Cancelled 2:Awaiting Approval 3:Rejected 4:Processing 5:Failure 6Completed)
startTime LONG NO
endTime LONG NO
recvWindow LONG NO
timestamp LONG YES

Response:

{
    "withdrawList": [
        {
            "id":"7213fea8e94b4a5593d507237e5a555b"
            "amount": 1,
            "address": "0x6915f16f8791d0a1cc2bf47c13a6b2a92000504b",
            "asset": "ETH",
            "txId": "0xdf33b22bdb2b28b1f75ccd201a4a4m6e7g83jy5fc5d5a9d1340961598cfcb0a1",
            "applyTime": 1508198532000 
            "status": 4
        },
        {
            "id":"7213fea8e94b4a5534ggsd237e5a555b"
            "amount": 1000,
            "address": "463tWEBn5XZJSxLU34r6g7h8jtxuNcDbjLSjkn3XAXHCbLrTTErJrBWYgHJQyrCwkNgYvyV3z8zctJLPCZy24jvb3NiTcTJ",
            "addressTag": "342341222",
            "txId": "b3c6219639c8ae3f9cf010cdc24fw7f7yt8j1e063f9b4bd1a05cb44c4b6e2509",
            "asset": "XMR",
            "applyTime": 1508198532000,
            "status": 4
        }
    ],
    "success": true
}
		

SIGNED Endpoint Examples for /wapi/v3/depositAddress.html

+GET /wapi/v3/depositAddress.html

Fetch deposit address.

Parameters:

Name Type Mandatory Description
asset STRING YES
recvWindow LONG NO
timestamp LONG YES

Response:

{
    "address": "0x6915f16f8791d0a1cc2bf47c13a6b2a92000504b",
    "success": true,
    "addressTag": "1231212",
    "asset": "BNB"
}
		

User stream endpoints

Specifics on how user data streams work is in another document.

Start user data stream (API-KEY)

+ POST /api/v1/userDataStream

Start a new user data stream.

Parameters: NONE

Response:

{
		  "listenKey": "pqia91ma19a5s61cv6a81va65sdf19v8a65a1a5s61cv6a81va65sdf19v8a65a1"
		}

Keepalive user data stream (API-KEY)

+ PUT /api/v1/userDataStream

PING a user data stream to prevent a time out.

Parameters:

Name Type Mandatory Description
listenKey STRING YES

Response:

{}

Close user data stream (API-KEY)

+ DELETE /api/v1/userDataStream

Close out a user data stream.

Parameters:

Name Type Mandatory Description
listenKey STRING YES

Response:

{}

WebSocket API

Depth Websocket Endpoint

Websocket url for depth endpoint

+ wss://stream.binance.com:9443/ws/[symbol in lower case]@depth   (e.g. wss://stream.binance.com:9443/ws/ethbtc@depth)

Event Data:

		{
			"e": "depthUpdate",						// event type
			"E": 1499404630606, 					// event time
			"s": "ETHBTC", 							// symbol
			"u": 7913455, 							// updateId to sync up with updateid in /api/v1/depth
			"b": [									// bid depth delta
				[
					"0.10376590", 					// price (need to upate the quantity on this price)
					"59.15767010", 					// quantity
					[]								// can be ignored
				],
			],
			"a": [									// ask depth delta
				[
					"0.10376586", 					// price (need to upate the quantity on this price)
					"159.15767010", 				// quantity
					[]								// can be ignored
				],
				[
					"0.10383109",
					"345.86845230",
					[]
				],
				[
					"0.10490700",
					"0.00000000", 					//quantitiy=0 means remove this level
					[]
				]
			]
		}
			          

Kline Websocket Endpoint

Websocket url for kline endpoint

+ wss://stream.binance.com:9443/ws/[symbol in lower case]@kline_[interval] (e.g. wss://stream.binance.com:9443/ws/ethbtc@kline_1m)

Event Data:

		{
			"e": "kline",							// event type
			"E": 1499404907056,						// event time
			"s": "ETHBTC",							// symbol
			"k": {
				"t": 1499404860000, 				// start time of this bar
				"T": 1499404919999, 				// end time of this bar
				"s": "ETHBTC",						// symbol
				"i": "1m",							// interval
				"f": 77462,							// first trade id
				"L": 77465,							// last trade id
				"o": "0.10278577",					// open
				"c": "0.10278645",					// close
				"h": "0.10278712",					// high
				"l": "0.10278518",					// low
				"v": "17.47929838",					// volume
				"n": 4,								// number of trades
				"x": false,							// whether this bar is final
				"q": "1.79662878",					// quote volume
				"V": "2.34879839",					// volume of active buy
				"Q": "0.24142166",					// quote volume of active buy
				"B": "13279784.01349473"			// can be ignored
				}
		}
			          

Trades Websocket Endpoint

Websocket url for trades endpoint

+ wss://stream.binance.com:9443/ws/[symbol in lower case]@aggTrade (e.g. wss://stream.binance.com:9443/ws/ethbtc@aggTrade)

Event Data:

						{
							"e": "aggTrade",		// event type
							"E": 1499405254326,		// event time
							"s": "ETHBTC",			// symbol
							"a": 70232,				// aggregated tradeid
							"p": "0.10281118",		// price
							"q": "8.15632997",		// quantity
							"f": 77489,				// first breakdown trade id
							"l": 77489,				// last breakdown trade id
							"T": 1499405254324,		// trade time
							"m": false,				// whehter buyer is a maker
							"M": true				// can be ignore
						}
						

User Data Websocket Endpoint

Websocket url for user data endpoint

+ wss://stream.binance.com:9443/ws/[listenKey] (e.g. wss://stream.binance.com:9443/ws/ikKz2GYMzCSNFjPzPeJHGYQI6sXwVNIzX7KNg31FDZkRE9OVrOE3al8PQwS8)

Account Update Event:

		{
		   "e": "outboundAccountInfo",		// event type
		   "E": 1499405658849,				// event time
		   "m": 0,
		   "t": 0,
		   "b": 0,
		   "s": 0,
		   "T": true,
		   "W": true,
		   "D": true,
		   "B": [  							// balances
		       {
		           "a": "LTC",				// asset
		           "f": "17366.18538083",	// available balance
		           "l": "0.00000000"		// locked by open orders
		       },
		       {
		           "a": "BTC",
		           "f": "10537.85314051",
		           "l": "2.19464093"
		       },
		       {
		           "a": "ETH",
		           "f": "17902.35190619",
		           "l": "0.00000000"
		       },
		       {
		           "a": "BNC",
		           "f": "1114503.29769312",
		           "l": "0.00000000"
		       },
		       {
		           "a": "NEO",
		           "f": "0.00000000",
		           "l": "0.00000000"
		       }
		   ]
		}
				          

Order Update Event:

		{
		   "e": "executionReport",			// order or trade report
		   "E": 1499405658658,				// event time
		   "s": "ETHBTC",					// symbol
		   "c": "mUvoqJxFIILMdfAW5iGSOW",	// newClientOrderId
		   "S": "BUY",						// side: buy or sell
		   "o": "LIMIT",					// order type LIMIT, MARKET
		   "f": "GTC",						// time in force, GTC: Good Till Cancel, IOC: Immediate or Cancel
		   "q": "1.00000000", 				// original quantity
		   "p": "0.10264410",				// price
		   "P": "0.00000000", 
		   "F": "0.00000000",
		   "g": -1,
		   "C": "null",
		   "x": "NEW", 						// executionType NEW, CANCELED, REPLACED, REJECTED, TRADE,EXPIRED
		   "X": "NEW", 						// orderStatus NEW, PARTIALLY_FILLED, FILLED, CANCELED,PENDING_CANCEL, REJECTED, EXPIRED
		   "r": "NONE", 					// orderRejectReason,NONE, UNKNOWN_INSTRUMENT, MARKET_CLOSED, PRICE_QTY_EXCEED_HARD_LIMITS, UNKNOWN_ORDER, DUPLICATE_ORDER, UNKNOWN_ACCOUNT, INSUFFICIENT_BALANCE, ACCOUNT_INACTIVE, ACCOUNT_CANNOT_SETTLE
		   "i": 4293153,					// order id
		   "l": "0.00000000",
		   "z": "0.00000000",
		   "L": "0.00000000",
		   "n": "0",
		   "N": null,
		   "T": 1499405658657,				// order time
		   "t": -1,
		   "I": 8641984, 
		   "w": true,
		   "m": false,
		   "M": false
		}
				          

Trade Update Event:

		{
		   "e": "executionReport",			// order or trade report
		   "E": 1499406026404,				// event time
		   "s": "ETHBTC",					// symbol
		   "c": "1hRLKJhTRsXy2ilYdSzhkk",	// newClientOrderId
		   "S": "BUY",						// side: buy or sell
		   "o": "LIMIT",					// order type LIMIT, MARKET
		   "f": "GTC",						// time in force, GTC: Good Till Cancel, IOC: Immediate or Cancel
		   "q": "22.42906458",				// original quantity
		   "p": "0.10279999",				// price
		   "P": "0.00000000",
		   "F": "0.00000000",
		   "g": -1,
		   "C": "null",
		   "x": "TRADE",					// executionType NEW, CANCELED, REPLACED, REJECTED, TRADE,EXPIRED
		   "X": "FILLED",					// order got filled
		   "r": "NONE",
		   "i": 4294220,					// orderid
		   "l": "17.42906458",				// quantity of last filled trade
		   "z": "22.42906458",				// accumulated quantity of filled trades on this order
		   "L": "0.10279999",				// price of last filled trade
		   "n": "0.00000001",				// commission
		   "N": "BNC",						// asset on which commission is taken
		   "T": 1499406026402,				// trade time
		   "t": 77517,						// trade id
		   "I": 8644124,					// can be ignored
		   "w": false,						// can be ignored
		   "m": false,						// is buyer maker
		   "M": true						// can be ignored
		}
				          
 
© 2017 Binance.com All Rights Reserved
{{today|date:'yyyy-MM-dd HH:mm:ss'}}
24h {{"Trade Volume" | T}}: {{volume[1]|number:2}} {{volume[0]}}/
{{websocketStatus | T}}

{{"Binance Telegram" | T}}