Create a new liquidation address for a customer

Create a new liquidation address for a customer. Liquidation addresses allow customers to automatically liquidate cryptocurrency holdings to fiat or other stablecoins based on configured parameters.

Required fields:

• chain: Blockchain network (ethereum, polygon, arbitrum, base)
• currency: Stablecoin currency (usdc, eurc, dai, pyusd, usdt)
• address: Valid blockchain address

At least one destination must be specified:

• external_account_id: External bank account
• prefunded_account_id: Developer’s prefunded account
• bridge_wallet_id: Bridge wallet
• destination_address: Crypto wallet address

Payment Rails: Different payment rails have different requirements:

• ACH: Requires external_account_id, supports destination_ach_reference
• SEPA: Requires external_account_id, supports destination_sepa_reference
• Wire: Requires external_account_id, supports destination_wire_message
• Crypto: Requires destination_address, supports destination_blockchain_memo

POST /api/v0/customers/{customerId}/liquidation_addresses

Create a new liquidation address for a customer

cURL

curl --request POST \
  --url https://api.devdraft.ai/api/v0/customers/{customerId}/liquidation_addresses \
  --header 'Content-Type: application/json' \
  --data '
{
  "chain": "ethereum",
  "currency": "usdc",
  "address": "0x4d0280da2f2fDA5103914bCc5aad114743152A9c",
  "external_account_id": "ext_123",
  "prefunded_account_id": "pf_acc_123",
  "bridge_wallet_id": "bw_123",
  "destination_payment_rail": "sepa",
  "destination_currency": "eur",
  "destination_wire_message": "Liquidation payment for customer",
  "destination_sepa_reference": "SEPA-REF-123456",
  "destination_ach_reference": "ACH123",
  "destination_address": "0x1234567890abcdef1234567890abcdef12345678",
  "destination_blockchain_memo": "liquidation-memo-123",
  "return_address": "0xabcdefabcdefabcdefabcdefabcdefabcdef",
  "custom_developer_fee_percent": "2.5"
}
'

201

{
  "id": "la_generated_id_123",
  "state": "active",
  "customer_id": "cust_123",
  "chain": "ethereum",
  "currency": "usdc",
  "address": "0x4d0280da2f2fDA5103914bCc5aad114743152A9c",
  "created_at": "<string>",
  "updated_at": "<string>",
  "external_account_id": "<string>",
  "prefunded_account_id": "<string>",
  "bridge_wallet_id": "<string>",
  "destination_payment_rail": "<string>",
  "destination_currency": "<string>",
  "custom_developer_fee_percent": "<string>"
}

Path Parameters

customerId · string · required

Unique identifier for the customer

Example:

"cust_123"

Body

application/json

chain · enum<string> · required

The blockchain chain for the liquidation address

Available options: ethereum, solana, polygon, avalanche_c_chain, base, arbitrum, optimism, stellar, tron

Example:

"ethereum"

currency · enum<string> · required

The currency for the liquidation address

Available options: usdc, eurc, dai, pyusd, usdt

Example:

"usdc"

address · string · required

The liquidation address on the blockchain

Example:

"0x4d0280da2f2fDA5103914bCc5aad114743152A9c"

external_account_id · string

External bank account to send funds to

Maximum string length: 42

Example:

"ext_123"

prefunded_account_id · string

Developer's prefunded account id

Maximum string length: 42

Example:

"pf_acc_123"

bridge_wallet_id · string

Bridge Wallet to send funds to

Maximum string length: 42

Example:

"bw_123"

destination_payment_rail · enum<string> · default: ach

Payment rail for sending funds

Available options: ethereum, solana, polygon, avalanche_c_chain, base, arbitrum, optimism, stellar, tron, bridge_wallet, wire, ach, ach_push, ach_same_day, sepa, swift, spei

Example:

"sepa"

destination_currency · enum<string> · default: usd

Currency for sending funds

Available options: usd, eur, mxn, usdc, eurc, dai, pyusd, usdt

Example:

"eur"

destination_wire_message · string

Message for wire transfers

Maximum string length: 256

Example:

"Liquidation payment for customer"

destination_sepa_reference · string

Reference for SEPA transactions

Required string length: 6 - 140

Example:

"SEPA-REF-123456"

destination_ach_reference · string

Reference for ACH transactions

Maximum string length: 10

Example:

"ACH123"

destination_address · string

Crypto wallet address for crypto transfers

Example:

"0x1234567890abcdef1234567890abcdef12345678"

destination_blockchain_memo · string

Memo for blockchain transactions

Example:

"liquidation-memo-123"

return_address · string

Address to return funds on failed transactions (Not supported on Stellar)

Example:

"0xabcdefabcdefabcdefabcdefabcdefabcdef"

custom_developer_fee_percent · string

Custom developer fee percentage (Base 100 percentage: 10.2% = "10.2")

Example:

"2.5"

Response

201

application/json

Liquidation address created successfully

id · string · required

Unique identifier for the liquidation address

Example:

"la_generated_id_123"

state · string · required

Current state of the liquidation address

Example:

"active"

customer_id · string · required

Customer ID this liquidation address belongs to

Example:

"cust_123"

chain · string · required

Blockchain chain

Example:

"ethereum"

currency · string · required

Currency

Example:

"usdc"

address · string · required

Liquidation address

Example:

"0x4d0280da2f2fDA5103914bCc5aad114743152A9c"

created_at · string · required

Creation timestamp

updated_at · string · required

Last update timestamp

external_account_id · string

External account ID

prefunded_account_id · string

Prefunded account ID

bridge_wallet_id · string

Bridge wallet ID

destination_payment_rail · string

Destination payment rail

destination_currency · string

Destination currency

custom_developer_fee_percent · string

Custom developer fee percent