Skip to main content
POST
/
api
/
v0
/
quotes
Create a quote for currency/token conversion
curl --request POST \
  --url https://api.brl.xyz/api/v0/quotes \
  --header 'Content-Type: application/json' \
  --data '
{
  "source-asset": "fiat/brl",
  "target-asset": "eth-base/brlv",
  "source-amount": "100.50",
  "target-amount": "500.25"
}
'
{
  "quote": {
    "updated-at": "2024-01-15T10:30:00Z",
    "expires-at": "2024-01-15T10:30:00Z",
    "base-rate": "1.0000",
    "effective-rate": "0.9950",
    "target-asset": "eth-base/brlv",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "source-asset": "fiat/brl",
    "source-amount": "100.50",
    "created-at": "2024-01-15T10:30:00Z",
    "target-amount": "99.75"
  }
}

Body

application/json
source-asset
enum<string>
required

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

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

"fiat/brl"

target-asset
enum<string>
required

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

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

"eth-base/brlv"

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"

Response

Quote created successfully

quote
object
required