OTC

Over the counter (OTC) purchases or Vaultoro Direct within the dashboard allow you to buy and sell assets quickly at market rates.

post
Create Quote

https://api.vaultoro.com/v1/private/orders/quote
This endpoint allows you to fetch a BUY/SELL quote for a pair before committing to the purchase. Your quote price will be valid for 30 seconds from the time of request. You can send in a quantity or total with your request. The quantity represents the amount of the baseHandle you wish to buy or sell. And the total is the total to spend. For example, you want to buy GOLD with BTC. Sending in quantity 1 - you're getting 1 gram of Gold for BTC. However, if you send in the total value, your quote will assume you want to spend 1 BTC.
Request
Response
Request
Headers
VTOKEN
required
string
Vaultoro API token
Query Parameters
total
optional
string
Optional - the total to spend. This field overrides the quantity field.
quantity
optional
string
The quantity field represents the amount of the asset you wish to buy. For more information, please refer to the details above. This field is required unless the total is sent.
pair
required
string
The pair you wish to retrieve a quote for. Currently supported pairs include GOLDBTC and GOLDDASH.
type
required
string
The type of quote you require pricing for. Either BUY or SELL.
Response
200: OK
Quote successfully retrieved.
{
"createdAt": 1606134063,
"expires": 1606134123,
"pair": "GOLDBTC",
"price": "0.00331377",
"quantity": "301.77109455",
"total": "1.00000000",
"type": "BUY"
}

post
Create OTC Order

https://api.vaultoro.com/v1/private/orders
Placing an OTC order is the same as placing a regular order however you must change the matchType to OTC.
Request
Response
Request
Headers
VTOKEN
required
string
Vaultoro API Token
Query Parameters
matchType
required
string
Must be OTC
quantity
optional
string
The quantity field represents the amount of the asset you wish to buy. For more information, please refer to the details above.
type
required
string
The type of quote you require pricing for. Either BUY or SELL.
pair
required
string
The pair you wish to retrieve a quote for. Currently supported pairs include GOLDBTC and GOLDDASH
Response
200: OK
OTC order successfully placed
{
"data": {
"result": {
"createdAt": 1606134322,
"matchType": "OTC",
"price": "0.00316771",
"quantity": "0.50000000",
"referenceId": "d4r2wafqkhuiwmgk",
"total": "0.00158385",
"type": "SELL"
}
}
}