Skip to main content
POST
/
public
/
v1
/
orders
/
quote
Get Order Quote
curl --request POST \
  --url https://api.pro.daya.co/public/v1/orders/quote \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --data '
{
  "symbol": "<string>",
  "side": "<string>",
  "type": "<string>",
  "price": "<string>",
  "quantity": "<string>"
}
'
{
  "success": true,
  "message": "Order quote retrieved successfully",
  "data": {
    "symbol": "USD-NGN",
    "side": "buy",
    "type": "market",
    "quantity": "100.00",
    "estimated_price": "1545.50",
    "estimated_total": "154550.00",
    "estimated_fee": "0.15455000"
  },
  "timestamp": "2024-01-15T10:35:00Z"
}

​
Overview

Get an estimated price quote for an order without actually placing it. This is useful for previewing the expected execution price and fees before committing to a trade. This endpoint requires authentication with an API key that has Trade scope.

​
Authentication

​
X-Api-Key
string
required
Your API key with Trade scope
X-Api-Key: daya_sk_YOUR_API_KEY

​
Request Body

​
symbol
string
required
Trading pair symbolExample: USDT-NGNAllowed values: USDT-NGN, USDC-NGN, USD-NGN
​
side
string
required
Order sideAllowed values: buy, sell
​
type
string
required
Order typeAllowed values: limit, market
​
price
string
Order price (required for limit orders)Example: 1545.00
Required when type is limit. Not allowed for market orders.
​
quantity
string
required
Order quantity in base assetExample: 100.00

​
Request Examples

curl --request POST \
  --url https://api.pro.daya.co/public/v1/orders/quote \
  --header 'X-Api-Key: daya_sk_YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "symbol": "USDT-NGN",
    "side": "buy",
    "type": "market",
    "quantity": "100.00"
  }'

​
Response

​
success
boolean
required
Indicates if the request was successful
​
message
string
required
Human-readable response message
​
data
object
required
Order quote details
​
timestamp
string
ISO 8601 timestamp of the response

​
Success Response

{
  "success": true,
  "message": "Order quote retrieved successfully",
  "data": {
    "symbol": "USD-NGN",
    "side": "buy",
    "type": "market",
    "quantity": "100.00",
    "estimated_price": "1545.50",
    "estimated_total": "154550.00",
    "estimated_fee": "0.15455000"
  },
  "timestamp": "2024-01-15T10:35:00Z"
}

​
Error Responses

{
  "success": false,
  "message": "Validation error",
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Quantity is required"
  },
  "timestamp": "2024-01-15T10:35:00Z"
}

​
Notes

  • Quotes are estimates based on the current state of the orderbook and may differ from the actual execution price.
  • The quote does not reserve liquidity or lock funds.
  • For market orders, the estimated price is the volume-weighted average price across the available orderbook depth.

​
Rate Limits

  • 100 requests per minute per API key

​
Next Steps

Place Order

Place the order after reviewing the quote

Get Orderbook

View the full orderbook depth