v1

latestOpenAPI 3.0.32026-07-26184851.6 MB

Deposit Fiat

Master Wallet Get Quote

post/v1/wallets/{id}/deposit/fiat/quote

Path parameters

idstring uuid required

Wallet identifier.

Request body

assetIdstring uuid required

Stablecoin asset identifier returned by the supported-assets endpoint.

currencystring required

ISO 4217 fiat currency code.

amountstring required

Decimal amount encoded as a string to preserve precision.

rail'one_time_virtual_account' | 'payment_link' | 'qr_code' required

Supported fiat collection rail.

providerstring

Optional provider slug. Omit it to let Blockradar select an eligible provider.

Example request

{
  "assetId": "ae455f23-3824-4125-baab-d158315cbcbd",
  "currency": "NGN",
  "amount": "100.00",
  "provider": "example-provider"
}

Response

Successful response.

statusCodeinteger required

messagestring required

Human-readable result.

Example response

{
  "statusCode": 200,
  "message": "Deposit quote fetched successfully",
  "data": {
    "amount": "100.00",
    "amountFiat": "155000.00",
    "feeFiat": "1500.00",
    "amountFiatPayable": "156500.00",
    "rate": "1550.00",
    "unlocked": true,
    "additionalDataRequirements": {
      "schema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object"
      }
    }
  }
}