Notus API
Fiat

Create Fiat Quote v2

This endpoint creates a fiat quote for both deposit and withdrawal operations.

POST
/api/v2/fiat/quote
x-api-key<token>

In: header

fromobject
toobject
chainIdnumber

Chain where the token will be sent from.

  • Polygon: 137
  • Arbitrum One: 42161
  • Base: 8453
  • Ethereum: 1
entityIdstring

The KYC entity ID. This is the individualId for individuals or businessId for businesses, as returned by the KYC verification endpoints.

fees?object
walletAddressstring

Wallet address. Required for validating the wallet and accurate gas estimation.

Match^0x[a-fA-F0-9]*$

Response Body

curl -X POST "https://api.notuslabs.xyz/api/v2/fiat/quote" \  -H "Content-Type: application/json" \  -d '{    "from": {      "currency": "BRL"    },    "to": {      "currency": "BRZ"    },    "chainId": 0,    "entityId": "12345678-1234-1234-1234-123456789012",    "walletAddress": "string"  }'
{
  "from": {
    "currency": "USDC",
    "amount": "100.50"
  },
  "to": {
    "currency": "BRL",
    "amount": "550.75"
  },
  "quoteId": "123e4567-e89b-12d3-a456-426614174000",
  "chain": {
    "id": 137,
    "name": "POLYGON",
    "logo": "https://logopolygon.com"
  },
  "type": "DEPOSIT",
  "expiresAt": "2024-01-01T12:00:00.000Z"
}
{
  "statusCode": 400,
  "id": "CRYPTO_TOKEN_NOT_SUPPORTED_ON_CHAIN_WITH_ALTERNATIVES",
  "message": "The token 'undefined' is not supported on any fiat chains"
}
{
  "statusCode": 404,
  "id": "ACCOUNT_ABSTRACTION_ADDRESS_NOT_REGISTERED_WITH_PROJECT",
  "message": "The requested wallet \"undefined\" is not registered with the project"
}
{
  "statusCode": 500,
  "id": "FAILED_TO_GET_FIAT_QUOTE",
  "message": "string"
}