LpCallbackService

LP-implemented endpoint t-0 calls to bind the LP to a standing quote’s locked rate for one authorized sale. Fiat mode only.

Method NameRequest TypeResponse TypeDescription
ExecuteQuoteExecuteQuoteRequestExecuteQuoteResponseCreates the LP’s firm per-sale obligation at the standing quote’s locked rate.

LpService

t-0 endpoints the LP calls to push and withdraw standing quotes and to report its self-initiated fiat settlements. Fiat mode only.

Method NameRequest TypeResponse TypeDescription
PublishQuotePublishQuoteRequestPublishQuoteResponsePushes one immutable standing quote into t-0’s Order Book; multi-consumable while it stands.
WithdrawQuoteWithdrawQuoteRequestWithdrawQuoteResponseRemoves one standing quote before expiry; intents already accepted against it are unaffected.
FiatSettlementSentFiatSettlementSentRequestFiatSettlementSentResponseReports a fiat bank-rails settlement the LP made on its own initiative against locked executions.

Requests And Response Types

ExecuteQuoteRequest

FieldTypeLabelDescription
execution_iduint64t-0’s id for this execution; idempotency key and the LP’s obligation handle.
quote_iduint64t-0’s id for the standing quote this execution is under.
quote_refstringLP’s own identifier for that quote, echoed so the LP can attribute the execution.
acquirer_iduint64t-0’s stable id for the Acquirer; the LP resolves the registered bank destination from it.
local_currencystringISO 4217 currency to deliver (e.g. COP).
local_amounttzero.v1.common.DecimalFiat amount owed to the Acquirer for this sale.
fx_ratetzero.v1.common.DecimalStanding quote’s rate, locked for this sale at intent acceptance.
amount_usdttzero.v1.common.DecimalUSDt the LP receives at settlement for this sale.
executed_atgoogle.protobuf.Timestamp

ExecuteQuoteResponse

This message has no fields defined.

FiatSettlementSentRequest

FieldTypeLabelDescription
bank_transfer_refstringReference on the bank-rails transfer; idempotency key, unique per LP.
settled_execution_idsuint64repeatedExecutions this settlement clears, in the LP’s execution-space.
local_currencystringISO 4217 currency delivered; matches the covered executions’ currency.
settlement_amounttzero.v1.common.DecimalLocal-fiat amount delivered; must equal the sum of the covered executions’ local amounts.
destination_accountstringAcquirer’s registered bank destination the fiat was sent to.
settled_atgoogle.protobuf.Timestamp

FiatSettlementSentResponse

FieldTypeLabelDescription
acceptedFiatSettlementSentResponse.Accepted
rejectedFiatSettlementSentResponse.Rejected

FiatSettlementSentResponse.Accepted

This message has no fields defined.

FiatSettlementSentResponse.Rejected

FieldTypeLabelDescription
reasonFiatSettlementSentResponse.Rejected.Reason
failing_execution_idsuint64repeatedExecutions that failed validation against t-0’s ledger.

PublishQuoteRequest

FieldTypeLabelDescription
quote_refstringLP’s identifier for this quote; idempotency key, unique per LP.
local_currencystringISO 4217 currency the quote prices (e.g. COP).
fx_ratetzero.v1.common.DecimalRate committed, in units of local_currency per 1 USDt.
min_amount_usdttzero.v1.common.DecimalSmallest single sale this quote may price, in USDt (domain rule: at least 0.01).
max_amount_usdttzero.v1.common.DecimalLargest single sale this quote may price, in USDt (domain rule: at least min_amount_usdt).
expires_atgoogle.protobuf.TimestampMoment the quote stops standing, on t-0’s clock.

PublishQuoteResponse

FieldTypeLabelDescription
successPublishQuoteResponse.Success
failurePublishQuoteResponse.Failure

PublishQuoteResponse.Failure

FieldTypeLabelDescription
reasonPublishQuoteResponse.Failure.Reason

PublishQuoteResponse.Success

FieldTypeLabelDescription
quote_iduint64t-0’s id for the standing quote, used everywhere downstream.

WithdrawQuoteRequest

FieldTypeLabelDescription
quote_iduint64The standing quote to withdraw; must have been minted for this LP.

WithdrawQuoteResponse

FieldTypeLabelDescription
successWithdrawQuoteResponse.Success
failureWithdrawQuoteResponse.Failure

WithdrawQuoteResponse.Failure

FieldTypeLabelDescription
reasonWithdrawQuoteResponse.Failure.Reason

WithdrawQuoteResponse.Success

This message has no fields defined.

FiatSettlementSentResponse.Rejected.Reason

NameNumberDescription
REASON_UNSPECIFIED0
REASON_EXECUTION_UNKNOWN10A listed execution was never created for this LP.
REASON_EXECUTION_ALREADY_COVERED20A listed execution is already covered by an accepted settlement.
REASON_CURRENCY_MISMATCH30local_currency does not match the covered executions’ currency.
REASON_AMOUNT_MISMATCH40settlement_amount does not equal the covered executions’ sum.
REASON_DESTINATION_MISMATCH50destination_account is not the Acquirer’s registered bank destination.
REASON_ACQUIRER_MIXED60The covered executions span more than one Acquirer (one transfer credits one account).

PublishQuoteResponse.Failure.Reason

NameNumberDescription
REASON_UNSPECIFIED0
REASON_CURRENCY_UNSUPPORTED10The quote’s currency is not supported.
REASON_LIMITS_INVALID20min/max bounds are not well-formed.
REASON_VALIDITY_INVALID30expires_at is in the past, too short to be usable, or beyond the max window.

WithdrawQuoteResponse.Failure.Reason

NameNumberDescription
REASON_UNSPECIFIED0
REASON_QUOTE_UNKNOWN10quote_id is unknown or belongs to another LP.