Skip to main content
POST
/
api
/
v1
/
accounts
/
{account-id}
/
quotes
Create a quote for currency/token conversion
curl --request POST \
  --url https://app.crown-brlv.com/api/v1/accounts/{account-id}/quotes \
  --header 'Content-Type: application/json' \
  --data '
{
  "source-asset": "fiat/brl",
  "target-asset": "eth-base/usdc",
  "source-amount": "100.50",
  "target-amount": "500.25",
  "trade-reason": "international-travels"
}
'
{
  "expires-at": "2024-01-15T10:30:00Z",
  "target-asset": "eth-base/usdc",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "source-asset": "fiat/brl",
  "source-amount": "1000.00",
  "created-at": "2024-01-15T10:30:00Z",
  "pricing": {
    "base-rate": {
      "amount": "5.1307200000",
      "base": "USDC",
      "quote": "BRL"
    },
    "spread": {
      "amount": "7.95",
      "asset": "fiat/brl",
      "bps": 80
    },
    "fee": {
      "amount": "2.00",
      "asset": "fiat/brl",
      "kind": "fixed"
    },
    "iof": {
      "amount": "0.00",
      "asset": "fiat/brl",
      "applicable": false,
      "basis-ref": "psav-res-521-2025"
    }
  },
  "target-amount": "194.914826",
  "vet": {
    "amount": "5.1307200000",
    "base": "USDC",
    "quote": "BRL"
  },
  "trade-reason-code": "46992",
  "trade-reason": "purchase-or-sale-of-other-services"
}

Path Parameters

​
account-id
string<uuid>
required

Body

application/json
​
source-asset
enum<string>
required

The asset to convert from (e.g., 'fiat/brl', 'eth-base/brlv', 'eth-base/usdc')

Available options:
tempo/brlv,
eth-base/brlv,
eth-mainnet/brlv,
fiat/brl,
eth-base/usdt,
fiat/usd,
eth-mainnet/usdt,
eth-mainnet/usdc,
eth-base/wbrly,
eth-base/usdc,
eth-base/brly
Example:

"fiat/brl"

​
target-asset
enum<string>
required

The asset to convert to (e.g., 'fiat/brl', 'eth-base/brlv', 'eth-base/usdc')

Available options:
tempo/brlv,
eth-base/brlv,
eth-mainnet/brlv,
fiat/brl,
eth-base/usdt,
fiat/usd,
eth-mainnet/usdt,
eth-mainnet/usdc,
eth-base/wbrly,
eth-base/usdc,
eth-base/brly
Example:

"eth-base/usdc"

​
source-amount

Amount of source asset to convert (provide either source-amount OR target-amount, not both)

Example:

"100.50"

​
target-amount

Desired amount of target asset to receive (provide either source-amount OR target-amount, not both)

Example:

"500.25"

​
trade-reason
enum<string> | null

SISBACEN classification for the FX trade. Required when converting between BRL and a non-BRL-pegged asset (e.g., BRL <-> USDC). Ignored for same-currency conversions such as BRL <-> BRLV.

Available options:
purchase-or-sale-of-merchandise,
purchase-or-sale-of-other-services,
transfer-between-same-entity-accounts,
offshore-loans-principal,
offshore-loans-interest,
other-transactions,
donation-without-counter-payment,
purchase-or-sale-of-business-services,
purchase-or-sale-of-computing-services,
international-travels
Example:

"international-travels"

Response

Quote created successfully

​
expires-at
string<date-time>
required

ISO 8601 timestamp when the quote expires (millisecond precision)

Example:

"2024-01-15T10:30:00Z"

​
target-asset
enum<string>
required

The asset being converted to

Available options:
tempo/brlv,
eth-base/brlv,
eth-mainnet/brlv,
fiat/brl,
eth-base/usdt,
fiat/usd,
eth-mainnet/usdt,
eth-mainnet/usdc,
eth-base/wbrly,
eth-base/usdc,
eth-base/brly
Example:

"eth-base/usdc"

​
id
string<uuid>
required

Unique identifier for the quote

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
source-asset
enum<string>
required

The asset being converted from

Available options:
tempo/brlv,
eth-base/brlv,
eth-mainnet/brlv,
fiat/brl,
eth-base/usdt,
fiat/usd,
eth-mainnet/usdt,
eth-mainnet/usdc,
eth-base/wbrly,
eth-base/usdc,
eth-base/brly
Example:

"fiat/brl"

​
source-amount
string<decimal>
required

Amount of source asset to be converted. BRL → 2 dp; USDC/USDT → 6 dp. Always FLOOR-truncated.

Example:

"1000.00"

​
created-at
string<date-time>
required

ISO 8601 timestamp when the quote was created (millisecond precision)

Example:

"2024-01-15T10:30:00Z"

​
pricing
object
required

Pricing breakdown: base rate, spread, service fee, IOF

​
target-amount
string<decimal>
required

Amount of target asset to be received. BRL → 2 dp; USDC/USDT → 6 dp. Always FLOOR-truncated.

Example:

"194.914826"

​
vet
object
required

Valor Efetivo Total — the all-in rate including spread, fee, and IOF

​
trade-reason-code
string

Regulatory code for the trade reason

Example:

"46992"

​
trade-reason
enum<string>

SISBACEN classification for the FX trade

Available options:
purchase-or-sale-of-merchandise,
purchase-or-sale-of-other-services,
transfer-between-same-entity-accounts,
offshore-loans-principal,
offshore-loans-interest,
other-transactions,
donation-without-counter-payment,
purchase-or-sale-of-business-services,
purchase-or-sale-of-computing-services,
international-travels
Example:

"purchase-or-sale-of-other-services"