v1

latestOpenAPI 3.0.02026-07-24103118224.7 KB

Swap

Get the in-progress swap

Returns the merchant's currently in-progress swap (status is INITIATED, PENDING, or PROCESSING on the wire — internal states are collapsed) along with a 1-indexed step / totalSteps projection, or null if none is in progress.

get/api/swap/in-progress

Response

In-progress swap snapshot, or null

idstring required

fromCurrency'USDC' | 'EURC' required

toCurrency'USDC' | 'EURC' required

amountInCentsnumber required

Source amount in cents

context'bridge' | 'privy' nullable

stepnumber required

Current step (1-indexed) within the pipeline.

totalStepsnumber required

Total steps in the pipeline (2 for Privy, 3 for Bridge).

createdAtstring date-time required

updatedAtstring date-time required

Example response

{
  "id": "swap_01JABCDEF0123456789XYZ",
  "fromCurrency": "USDC",
  "toCurrency": "EURC",
  "amountInCents": 12345,
  "step": 2,
  "totalSteps": 2
}