Skip to main content
POST
Create liquidation address

Authorizations

Authorization
string
header
required

Partner API key in the form Authorization: Bearer fn_....

Headers

X-Idempotency-Key
string
required
Minimum string length: 1

Body

application/json

Unknown top-level fields are ignored rather than rejected.

destinationChain
enum<string>
required
Available options:
arbitrum,
avalanche,
base,
bitcoin,
bsc,
ethereum,
hedera,
hypercore,
hyperevm,
lightning,
litecoin,
monad,
monero,
optimism,
plasma,
polygon,
robinhood,
sei,
solana,
spark,
tempo,
ton,
tron,
xrp,
zcash
destinationAddress
string
required

Server canonicalizes by trimming leading/trailing whitespace; case is preserved.

Minimum string length: 1
label
string
Maximum string length: 255
Pattern: ^[^\x00-\x1F\x7F]*$
destinationAsset
string
Minimum string length: 1
slippageBps
integer
Required range: 0 <= x <= 10000
feeBps
integer
Required range: 0 <= x <= 9999
appFees
object[]
Required array length: 1 - 16 elements
affiliateIds
(string | object)[]

Registered affiliate IDs or fee overrides for each deposit; mutually exclusive with appFees, with overrides requiring a server key or dashboard session.

Required array length: 1 - 16 elements

Registered affiliate ID or { affiliateId, feeBps } override.

Minimum string length: 1

Response

Created

liquidationAddressId
string
required
label
string
required
sparkAddress
string
required
l1DepositAddress
string
required
destination
object
required
feeBps
integer
required
slippageBps
integer
required
enabled
boolean
required
createdAt
string
required
updatedAt
string
disabledAt
string | null
appFees
object[]