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/otc
This OTC 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
match
required
string
'spend' or 'receive'
quantity
required
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.
{
"data":{
"pair":"GOLDBTC",
"quantity":"0.5",
"quoteID":"e9b2d55e-f8b9-422f-b391-fb9287d9b171",
"type":"BUY",
"match":"spend",
"ticker":"0.00139808",
"expires":1629986181
}
}

post
Create OTC Order

https://api.vaultoro.com/v1/private/orders/otc
Call the same endpoint with the quoteID returned in the previous call to confirm the order. Without the quoteID, a new quote will be created.
Request
Response
Request
Headers
VTOKEN
required
string
Vaultoro API Token
Body Parameters
quoteID
optional
string
Enter a quoteID for a previously created quote.
type
required
string
The type of quote, BUY or SELL.
quantity
required
string
The quantity field represents the amount of asset you wish to buy.
match
required
string
'spend' or 'receive'
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": {
"referenceId":"7452336d-3567-4e10-b482-a1cec04897dc",
"createdAt":1629986429,
"matchType":"OTC",
"price":"0.00139737",
"quantity":"5",
"type":"BUY",
"pair":"GOLD:BTC"
}
}
}