Request a quote

Requests a quote for a specific quantity of a specific asset.

The side parameter indicates whether you want to buy or sell the baseAsset.

For example, if you request a quote with side = BUY, baseAsset= "BTC", quoteAsset = "USD" and baseAssetQty = 2, the returned quote contains the price of buying 2 units of BTC in exchange for USD.

If you request a quote with side = SELL, baseAsset = "BTC", quoteAsset = "USD", and quoteAssetQty = 100000, the returned quote contains the the number of units of BTC you need to sell to buy 100000 units of USD.

If you request a quote with side = TWO_WAY, baseAsset = "BTC", quoteAsset = "USD" and baseAssetQty = 2, the returned quote contains price of buying 2 units of BTC in exchange for USD and the price of selling 2 units of BTC in exchange for USD.

SecurityBearerAuth
Request
Request Body schema: application/json
baseAsset
required
string

The unique symbol of a digital asset that the end user wants to buy or sell. Note: The value of this field must not be USD.

quoteAsset
required
string

The unique symbol of an asset that the end user wants to buy or sell. Note: The value of this field must be USD.

baseAssetQty
string

The number of units of baseAsset that the end user wants to buy or sell. Specify either baseAssetQty or quoteAssetQty.

quoteAssetQty
string

The number of units of quoteAsset that the end user wants to buy or sell. Specify either baseAssetQty or quoteAssetQty.

side
required
string

Indicates whether to BUY or SELL the baseAsset. Allowed values are BUY, SELL, and TWO_WAY.

Enum: "TWO_WAY" "BUY" "SELL"
endUserGuid
string <uuid>

A unique identifier associated with the end user. Used for reconciliation purposes and supplied by the customer.

Responses
200
400

Bad request

403

Forbidden

404

Not found

500

Internal server error

post/quotes/request
Request samples
application/json
{
  • "baseAsset": "BTC",
  • "quoteAsset": "USD",
  • "side": "BUY",
  • "baseAssetQty": "1.00000000"
}
Response samples
application/json
{
  • "quoteId": "fd5dbe64-a96e-4e1c-9843-75cd6b0cdb60",
  • "requestedAt": "2021-01-01T01:00:30.000Z",
  • "createdAt": "2021-01-01T01:00:32.000Z",
  • "bidPrice": null,
  • "offerPrice": "62289.42",
  • "baseAsset": "BTC",
  • "quoteAsset": "USD",
  • "baseAssetQty": "1.00000000",
  • "quoteAssetQty": "62289.42",
  • "side": "BUY",
  • "expiresAt": "2021-01-01T01:10:00.000Z",
  • "endUserGuid": "669ce446-22d0-11ec-9621-0242ac130002",
  • "fundSource": "FUNDED"
}