BitVest API Documentation

Welcome to the BitVest Developer Platform. Our API provides programmatic access to all market data, trading, and account management features.

Base URL

https://api.bitvest.pro/api/v1

Rate Limits

Public endpoints: 10 req/sec
Private endpoints: 50 req/sec

Authentication

Private endpoints require authentication using an API Key and Secret. You can generate these in your Dashboard Settings.

Headers

HeaderDescription
X-MBX-APIKEYYour unique API Key.
X-MBX-SIGNATUREHMAC SHA256 signature of your query string.

Market Data

GET

24hr Ticker Price Change

/api/v1/ticker/24hr

Get 24-hour rolling window price change statistics for all symbols.

Parameters

symbolstring

Trading pair symbol (e.g. BTCUSDT)

Response

[
  {
    "symbol": "BTCUSDT",
    "priceChange": "-94.99000000",
    "priceChangePercent": "-0.095",
    "lastPrice": "98420.50000000",
    "volume": "12405.34000000"
  }
]
GET

Order Book

/api/v1/depth

Get current order book snapshot.

Parameters

symbolstring

Trading pair symbol

* Required
limitinteger

Default 100; max 5000.

Response

{
  "lastUpdateId": 1027024,
  "bids": [
    [ "4.00000000", "431.00000000" ]
  ],
  "asks": [
    [ "4.00000200", "12.00000000" ]
  ]
}
GET

Candlestick Data

/api/v1/klines

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

Parameters

symbolstring

Trading pair symbol

* Required
intervalenum

1m, 5m, 1h, 4h, 1d, 1w

* Required
limitinteger

Default 500; max 1000.

Response

[
  [
    1499040000000,      // Open time
    "0.01634790",       // Open
    "0.80000000",       // High
    "0.01575800",       // Low
    "0.01577100",       // Close
    "148976.11427815",  // Volume
    1499644799999,      // Close time
  ]
]
GET

Recent Trades

/api/v1/trades

Get recent trades list.

Parameters

symbolstring

Trading pair symbol

* Required
limitinteger

Default 500; max 1000.

Response

[
  {
    "id": 28457,
    "price": "4.00000100",
    "qty": "12.00000000",
    "time": 1499865549590,
    "isBuyerMaker": true,
    "isBestMatch": true
  }
]

Trading & Account

POST

New Order

/api/v1/order

Send in a new order. Requires API Key signature.

Parameters

symbolstring

Trading pair symbol

* Required
sideenum

BUY or SELL

* Required
typeenum

LIMIT, MARKET, STOP_LOSS

* Required
quantitydecimal

Order quantity

* Required
pricedecimal

Required for LIMIT orders

Response

{
  "symbol": "BTCUSDT",
  "orderId": 28,
  "clientOrderId": "6gCrw2kRUAF9CvJDGP16IP",
  "transactTime": 1507725176595,
  "price": "1.00000000",
  "origQty": "10.00000000",
  "executedQty": "10.00000000",
  "status": "FILLED",
  "type": "MARKET",
  "side": "SELL"
}
GET

Query Order

/api/v1/order

Check an order's status.

Parameters

symbolstring

Trading pair symbol

* Required
orderIdlong

Order ID

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",
  "time": 1499827319559
}
DELETE

Cancel Order

/api/v1/order

Cancel an active order.

Parameters

symbolstring

Trading pair symbol

* Required
orderIdlong

Order ID

Response

{
  "symbol": "LTCBTC",
  "origClientOrderId": "myOrder1",
  "orderId": 1,
  "status": "CANCELED"
}
GET

Account Information

/api/v1/account

Get current account information and balances.

Parameters

No parameters required.

Response

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