API Docs for the Bitbns Cryptocurrency Exchange.
Official NPM Package: https://github.com/bitbns-official/node-bitbns-api
Things that the developers should know about
\nThe authentication is done using API KEY and API SECRET supplied to the user. The body to be sent is a stringified JSON object and the same is used to generate the signature to be supplied with the request. Signature generation can be checked using the \"Pre Request Script\" tab in Postman(\"Open with Postman\" Button at top right of the page).
\nconst CryptoJS = require(\"crypto-js\");\n\nlet timeStamp_nonce = Date.now().toString();\nlet bodystring = `{\"symbol\":\"BTC\",\"entry_id\":\"2814697\"}`\nconst body = JSON.parse(bodystring)\nconst secret = \"asdfghjkl\"\nconst obj = {\n timeStamp_nonce: timeStamp_nonce,\n body: JSON.stringify(body)\n};\nconst payload = new Buffer(JSON.stringify(obj)).toString('base64');\nconst signature = CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA512(payload, secret));\nconsole.log(\"Payload:\", payload)\nconsole.log(\"\\nSignature:\",signature)\n\nfrom datetime import datetime\nimport hmac\nimport hashlib\nimport base64\nimport json\ntimeStamp_nonce = str(round(datetime.now().timestamp()*1000))\nprint(timeStamp_nonce)\nbodystring = \"{\\\"symbol\\\":\\\"BTC\\\",\\\"entry_id\\\":\\\"2814697\\\"}\"\nsecret = \"asdfghjkl\"\nobj = {\n \"timeStamp_nonce\": timeStamp_nonce,\n \"body\": bodystring\n};\npayload = base64.b64encode(json.dumps(obj).replace(\" \",\"\").encode())\nm = hmac.new(secret.encode('utf-8'), payload, hashlib.sha512)\nsignature = m.hexdigest()\nprint(\"Payload:\",payload.decode())\nprint(\"Signature:\", signature)\npackage main\n\nimport \"fmt\"\nimport \"time\"\nimport \"strconv\"\nimport \"encoding/json\"\nimport \"encoding/base64\"\nimport (\n \"crypto/hmac\"\n \"crypto/sha512\"\n \"encoding/hex\"\n)\n\nfunc main() {\n now := time.Now()\n milli := now.Unix()*1000\n timeStamp_nonce := strconv.FormatInt(milli, 10)\n // timeStamp_nonce = \"1590705014350\"\n bodystring := \"{\\\"symbol\\\":\\\"BTC\\\",\\\"entry_id\\\":\\\"2814697\\\"}\"\n secret := \"asdfghjkl\"\n obj := map[string]string{\n \"body\": bodystring,\n \"timeStamp_nonce\": timeStamp_nonce,\n };\n data, _ := json.Marshal(obj)\n payload := base64.StdEncoding.EncodeToString([]byte(data))\n fmt.Println(\"Payload:\",payload)\n h := hmac.New(sha512.New, []byte(secret))\n h.Write([]byte(data))\n signature := hex.EncodeToString(h.Sum(nil))\n fmt.Println(\"\\nSignature:\",signature)\n}\n<?php\n$t=round(microtime(true) * 1000);\n$timeStamp_nonce = strval($t);\n$timeStamp_nonce = \"1590705014350\";\n// echo($timeStamp_nonce);\n$bodystring = \"{\\\"symbol\\\":\\\"BTC\\\",\\\"entry_id\\\":\\\"2814697\\\"}\";\n$secret = \"asdfghjkl\";\n$obj->timeStamp_nonce = $timeStamp_nonce;\n$obj->body = $bodystring;\n$myJSON = json_encode($obj);\n$payload = base64_encode($myJSON);\necho(\"Payload:\" . $payload);\n$sig = hash_hmac('sha512', $payload, $secret);\necho(\"\\n\\nSignature:\" . $sig);\n\n\nHTTP error codes would be returned in case of any errors, the body will also contain an error field which will explain the cause of the error
\n
| Code | \nMeaning | \n
|---|---|
| \n | \n |
| 200 | \nnull -- requested action has been performed without any problems | \n
| 400 | \nInvalid Request -- Invalid request format | \n
| 401 | \nauthentication -- Not authorised or invalid API key | \n
| 403 | \nUndefined -- this request is forbidden | \n
| 404 | \nExchange not found -- Unable to find exchange | \n
| 406 | \nCoin name not supplied or not yet supported -- coin name applied is incorrect | \n
| 409 | \nparameter type not correct -- parameters entered is incorrect | \n
| 412 | \nOops ! Cancellation failed. Something went wrong ! -- Unable to cancel order | \n
| 413 | \nvolume asked not acceptable -- Desired volume is not within bounds | \n
| 416 | \nOops ! Not sufficient balance to purchase currency -- wallet balance is not sufficient | \n
| 417 | \nOops ! Order doesn't exist any more -- Order has alredy been deleted | \n
| 428 | \nPrice seems Irregular from current market price. -- Entered price is more than current price | \n
| 500 | \nProblem with our servers, try again later | \n
| 503 | \ncurrently down for maintaince | \n
There are two individual rate limits for read and write type requests.
These are returned in the response headers of the API.
symbol: Coin name like BTC
entry_id: Order ID
page: 0,1,2... for paginated response.
\n","urlObject":{"protocol":"https","path":["api","trade","v1","depositHistory","{{symbol}}"],"host":["api","bitbns","com"],"query":[],"variable":[]}},"response":[{"id":"75bd92c2-c003-4a2b-9e11-6e0374f4a161","name":"Deposit History","originalRequest":{"method":"POST","header":[{"key":"X-BITBNS-APIKEY","value":"{{apiKey}}","type":"text"},{"key":"X-BITBNS-PAYLOAD","value":"{{payload}}","type":"text"},{"key":"X-BITBNS-SIGNATURE","value":"{{signature}}","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"Accept-Charset","value":"utf-8","type":"text"},{"key":"content-type","value":"application/x-www-form-urlencoded","type":"text"},{"key":"","value":"","type":"text","disabled":true}],"body":{"mode":"raw","raw":"{\"page\":0}","options":{"raw":{"language":"json"}}},"url":"https://api.bitbns.com/api/trade/v1/depositHistory/{{symbol}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 21 May 2020 09:05:24 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"46"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"ETag","value":"W/\"2e-Nv4yeXSJ/ujLvuHB6UKw/fsZyjU\""},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"cf-request-id","value":"02d814015800006acf25923200000001"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"596d22aef9336acf-BOM"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [],\n \"status\": 1,\n \"error\": null,\n \"code\": 204\n}"}],"_postman_id":"769528df-5c0b-46f8-8e07-fc565060a635"},{"name":"Withdrawl History","event":[{"listen":"prerequest","script":{"id":"8a0c6c3d-6d99-4cec-88de-5171068adba8","exec":["const timeStamp_nonce = Date.now().toString();","const body = JSON.parse(pm.request.body)","const secret = pm.environment.get(\"secret\");","const obj = {"," timeStamp_nonce: timeStamp_nonce,"," body: JSON.stringify(body)","};","const payload = new Buffer(JSON.stringify(obj)).toString('base64');","const signature = CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA512(payload, secret));","pm.environment.set(\"body\", JSON.stringify(body));","pm.environment.set(\"payload\", payload);","pm.environment.set(\"signature\", signature);"],"type":"text/javascript"}}],"id":"0cbb42d6-3f06-4cc9-ac8c-892feb25f9f0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-BITBNS-APIKEY","type":"text","value":"{{apiKey}}"},{"key":"X-BITBNS-PAYLOAD","type":"text","value":"{{payload}}"},{"key":"X-BITBNS-SIGNATURE","type":"text","value":"{{signature}}"},{"key":"Accept","type":"text","value":"application/json"},{"key":"Accept-Charset","type":"text","value":"utf-8"},{"key":"content-type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"raw","raw":"{\"page\":0}","options":{"raw":{"language":"json"}}},"url":"https://api.bitbns.com/api/trade/v1/withdrawHistory/{{symbol}}","description":"page: 0,1,2... for paginated response
\n","urlObject":{"protocol":"https","path":["api","trade","v1","withdrawHistory","{{symbol}}"],"host":["api","bitbns","com"],"query":[],"variable":[]}},"response":[{"id":"78ce4e2f-5692-4fda-b0c7-1566d96d1ec3","name":"Withdrawl History","originalRequest":{"method":"POST","header":[{"key":"X-BITBNS-APIKEY","type":"text","value":"{{apiKey}}"},{"key":"X-BITBNS-PAYLOAD","type":"text","value":"{{payload}}"},{"key":"X-BITBNS-SIGNATURE","type":"text","value":"{{signature}}"},{"key":"Accept","type":"text","value":"application/json"},{"key":"Accept-Charset","type":"text","value":"utf-8"},{"key":"content-type","type":"text","value":"application/x-www-form-urlencoded"},{"key":"","type":"text","value":"","disabled":true}],"body":{"mode":"raw","raw":"{\"page\":0}","options":{"raw":{"language":"json"}}},"url":"https://api.bitbns.com/api/trade/v1/withdrawHistory/{{symbol}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 21 May 2020 09:05:47 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"46"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"ETag","value":"W/\"2e-Nv4yeXSJ/ujLvuHB6UKw/fsZyjU\""},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"cf-request-id","value":"02d8145a0d00006acf258ae200000001"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"596d233cefdb6acf-BOM"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [],\n \"status\": 1,\n \"error\": null,\n \"code\": 204\n}"}],"_postman_id":"0cbb42d6-3f06-4cc9-ac8c-892feb25f9f0"},{"name":"List Open Orders","event":[{"listen":"prerequest","script":{"id":"2eb33853-6540-4ff4-8903-5007364b7794","exec":["const timeStamp_nonce = Date.now().toString();","const body = JSON.parse(pm.request.body)","const secret = pm.environment.get(\"secret\");","const obj = {"," timeStamp_nonce: timeStamp_nonce,"," body: JSON.stringify(body)","};","const payload = new Buffer(JSON.stringify(obj)).toString('base64');","const signature = CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA512(payload, secret));","pm.environment.set(\"body\", JSON.stringify(body));","pm.environment.set(\"payload\", payload);","pm.environment.set(\"signature\", signature);"],"type":"text/javascript"}}],"id":"d664d714-4c92-4e9e-bd72-3175419569c7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-BITBNS-APIKEY","type":"text","value":"{{apiKey}}"},{"key":"X-BITBNS-PAYLOAD","type":"text","value":"{{payload}}"},{"key":"X-BITBNS-SIGNATURE","type":"text","value":"{{signature}}"},{"key":"Accept","type":"text","value":"application/json"},{"key":"Accept-Charset","type":"text","value":"utf-8"},{"key":"content-type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"raw","raw":"{\"page\":0}","options":{"raw":{"language":"json"}}},"url":"https://api.bitbns.com/api/trade/v1/listOpenOrders/{{symbol}}","description":"page: 0,1,2... for paginated response
\n","urlObject":{"protocol":"https","path":["api","trade","v1","listOpenOrders","{{symbol}}"],"host":["api","bitbns","com"],"query":[],"variable":[]}},"response":[{"id":"17f53381-7ffc-4cc5-ba83-2240f463301e","name":"Withdrawl History Copy","originalRequest":{"method":"POST","header":[{"key":"X-BITBNS-APIKEY","type":"text","value":"{{apiKey}}"},{"key":"X-BITBNS-PAYLOAD","type":"text","value":"{{payload}}"},{"key":"X-BITBNS-SIGNATURE","type":"text","value":"{{signature}}"},{"key":"Accept","type":"text","value":"application/json"},{"key":"Accept-Charset","type":"text","value":"utf-8"},{"key":"content-type","type":"text","value":"application/x-www-form-urlencoded"},{"key":"","type":"text","value":"","disabled":true}],"body":{"mode":"raw","raw":"{\"page\":0}","options":{"raw":{"language":"json"}}},"url":"https://api.bitbns.com/api/trade/v1/listOpenOrders/{{symbol}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 21 May 2020 09:10:56 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"ETag","value":"W/\"3b-NWI7pt5ZHeHGU0SGsFEwewoPMnI\""},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"cf-request-id","value":"02d81913f700006acf25b74200000001"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"596d2accbb766acf-BOM"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [],\n \"status\": 1,\n \"error\": \"Nothing to show\",\n \"code\": 200\n}"}],"_postman_id":"d664d714-4c92-4e9e-bd72-3175419569c7"},{"name":"List Open Stop Loss Orders","event":[{"listen":"prerequest","script":{"id":"ff50ace5-6e95-4761-a7e1-730bb9bd7075","exec":["const timeStamp_nonce = Date.now().toString();","const body = JSON.parse(pm.request.body)","const secret = pm.environment.get(\"secret\");","const obj = {"," timeStamp_nonce: timeStamp_nonce,"," body: JSON.stringify(body)","};","const payload = new Buffer(JSON.stringify(obj)).toString('base64');","const signature = CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA512(payload, secret));","pm.environment.set(\"body\", JSON.stringify(body));","pm.environment.set(\"payload\", payload);","pm.environment.set(\"signature\", signature);"],"type":"text/javascript"}}],"id":"e0359699-1de4-45e2-b27e-d2a70842967e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-BITBNS-APIKEY","type":"text","value":"{{apiKey}}"},{"key":"X-BITBNS-PAYLOAD","type":"text","value":"{{payload}}"},{"key":"X-BITBNS-SIGNATURE","type":"text","value":"{{signature}}"},{"key":"Accept","type":"text","value":"application/json"},{"key":"Accept-Charset","type":"text","value":"utf-8"},{"key":"content-type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"raw","raw":"{\"page\":0}","options":{"raw":{"language":"json"}}},"url":"https://api.bitbns.com/api/trade/v1/listOpenStopOrders/{{symbol}}","description":"page: 0,1,2... for paginated response
\n","urlObject":{"protocol":"https","path":["api","trade","v1","listOpenStopOrders","{{symbol}}"],"host":["api","bitbns","com"],"query":[],"variable":[]}},"response":[{"id":"76490942-c397-435d-9b6b-2daabd261a21","name":"List Open Stop Loss Orders","originalRequest":{"method":"POST","header":[{"key":"X-BITBNS-APIKEY","type":"text","value":"{{apiKey}}"},{"key":"X-BITBNS-PAYLOAD","type":"text","value":"{{payload}}"},{"key":"X-BITBNS-SIGNATURE","type":"text","value":"{{signature}}"},{"key":"Accept","type":"text","value":"application/json"},{"key":"Accept-Charset","type":"text","value":"utf-8"},{"key":"content-type","type":"text","value":"application/x-www-form-urlencoded"},{"key":"","type":"text","value":"","disabled":true}],"body":{"mode":"raw","raw":"{\"page\":0}","options":{"raw":{"language":"json"}}},"url":"https://api.bitbns.com/api/trade/v1/listOpenStopOrders/{{symbol}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 21 May 2020 09:10:36 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"ETag","value":"W/\"3b-NWI7pt5ZHeHGU0SGsFEwewoPMnI\""},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"cf-request-id","value":"02d818c43c00006acf25bda200000001"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"596d2a4d2d416acf-BOM"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [],\n \"status\": 1,\n \"error\": \"Nothing to show\",\n \"code\": 200\n}"}],"_postman_id":"e0359699-1de4-45e2-b27e-d2a70842967e"},{"name":"Get Specify Crypto Coin Address [Coins Without Tag]","event":[{"listen":"prerequest","script":{"id":"e72ab0bd-5168-4e70-8d66-44386e42f6ac","exec":["const timeStamp_nonce = Date.now().toString();","const body = JSON.parse(pm.request.body)","const secret = pm.environment.get(\"secret\");","const obj = {"," timeStamp_nonce: timeStamp_nonce,"," body: JSON.stringify(body)","};","const payload = new Buffer(JSON.stringify(obj)).toString('base64');","const signature = CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA512(payload, secret));","pm.environment.set(\"body\", JSON.stringify(body));","pm.environment.set(\"payload\", payload);","pm.environment.set(\"signature\", signature);"],"type":"text/javascript"}}],"id":"59520593-1dc6-4067-a63a-33b669d22569","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-BITBNS-APIKEY","type":"text","value":"{{apiKey}}"},{"key":"X-BITBNS-PAYLOAD","type":"text","value":"{{payload}}"},{"key":"X-BITBNS-SIGNATURE","type":"text","value":"{{signature}}"},{"key":"Accept","type":"text","value":"application/json"},{"key":"Accept-Charset","type":"text","value":"utf-8"},{"key":"content-type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://api.bitbns.com/api/trade/v1/getCoinAddress/{{symbol}}","urlObject":{"protocol":"https","path":["api","trade","v1","getCoinAddress","{{symbol}}"],"host":["api","bitbns","com"],"query":[],"variable":[]}},"response":[{"id":"73809b3a-79f0-46dd-8350-1701d04c9e0d","name":"Get Specify Crypto Coin Address [Coins Without Tag]","originalRequest":{"method":"POST","header":[{"key":"X-BITBNS-APIKEY","type":"text","value":"{{apiKey}}"},{"key":"X-BITBNS-PAYLOAD","type":"text","value":"{{payload}}"},{"key":"X-BITBNS-SIGNATURE","type":"text","value":"{{signature}}"},{"key":"Accept","type":"text","value":"application/json"},{"key":"Accept-Charset","type":"text","value":"utf-8"},{"key":"content-type","type":"text","value":"application/x-www-form-urlencoded"},{"key":"","type":"text","value":"","disabled":true}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://api.bitbns.com/api/trade/v1/getCoinAddress/{{symbol}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 21 May 2020 09:19:58 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"ETag","value":"W/\"6e-2XQYk1/t8MeATtzwZJeNVzB92Kg\""},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"596d3804aec37351-BOM"},{"key":"Content-Encoding","value":"gzip"},{"key":"cf-request-id","value":"02d82156ea00007351e488c200000001"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"token\": \"39tgHxA8RSqDfAiiiAPK5iaGqupt7kyAeC\",\n \"expiry\": \"2020-05-21 14:49:58\"\n },\n \"status\": 1,\n \"error\": null\n}"}],"_postman_id":"59520593-1dc6-4067-a63a-33b669d22569"},{"name":"Get Specify Crypto Coin Address [Coins With Tag]","event":[{"listen":"prerequest","script":{"id":"4bd91279-0dec-4636-a0c2-03f7cb8fbd3e","exec":["const timeStamp_nonce = Date.now().toString();","const body = JSON.parse(pm.request.body)","const secret = pm.environment.get(\"secret\");","const obj = {"," timeStamp_nonce: timeStamp_nonce,"," body: JSON.stringify(body)","};","const payload = new Buffer(JSON.stringify(obj)).toString('base64');","const signature = CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA512(payload, secret));","pm.environment.set(\"body\", JSON.stringify(body));","pm.environment.set(\"payload\", payload);","pm.environment.set(\"signature\", signature);"],"type":"text/javascript"}}],"id":"ee7e7236-1d63-4cd1-b503-d6de0eac9f0f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-BITBNS-APIKEY","type":"text","value":"{{apiKey}}"},{"key":"X-BITBNS-PAYLOAD","type":"text","value":"{{payload}}"},{"key":"X-BITBNS-SIGNATURE","type":"text","value":"{{signature}}"},{"key":"Accept","type":"text","value":"application/json"},{"key":"Accept-Charset","type":"text","value":"utf-8"},{"key":"content-type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://api.bitbns.com/api/trade/v1/getCoinAddress/{{symbol}}","urlObject":{"protocol":"https","path":["api","trade","v1","getCoinAddress","{{symbol}}"],"host":["api","bitbns","com"],"query":[],"variable":[]}},"response":[{"id":"f4997ab5-e3cd-408a-aac5-bdc9372737b5","name":"Get Specify Crypto Coin Address [Coins With Tag] Copy","originalRequest":{"method":"POST","header":[{"key":"X-BITBNS-APIKEY","type":"text","value":"{{apiKey}}"},{"key":"X-BITBNS-PAYLOAD","type":"text","value":"{{payload}}"},{"key":"X-BITBNS-SIGNATURE","type":"text","value":"{{signature}}"},{"key":"Accept","type":"text","value":"application/json"},{"key":"Accept-Charset","type":"text","value":"utf-8"},{"key":"content-type","type":"text","value":"application/x-www-form-urlencoded"},{"key":"","type":"text","value":"","disabled":true}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://api.bitbns.com/api/trade/v1/getCoinAddress/{{symbol}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 21 May 2020 09:20:43 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"ETag","value":"W/\"7f-/O21HvH66V2NY6l5VlxQr8EhL34\""},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"596d391c2f1f7351-BOM"},{"key":"Content-Encoding","value":"gzip"},{"key":"cf-request-id","value":"02d822059c00007351e48f2200000001"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"token\": \"GAVQNY45FBHSN5MEPLAF56U7VDCBDG54TQFGJSS2CRPZTWD3CSHP4YPU\",\n \"tag\": \"188562\"\n },\n \"status\": 1,\n \"error\": null,\n \"code\": 200\n}"}],"_postman_id":"ee7e7236-1d63-4cd1-b503-d6de0eac9f0f"},{"name":"Place Sell Order","event":[{"listen":"prerequest","script":{"id":"08124fe6-206a-443a-9243-0dbe3ced459c","exec":["const timeStamp_nonce = Date.now().toString();","const body = JSON.parse(pm.request.body)","const secret = pm.environment.get(\"secret\");","const obj = {"," timeStamp_nonce: timeStamp_nonce,"," body: JSON.stringify(body)","};","const payload = new Buffer(JSON.stringify(obj)).toString('base64');","const signature = CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA512(payload, secret));","pm.environment.set(\"body\", JSON.stringify(body));","pm.environment.set(\"payload\", payload);","pm.environment.set(\"signature\", signature);"],"type":"text/javascript"}}],"id":"c00b1e7c-49bc-4f99-8a2e-063757bb668f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-BITBNS-APIKEY","type":"text","value":"{{apiKey}}"},{"key":"X-BITBNS-PAYLOAD","type":"text","value":"{{payload}}"},{"key":"X-BITBNS-SIGNATURE","type":"text","value":"{{signature}}"},{"key":"Accept","type":"text","value":"application/json"},{"key":"Accept-Charset","type":"text","value":"utf-8"},{"key":"content-type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"raw","raw":"{\"quantity\":0.001,\"rate\":\"800000\"}","options":{"raw":{"language":"json"}}},"url":"https://api.bitbns.com/api/trade/v1/placeSellOrder/{{symbol}}","description":"quantity: Coin Quantity to sell
rate: Sell Price
quantity: Coin Quantity to buy
rate: Buy Price
quantity: Coin Quantity to buy
rate: Buy Price
t_rate: Trigger Price
quantity: Coin Quantity to sell
rate: Sell Price
t_rate: Trigger Price
entry_id: Order ID
\n","urlObject":{"protocol":"https","path":["api","trade","v1","cancelOrder","{{symbol}}"],"host":["api","bitbns","com"],"query":[],"variable":[]}},"response":[{"id":"eb1456b4-a750-4cb2-93f1-992fec312179","name":"Cancel Order","originalRequest":{"method":"POST","header":[{"key":"X-BITBNS-APIKEY","type":"text","value":"{{apiKey}}"},{"key":"X-BITBNS-PAYLOAD","type":"text","value":"{{payload}}"},{"key":"X-BITBNS-SIGNATURE","type":"text","value":"{{signature}}"},{"key":"Accept","type":"text","value":"application/json"},{"key":"Accept-Charset","type":"text","value":"utf-8"},{"key":"content-type","type":"text","value":"application/x-www-form-urlencoded"},{"key":"","type":"text","value":"","disabled":true}],"body":{"mode":"raw","raw":"{\"entry_id\":2934659}","options":{"raw":{"language":"json"}}},"url":"https://api.bitbns.com/api/trade/v1/cancelOrder/{{symbol}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 21 May 2020 09:31:34 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"ETag","value":"W/\"4e-AX7Vcvj4hZ42SA7/dvghKia4p2M\""},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"596d4905dd5b7351-BOM"},{"key":"Content-Encoding","value":"gzip"},{"key":"cf-request-id","value":"02d82bf7a300007351e4bb8200000001"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": \"Successfully cancelled the order\",\n \"status\": 1,\n \"error\": null,\n \"code\": 200\n}"}],"_postman_id":"46572663-569f-445e-b16f-3df62783aac1"},{"name":"Cancel Stop Loss Order","event":[{"listen":"prerequest","script":{"id":"7b99ba4c-cf9c-46a4-93dc-9cf5ecfc7624","exec":["const timeStamp_nonce = Date.now().toString();","const body = JSON.parse(pm.request.body)","const secret = pm.environment.get(\"secret\");","const obj = {"," timeStamp_nonce: timeStamp_nonce,"," body: JSON.stringify(body)","};","const payload = new Buffer(JSON.stringify(obj)).toString('base64');","const signature = CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA512(payload, secret));","pm.environment.set(\"body\", JSON.stringify(body));","pm.environment.set(\"payload\", payload);","pm.environment.set(\"signature\", signature);"],"type":"text/javascript"}}],"id":"596f6035-1d39-4a89-9e5d-f4abec6a505e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-BITBNS-APIKEY","type":"text","value":"{{apiKey}}"},{"key":"X-BITBNS-PAYLOAD","type":"text","value":"{{payload}}"},{"key":"X-BITBNS-SIGNATURE","type":"text","value":"{{signature}}"},{"key":"Accept","type":"text","value":"application/json"},{"key":"Accept-Charset","type":"text","value":"utf-8"},{"key":"content-type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"raw","raw":"{\"entry_id\":2934659}","options":{"raw":{"language":"json"}}},"url":"https://api.bitbns.com/api/trade/v1/cancelStopLossOrder/{{symbol}}","description":"entry_id: Order ID
\n","urlObject":{"protocol":"https","path":["api","trade","v1","cancelStopLossOrder","{{symbol}}"],"host":["api","bitbns","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"596f6035-1d39-4a89-9e5d-f4abec6a505e"},{"name":"List Executed Orders","event":[{"listen":"prerequest","script":{"id":"aeaef594-a6cf-4c98-a4ed-dea4a6836fcf","exec":["const timeStamp_nonce = Date.now().toString();","const body = JSON.parse(pm.request.body)","const secret = pm.environment.get(\"secret\");","const obj = {"," timeStamp_nonce: timeStamp_nonce,"," body: JSON.stringify(body)","};","const payload = new Buffer(JSON.stringify(obj)).toString('base64');","const signature = CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA512(payload, secret));","pm.environment.set(\"body\", JSON.stringify(body));","pm.environment.set(\"payload\", payload);","pm.environment.set(\"signature\", signature);"],"type":"text/javascript"}}],"id":"08419d5a-e82b-4883-935c-96f3c018f558","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-BITBNS-APIKEY","type":"text","value":"{{apiKey}}"},{"key":"X-BITBNS-PAYLOAD","type":"text","value":"{{payload}}"},{"key":"X-BITBNS-SIGNATURE","type":"text","value":"{{signature}}"},{"key":"Accept","type":"text","value":"application/json"},{"key":"Accept-Charset","type":"text","value":"utf-8"},{"key":"content-type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"raw","raw":"{\"page\":0,\"since\":\"2020-05-01T00:00:00Z\"}","options":{"raw":{"language":"json"}}},"url":"https://api.bitbns.com/api/trade/v1/listExecutedOrders/{{symbol}}","description":"page: 0,1,2... For paginated response
since: Date since which orders are fetched
This is the first version of the bitbns API released.\nSince then, Version 2 has been released with added support for new features, but version 1 is not deprecated and continues to be operational.
\nside -> BUY or SELL
symbol -> COIN NAME (use suffix \"_USDT\" with coin name)
quantity -> QUANTITY
rate -> RATE
target_rate -> TARGET RATE
t_rate -> TRRIGER RATE
trail_rate -> TRAIL RATE
side -> BUY or SELL
symbol -> COIN NAME (use suffix \"_USDT\" with coin name)
quantity -> QUANTITY
rate -> RATE
target_rate -> TARGET RATE
t_rate -> TRRIGER RATE
trail_rate -> TRAIL RATE
side -> BUY or SELL
symbol -> COIN NAME (use suffix \"_USDT\" with coin name)
quantity -> QUANTITY
rate -> RATE
target_rate -> TARGET RATE
t_rate -> TRRIGER RATE
trail_rate -> TRAIL RATE
side -> cancelOrder (for INR markets) or usdtcancelOrder (for USDT markets)
symbol -> COIN NAME (use suffix \"_USDT\" with coin name)
entry_id -> order ID
side -> cancelStopLossOrder (for INR markets) or usdtcancelStopLossOrder (for USDT markets)
symbol -> COIN NAME (use suffix \"_USDT\" with coin name)
entry_id -> order ID
side -> listOpenOrders (for INR markets) or usdtListOpenOrders (for USDT markets)
symbol -> COIN NAME (use suffix \"_USDT\" with coin name for USDT markets)
side -> listOpenStopOrders (for INR markets) or usdtListOpenStopOrders (for USDT markets)
symbol -> COIN NAME (use suffix \"_USDT\" with coin name for USDT markets)
side -> listOpenBracketOrders (for INR markets) or usdtListOpenBracketOrders (for USDT markets)
symbol -> COIN NAME (use suffix \"_USDT\" with coin name for USDT markets)
type -> BORROW or LEND
days -> 1,3,7,15,30
renew -> 0,1,2
symbol -> COIN NAME
qnty -> QUANTITY
rate -> RATE
id -> order ID
\n","urlObject":{"protocol":"https","path":["api","trade","v2","marginOrders",""],"host":["api","bitbns","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"c74fddfa-56df-47b2-8990-2639ef78b094"},{"name":"Partially Settle Margin Order","event":[{"listen":"prerequest","script":{"id":"3b93ad48-e337-4b14-9a1f-90881bf5e62a","exec":["const timeStamp_nonce = Date.now().toString();","const body = JSON.parse(pm.request.body)","const secret = pm.environment.get(\"secret\");","const obj = {"," timeStamp_nonce: timeStamp_nonce,"," body: JSON.stringify(body)","};","const payload = new Buffer(JSON.stringify(obj)).toString('base64');","const signature = CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA512(payload, secret));","pm.environment.set(\"body\", JSON.stringify(body));","pm.environment.set(\"payload\", payload);","pm.environment.set(\"signature\", signature);"],"type":"text/javascript"}}],"id":"66b5003a-e64e-4318-8df9-de71f3272f64","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-BITBNS-APIKEY","type":"text","value":"{{apiKey}}"},{"key":"X-BITBNS-PAYLOAD","type":"text","value":"{{payload}}"},{"key":"X-BITBNS-SIGNATURE","type":"text","value":"{{signature}}"},{"key":"Accept","type":"text","value":"application/json"},{"key":"Accept-Charset","type":"text","value":"utf-8"},{"key":"content-type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"raw","raw":"{\"id\":\"123456\",\"side\":\"settleMarginOrderPartial\",\"symbol\":\"BTC\",\"amt\":\"0.001\"}","options":{"raw":{"language":"json"}}},"url":"https://api.bitbns.com/api/trade/v2/marginOrders/","description":"id -> order ID
\n","urlObject":{"protocol":"https","path":["api","trade","v2","marginOrders",""],"host":["api","bitbns","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"66b5003a-e64e-4318-8df9-de71f3272f64"},{"name":"Margin Orderbook","event":[{"listen":"prerequest","script":{"id":"4e59d9c3-1719-4e13-9ebd-2ff8e617a00f","exec":["const timeStamp_nonce = Date.now().toString();","const body = JSON.parse(pm.request.body)","const secret = pm.environment.get(\"secret\");","const obj = {"," timeStamp_nonce: timeStamp_nonce,"," body: JSON.stringify(body)","};","const payload = new Buffer(JSON.stringify(obj)).toString('base64');","const signature = CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA512(payload, secret));","pm.environment.set(\"body\", JSON.stringify(body));","pm.environment.set(\"payload\", payload);","pm.environment.set(\"signature\", signature);"],"type":"text/javascript"}}],"id":"9ef7a077-b3d5-4747-bfbf-073e0a6ef416","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-BITBNS-APIKEY","type":"text","value":"{{apiKey}}"},{"key":"X-BITBNS-PAYLOAD","type":"text","value":"{{payload}}"},{"key":"X-BITBNS-SIGNATURE","type":"text","value":"{{signature}}"},{"key":"Accept","type":"text","value":"application/json"},{"key":"Accept-Charset","type":"text","value":"utf-8"},{"key":"content-type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"raw","raw":"{\"symbol\":\"BTC\",\"side\":\"listMarketOrders\",\"type\":\"LEND\"}","options":{"raw":{"language":"json"}}},"url":"https://api.bitbns.com/api/trade/v2/marginOrders/","description":"type -> BORROW or LEND
symbol -> COIN NAME
type -> BORROW or LEND
symbol -> COIN NAME
page -> for paginated response
type -> BORROW or LEND
symbol -> COIN NAME
page -> for paginated response
symbol -> COIN NAME
page -> for paginated response