Skip to main content
POST
/
payout
/
accounts
/
setup
/
liquidation-address
Step 1: Create a liquidation address for a beneficiary
curl --request POST \
  --url http://localhost:4000/v1/payout/accounts/setup/liquidation-address \
  --header 'Content-Type: application/json' \
  --data '
{
  "beneficiary_id": "b5ed595d-d724-4826-9e6c-3b8104fbe355",
  "chain": "base",
  "currency": "usdc",
  "destination_currency": "mxn",
  "destination_payment_rail": "spei"
}
'

Body

application/json
​
beneficiary_id
string
required

UUID of the beneficiary to link this liquidation address to

Example:

"b5ed595d-d724-4826-9e6c-3b8104fbe355"

​
chain
enum<string>
required

Blockchain chain for the liquidation address

Available options:
base,
polygon,
ethereum,
solana,
arbitrum,
avalanche_c_chain
Example:

"base"

​
currency
enum<string>
default:usdc
required

Currency for the liquidation address

Available options:
usdc,
usdt
Example:

"usdc"

​
destination_currency
enum<string>

Fiat destination currency (auto-detected from bank account if omitted)

Available options:
usd,
mxn,
eur,
brl,
gbp
Example:

"mxn"

​
destination_payment_rail
enum<string>

Fiat destination payment rail (auto-detected from bank account if omitted)

Available options:
ach,
spei,
sepa,
pix,
fps
Example:

"spei"

Response

Liquidation address created or already exists