Accept 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

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

After requesting a quote with baseSize, you can use baseSize to partially accept the quote. Likewise, you can use quoteSize to partially accept a quote that was requested with quoteSize.

In any of the scenarios below, the original baseSize and quoteSize will be accepted in full without any message:

1. Send neither baseSize nor quoteSize.
2. Send baseSize higher than the quoted amount.
3. Send quoteSize higher than the quoted amount.
4. Send baseSize when the quote was requested with quoteSize.
5. Send quoteSize when the quote was requested with baseSize.

Request Parameters

Name	Type	Required	Description
quoteId	String	Yes	Quote ID returned from Request Quote
baseSize	String	No	Partial baseCurrency amount to accept. Omit both baseSize and quoteSize to accept the full quoted amount.
quoteSize	String	No	Partial quoteCurrency amount to accept. Omit both baseSize and quoteSize to accept the full quoted amount.

Response Content

Name	Type	Description
quoteId	String	Quote ID
clOrderId	String	Client order ID assigned by the client
side	String	Transaction side — BUY · SELL
baseSize	String	Size in baseCurrency. Max 8 decimal places when side=BUY; max 9 decimal places when side=SELL.
baseCurrency	String	Base currency
quoteSize	String	Size in quoteCurrency. Max 9 decimal places when side=BUY; max 8 decimal places when side=SELL.
quoteCurrency	String	Quote currency
ratio	String	How many quoteCurrency per one baseCurrency (quoteSize / baseSize). Max 10 decimal places.
status	String	Quote status — NEW_QUOTE · REQUOTE · COMPLETED · EXPIRED
expireTime	Double	Expiration timestamp (Unix ms)
ttl	Double	Time to live in seconds

example

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

Request (Common)

{
  "quoteId": "0001-0001-0001-0001"
}

Request (Accept with specified baseSize)

{
  "quoteId": "0003-0003-0003-0003",
  "baseSize": "10.0"
}

Request (Accept with specified quoteSize)

{
  "quoteId": "0004-0004-0004-0004",
  "quoteSize": "200.0"
}

Response (Common)

{
  "success": true,
  "code": 1,
  "msg": "Success",
  "time": 1673325778012,
  "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,
    "status": "COMPLETED"
  }
}

Response (Accept with specified baseSize)

{
  "success": true,
  "code": 1,
  "msg": "Success",
  "time": 1673325777227,
  "data": {
    "quoteId": "0003-0003-0003-0003",
    "clOrderId": "test-0003",
    "side": "SELL",
    "baseSize": "10.0",
    "baseCurrency": "BTC",
    "quoteSize": "130.25046761",
    "quoteCurrency": "ETH",
    "ratio": "13.025046761",
    "expireTime": 1673325783227,
    "status": "COMPLETED"
  }
}

Response (Accept with specified quoteSize)

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

Response (Accept but expired or ratio change)

{
  "success": true,
  "code": 1,
  "msg": "Success",
  "time": 1673506479119,
  "data": {
    "quoteId": "2000-2000-2000-2000",
    "clOrderId": "test-0002",
    "side": "BUY",
    "baseSize": "18.624803705",
    "baseCurrency": "BTC",
    "quoteSize": "340000.0",
    "quoteCurrency": "USDT",
    "ratio": "18255.225955",
    "expireTime": 1673506485119,
    "ttl": 6,
    "status": "REQUOTE"
  }
}