Skip to main content
POST
Create a quote for currency/token conversion

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:
transfer-between-same-entity-accounts
Example:

"transfer-between-same-entity-accounts"

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:

"67995"

trade-reason
enum<string>

SISBACEN classification for the FX trade

Available options:
transfer-between-same-entity-accounts
Example:

"transfer-between-same-entity-accounts"