Request Quote

POST🔒 Trading

⚡ Orders: 75 req/s per endpoint · 75 req/s per user

tip

Try It Out — test this endpoint in the API Explorer

Request a quote for an OTC order. Requires the Trading permission.

Choose either baseSize or quoteSize to submit — these two parameters cannot be sent at the same time.

Important: A new quote expires after 6 seconds. Accept it before expiry.

Request Parameters

Name	Type	Required	Description
side	String	Yes	Transaction side — BUY · SELL
baseCurrency	String	Yes	Base currency
quoteCurrency	String	Yes	Quote currency
baseSize	String	No	Size in baseCurrency. Mutually exclusive with quoteSize.
quoteSize	String	No	Size in quoteCurrency. Mutually exclusive with baseSize.
clOrderId	String	No	Client order ID assigned by the client

Response Content

Successful response

example

POSThttps://api.btse.com/public-api/otc/v1/quotes

Request (Buy)

{
  "side": "BUY",
  "baseCurrency": "BTC",
  "quoteCurrency": "USDT",
  "baseSize": "15.0",
  "clOrderId": "test-0001"
}

Request (Buy (with quote size))

{
  "side": "BUY",
  "baseCurrency": "BTC",
  "quoteCurrency": "USDT",
  "quoteSize": "340000.0",
  "clOrderId": "test-0002"
}

Request (Sell)

{
  "side": "SELL",
  "baseCurrency": "BTC",
  "quoteCurrency": "ETH",
  "baseSize": "15.0",
  "clOrderId": "test-0003"
}

Request (Sell (with quote size))

{
  "side": "SELL",
  "baseCurrency": "BTC",
  "quoteCurrency": "ETH",
  "quoteSize": "300.0",
  "clOrderId": "test-0004"
}

Response (Buy)

{
  "success": true,
  "code": 1,
  "msg": "Success",
  "time": 1673325777227,
  "data": {
    "quoteId": "0001-0001-0001-0001",
    "clOrderId": "test-0001",
    "side": "BUY",
    "baseSize": "15.0",
    "baseCurrency": "BTC",
    "quoteSize": "257735.09868",
    "quoteCurrency": "USDT",
    "ratio": "17182.33991211",
    "expireTime": 1673325783227,
    "ttl": 6,
    "status": "NEW_QUOTE"
  }
}

Response (Sell (with quote size))

{
  "success": true,
  "code": 1,
  "msg": "Success",
  "time": 1673325777227,
  "data": {
    "quoteId": "0004-0004-0004-0004",
    "clOrderId": "test-0004",
    "side": "SELL",
    "baseSize": "23.0325468695",
    "baseCurrency": "BTC",
    "quoteSize": "300.0",
    "quoteCurrency": "ETH",
    "ratio": "13.025046761",
    "expireTime": 1673325783227,
    "ttl": 6,
    "status": "NEW_QUOTE"
  }
}