Skip to main content

quotation.error

Fired when Bluvo is unable to generate a withdrawal quote, typically due to validation failures or exchange-side errors.

When this event is sent

  • The requested amount is below the exchange’s minimum withdrawal threshold
  • The exchange rejects the quote request (insufficient funds, asset not supported, etc.)
  • An unexpected error occurs during the quoting process

Payload

Example payload
{
  "event": "quotation.error",
  "eventId": "wal_abc123-quotation-error-1713700800000",
  "timestamp": "2026-04-21T12:00:00.000Z",
  "data": {
    "error": {
      "code": "QUOTE_BELOW_MINIMUM",
      "message": "Amount is below the minimum withdrawal threshold"
    },
    "quotation": {
      "walletId": "wal_abc123",
      "asset": "BTC",
      "amount": "0.000001",
      "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
      "network": "Bitcoin"
    }
  }
}

Fields

FieldTypeDescription
data.error.codestringStandardized error code (e.g., QUOTE_BELOW_MINIMUM, QUOTE_EXCHANGE_ERROR)
data.error.messagestringHuman-readable error description
data.quotation.walletIdstringWallet the quote was requested for
data.quotation.assetstringAsset ticker
data.quotation.amountstringRequested withdrawal amount
data.quotation.addressstringRequested destination address
data.quotation.networkstring | undefinedRequested network
Error codes are standardized across the Bluvo platform. See the error handling guide for the full list.