Operations Overview

Operations in Avenia allow you to seamlessly convert between fiat currencies and cryptocurrencies, as well as perform cross-chain swaps. The system is designed around two main concepts: quotes and tickets.

Quick Start

1. Get a Quote

First, request a price calculation for your desired transaction:

curl "https://api.sandbox.avenia.io:10952/v2/account/quote/fixed-rate?inputCurrency=BRL&inputPaymentMethod=PIX&inputAmount=100&outputCurrency=BRLA&outputPaymentMethod=POLYGON"

Response includes:

• quoteToken - Use this to create the ticket
• outputAmount - Final amount you'll receive
• appliedFees - Breakdown of all fees

2. Create a Ticket

Execute the transaction using the quote token:

POST /v2/account/tickets/
{
  "quoteToken": "eyJ...",
  "ticketBlockchainOutput": {
    "beneficiaryWalletId": "your-wallet-id"
  }
}

3. Complete Transaction

• PIX: Pay the returned brCode
• WIRE/ACH: Follow deposit instructions
• Blockchain: Sign transaction or transfer tokens

Supported Operations

From	To	Description
BRL (PIX)	BRLA, USDC, USDT, EURC, ARSA	Convert Brazilian Real to crypto
USD (WIRE/ACH)	USDC, USDT	Convert USD to stablecoins
EUR (SEPA)	EURC	Convert Euro to digital euro
ARS (BANK-TRANSFER)	ARSA, BRLA, USDC, USDT, EURC	Convert Argentine Peso to crypto
Crypto	Fiat	Withdraw to bank account
Crypto	Crypto	Cross-chain swaps between blockchains

Key Features

Real-time Quotes

• 15-second validity - Act fast or request new quote
• Live pricing - Always current market rates
• Fee transparency - See all costs upfront

Flexible Execution

• Multiple methods - Choose PERMIT or TRANSFER for blockchain
• Bank integration - Direct PIX, WIRE, ACH, SEPA support
• ️ Cross-chain - Swap between different blockchains

Complete Monitoring

• Webhook events - Real-time status updates
• Transaction history - Full audit trail
• Status tracking - Monitor every step

Next Steps

1. Quotes and Tickets - Learn the core concepts and API
2. Available Combinations - See all supported operations

Need Help?

• Check the API Reference for detailed parameters
• See error codes for troubleshooting
• Contact support for specific integration questions