Convert merchant balances

Conversion quotes lock the rate and commission for 60 seconds. Execution updates both balances and ledger entries atomically.

GEThttps://lirpay.org/api/v2/integration/conversion-pairs

List currently available source and destination currency pairs.

API key requiredconversions:read

POSThttps://lirpay.org/api/v2/integration/conversion-quotes

Lock a conversion rate, commission, and destination amount.

API key requiredconversions:readIdempotency-Key required

Parameter	Type	In	Required	Description
Idempotency-Key	string	header	yes	Unique key for this monetary operation. Maximum 255 characters.
from_currency	string	body	yes	Source balance currency.
to_currency	string	body	yes	Destination balance currency.
source_amount_minor	integer	body	yes	Positive source amount in minor units.

{
  "from_currency": "USDT",
  "to_currency": "BTC",
  "source_amount_minor": 50000
}

POSThttps://lirpay.org/api/v2/integration/conversions

Execute an unexpired conversion quote.

API key requiredconversions:writeIdempotency-Key required

Parameter	Type	In	Required	Description
Idempotency-Key	string	header	yes	Unique key for this monetary operation. Maximum 255 characters.
quote_id	uuid	body	yes	Quote returned by POST /conversion-quotes.
external_id	string	body	no	Unique merchant-side conversion reference.

GEThttps://lirpay.org/api/v2/integration/conversions

List completed conversions in the current environment.

API key requiredconversions:read

Parameter	Type	In	Required	Description
from_currency	string	query	no	Filter by source currency.
to_currency	string	query	no	Filter by destination currency.
status	string	query	no	Filter by conversion status.
created_from	RFC3339	query	no	Include records created at or after this timestamp.
created_to	RFC3339	query	no	Include records created at or before this timestamp.
page	integer	query	no	Page number. Defaults to 1.
limit	integer	query	no	Items per page. Maximum 100.

GEThttps://lirpay.org/api/v2/integration/conversions/{id}

Read the rate, commission, source amount, and destination amount.

API key requiredconversions:read

Parameter	Type	In	Required	Description
id	uuid	path	yes	Resource identifier returned by a list or create operation.