Balance Conversions

Convert between digital assets and fiat currencies within your WickiePay account using multi-venue liquidity.

How Conversions Work

WickiePay routes conversions through 40+ liquidity venues to find the best available rate.

Source Currency  →  Trading Engine  →  Destination Currency
(e.g., USDC)       (best rate)        (e.g., EUR)

Create a Conversion

POST /api/v1/conversion
Content-Type: application/json

{
  "assetPoolId": "your-pool-id",
  "fromCurrency": "USDC",
  "toCurrency": "EUR",
  "amount": 10000.00,
  "side": "SELL"
}

Estimate Before Converting

Get an indicative rate before committing:

POST /api/v1/conversion/estimate

{
  "fromCurrency": "USDC",
  "toCurrency": "EUR",
  "amount": 10000.00
}

Response:

{
  "fromCurrency": "USDC",
  "toCurrency": "EUR",
  "amount": 10000.00,
  "estimatedAmount": 9216.00,
  "rate": 0.9216,
  "validUntil": "2026-01-15T10:25:30Z"
}

Conversion Statuses

Status	Description
PENDING	Conversion created, awaiting execution
PROCESSING	Being executed across liquidity venues
COMPLETE	Conversion settled, funds available
CANCELLED	Conversion cancelled before execution
FAILED	Execution failed (insufficient liquidity, etc.)

List Conversions

GET /api/v1/conversion?assetPoolId=your-pool-id&limit=50

Cancel a Conversion

Only pending conversions can be cancelled:

POST /api/v1/conversion/{uuid}/cancel

Next Steps

• Rates & Market Data — Real-time exchange rates
• Asset Pools — Manage balances