Skip to main content
POST
Create Pool Buy Transaction

Headers

X-Api-Key
string
required

Your API key (configured in credentials)

X-Signature
string
required

HMAC-SHA256 signature (auto-generated) To test manually: HMAC-SHA256 of apiKey + timestamp (or apiKey + timestamp + userId when X-User-Id is required), keyed with your API secret. The HMAC Generator flow computes this for you.

X-Timestamp
string
required

Unix timestamp in seconds (auto-generated) Unix seconds, e.g. Math.floor(Date.now() / 1000). Must match the timestamp used in the X-Signature computation.

X-Request-Id
string
required

Unique request identifier (auto-generated) Any unique string per request, e.g. a UUID.

X-User-Id
string
required

User UUID (set above)

Body

application/json
payment_method
string
required

Deposit payment method. Ignored when quote_id is provided (taken from the quote).

from_currency
string
required

Fiat or source currency. Ignored when quote_id is provided (taken from the quote).

to_currency
string
required

Crypto or destination currency. Ignored when quote_id is provided (taken from the quote).

from_amount
number
required

Source amount. Must be greater than zero. Ignored when quote_id is provided (taken from the quote).

quote_id
string

Optional UUID of a price-locked quote from the Pool Buy Quote endpoint. When provided, the price-lock flow is enabled: from_currency, to_currency, payment_method, from_amount, and to_amount are taken from the quote and any values sent for them are ignored. The quote must be unexpired, unused, belong to the calling client, and match this transaction type.

to_amount
number

Optional destination amount. Ignored when quote_id is provided (taken from the quote).

uuid
string

Optional client reference UUID.

source_id
string

Optional source instrument id.

bank_transaction_id
string

Optional provider reference.

verification_code
string

Payment verification code when applicable.

cvv
string

Card CVV when applicable.

store_for_future_use
boolean

Save payment method for future use.

Response

Successful response

success
boolean
data
object