Skip to main content

Authorizations

X-API-Key
string
header
required

Your Swipelux API key. Obtain this from the Swipelux Dashboard.

Headers

Idempotency-Key
string
required

Required for effectful v3 requests (POST, PATCH, PUT, DELETE). Reuse the same key with the same body to replay the cached response.

Required string length: 1 - 255

Body

application/json

Provide exactly one of in.amount or out.amount. Stablecoin moves are same-network, same-currency transfers; cross-chain bridging and asset swaps are not supported.

customerId
string
required
Pattern: ^cus_[a-zA-Z0-9]+$
Example:

"cus_7F3pL2nQ9xA5mW8kR1sT4v"

capabilityId
string
required

Ready capability used to price this quote. Open enum — values are added over time; clients must tolerate unknown values.

Minimum string length: 1
Example:

"ach_pooled"

in
object
required
destinationId
string
required

Movement output. The public ID prefix determines the resource kind: acc_ identifies an account and dst_ identifies a recipient destination. For stablecoin_transfers, use any active Swipelux stablecoin account or a ready wallet destination owned by the request customer. A wallet destination can contain any address valid for its declared network; create it through the recipient-destination API because raw inline addresses are not accepted. Stablecoin source and destination must use the same network and currency. Destination-owner data is never exposed.

Pattern: ^(?:acc|dst)_[a-zA-Z0-9]+$
Example:

"acc_base123"

out
object
required
externalId
string

Optional merchant-supplied opaque reference of at most 255 characters. Echoed on the quote resource and not required to be unique.

Required string length: 1 - 255
Example:

"quote-ref-123"

fees
object

Optional quote-level developer fee override. Overrides account fees for this quote only. A stablecoin_transfers wallet move currently accepts zero fees only: any non-zero platform or developer fee is rejected with 422 amount_not_deliverable until direct crypto fee settlement is supported.

Response

Quote created

data
object
required