POST
/
api
/
v0
/
customers
/
{customerId}
/
liquidation_addresses
Create a new liquidation address for a customer
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"
}'
{
  "id": "la_generated_id_123",
  "state": "active",
  "customer_id": "cust_123",
  "chain": "ethereum",
  "currency": "usdc",
  "address": "0x4d0280da2f2fDA5103914bCc5aad114743152A9c",
  "external_account_id": "<string>",
  "prefunded_account_id": "<string>",
  "bridge_wallet_id": "<string>",
  "destination_payment_rail": "<string>",
  "destination_currency": "<string>",
  "custom_developer_fee_percent": "<string>",
  "created_at": "<string>",
  "updated_at": "<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 length: 42
Example:

"ext_123"

​
prefunded_account_id
string

Developer's prefunded account id

Maximum length: 42
Example:

"pf_acc_123"

​
bridge_wallet_id
string

Bridge Wallet to send funds to

Maximum length: 42
Example:

"bw_123"

​
destination_payment_rail
enum<string>
default:ach

Payment rail for sending funds The blockchain network where the source currency resides. Determines gas fees and transaction speed.

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 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 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

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